Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

Tuxedo

e-docs > Tuxedo > File Formats, Data Descriptions, MIBs, and System Processes Reference > Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

File Formats, Data Descriptions, MIBs, and System Processes Reference

Previous

Next

Contents

View as PDF

T_DM_IMPORT Class Definition

Overview

The T_DM_IMPORT class represents remote resources that are imported through one or more remote domain access points and made available to the local domain through one or more local domain access points.

Attribute Table

Table 15 DM_MIB(5): T_DM_IMPORT Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMRESOURCENAME(r)(k)(*)	string	rw-r--r--	string[1..15]
TA_DMRACCESSPOINTLIST(k)(*)	string	rw-r--r--	string[1..92]	* (meaning all)
TA_DMLACCESSPOINT(k)(*)	string	rw-r--r--	string[1..30]	* (meaning all)
TA_STATE(r)	string	rwxr-xr--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMCONV	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMLOAD	short	rw-r--r--	1 <= num <= 32,767	50
TA_DMREMOTENAME	string	rw-r--r--	string[1..30]	N/A
TA_DMRESOURCETYPE	string	rw-r--r--	"{SERVICE \| QSPACE \| QNAME}"	"SERVICE"
TA_DMROUTINGNAME	string	rw-r--r--	string[1..15]	N/A
Attributes available from remote domain access points of TA_DMTYPE=TOPEND:
TA_DMTE_PRODUCT	string	rw-r--r--	string[1..32]
TA_DMTE_FUNCTION	string	rw-r--r--	string[1..8]
TA_DMTE_TARGET	string	rw-r--r--	string[1..8]	Spaces
TA_DMTE_QUALIFIER	long	rw-r--r--	0 <= num <= MAXLONG	0 (Zero)
TA_DMTE_RTQGROUP	string	rw-r--r--	string[1..32]
TA_DMTE_RTQNAME	string	rw-r--r--	string[1..8]
Attributes available from remote domain access points of TA_DMTYPE=TOPEND\|SNAX\|OSITP\|OSITPX:
TA_DMINBUFTYPE	string	rw-r--r--	string[0..256]	N/A
TA_DMOUTBUFTYPE	string	rw-r--r--	string[0..256]	N/A
Attributes available from remote domain access points of TA_DMTYPE=OSITPX:
TA_DMAUTOPREPARE(r)	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMINRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMOUTRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMTPSUTTYPE(r)	string	rw-r--r--	"{INTEGER \| PRINTABLESTRING}"	""
TA_DMREMTPSUT(r)	string	rw-r--r--	string[0..64]	""
(r)—required when a new object is created (k)—a key field for object retrieval (*)—a required key field for all SET operations on the class

Attribute Semantics

TA_DMRESOURCENAME: string[1..15]

The remote resource name used for entries of resource type SERVICE (the service name), QSPACE (the queue space name), and QNAME (the queue name). This resource is imported from remote domains with the same name or with the alias defined in the TA_DMREMOTENAME or TA_DMTE* attributes.

TA_DMRACCESSPOINTLIST: string[1..92]

Identifies the remote domain access point through which this remote resource should be imported. TA_DMRACCESSPOINTLIST is a comma-separated failover domain list; it can contain up to three remote domain access points of up to 30 characters each. If this attribute is set to "*", the resource can be imported from all remote domain access points.

TA_DMLACCESSPOINT: string[1..30]

The name of the local domain access point through which this remote resource should be made available. If this attribute is set to "*", the resource is made available through all local domain access points.

GET: "{VALid}"

A GET operation retrieves configuration information for the T_DM_IMPORT object. The following states indicate the meaning of a TA_STATE attribute value returned in response to a GET request. States not listed are not returned.

"VALid"

The object exists.

SET: "{NEW | INValid}"

A SET operation updates the configuration information for the selected T_DM_IMPORT object. The following states indicate the meaning of TA_STATE in a SET request. States not listed may not be set.

"NEW"	A new object is created. A state change is allowed in the state "INValid" and results in the state "ACTive".
unset	Modify an existing object. This combination is not allowed in the "INValid" state. A successful return leaves the object state unchanged.
"INValid"	The object is deleted. A state change is allowed in the state "ACTive" and results in the state "INValid".

TA_DMCONV: "{Y | N}"

A boolean value ("Y" or "N") specifying whether this remote resource is conversational. When access is permitted from TOPEND remote domain access points, this attribute must be set to "N" if TA_DMRESOURCETYPE="QSPACE" or "QNAME".

TA_DMLOAD: 1 <= num <= 32,767

The service load for this remote resource. Interface loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request.

TA_DMREMOTENAME: string[1..30]

Specifies the name of this remote resource imported through the remote domain access points. If this attribute is not specified, the name of the remote resource defaults to the name specified in TA_DMRESOURCENAME. The TA_DMREMOTENAME attribute does not apply to domain gateways of type TOPEND.

TA_DMRESOURCETYPE: "{SERVICE | QSPACE | QNAME}"

Specifies whether this remote resource is a "SERVICE", "QSPACE", or "QNAME". The default is "SERVICE". This attribute applies only to domain gateways of type TOPEND, meaning that for all other domain gateways types a remote resource is always a "SERVICE".

TA_DMROUTINGNAME: string[1..15]

The name of a T_DM_ROUTING object to use for routing criteria for this remote resource ("SERVICE" or "QSPACE").

Attributes available from remote domain access points of TA_DMTYPE=TOPEND

TA_DMTE_PRODUCT: string[1..32]

The BEA TOP END product name for this remote resource. This attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". It is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_FUNCTION: string[1..8]

The BEA TOP END function name for this remote resource. This attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". It is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_TARGET: string[1..8]

The BEA TOP END Message Sensitive Routing (MSR) target for this remote resource. This optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE", "QSPACE", or "QNAME".

TA_DMTE_QUALIFIER: 0 <= num <= MAXLONG

The BEA TOP END function qualifier for this remote resource. This optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". It is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_RTQGROUP: string[1..32]

The BEA TOP END Recoverable Transaction Queuing (RTQ) queue group name for this remote resource. This attribute must be specified if TA_DMRESOURCETYPE="QSPACE". It is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

TA_DMTE_RTQNAME: string[1..8]

The BEA TOP END RTQ queue name for this remote resource. This attribute must be specified if TA_DMRESOURCETYPE="QSPACE". It is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

Attributes available from remote domain access points of TA_DMTYPE=TOPEND|SNAX|OSITP|OSITPX

TA_DMINBUFTYPE: string[0..256]

type[:subtype]—Specifies the input buffer type, optionally followed by subtype, for this remote resource. If this attribute is present, it defines the buffer type [and subtype] accepted. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME"; this attribute is not permitted if TA_DMRESOURCETYPE="QSPACE". This attribute should be defined for entries of DMRESOURCETYPE="SERVICE" when using SNAX, or when access is permitted to remote domain access points using OSITP or OSITPX with the UDT application context.

For BEA TOP END service and queue name entries, the valid values for type are FML32, CARRAY, and X_OCTET.

TA_DMOUTBUFTYPE: string[0..256]

type[:subtype]—Specifies the output buffer type, optionally followed by subtype, for this remote resource. If this attribute is present, it defines the buffer type [and subtype] output by the service. When access is permitted from TOPEND remote domain access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE"; this attribute is not permitted if TA_DMRESOURCETYPE="QSPACE" or "QNAME". This attribute should be defined for entries of DMTYPE="SERVICE" when using SNAX, or when access is permitted to remote domain access points using OSITP or OSITPX with the UDT application context.

For BEA TOP END service and queue name entries, the valid values for type are FML32, CARRAY, and X_OCTET.

Attributes available from remote domain access points of TA_DMTYPE=OSITPX

TA_DMAUTOPREPARE: string"{Y | N}"

Allows a single tpcall() involved in a global transaction to this remote service to automatically prepare the call. This optimization reduces the two-phase commit process to a single step. The remote OSITP domain must support this feature. The default is "N".

TA_DMINRECTYPE: string[1..78]

type[:subtype]—Specifies the type, optionally followed by subtype, and in some case the format of the request buffer that this remote service requires. This attribute can be omitted if the local client sends a buffer that is identical in type and structure to the buffer that this remote service expects. If you do not specify TA_DMINRECTYPE, the type of buffer is unchanged.

TA_DMOUTRECTYPE: string[1..78]

type[:subtype]—Specifies the type, optionally followed by subtype, of the buffer sent by this remote service. This attribute is used to enforce stronger type checking.

TA_DMTPSUTTYPE: string"{INTEGER | PRINTABLESTRING}"

Specifies the type of encoding to be performed on the TA_DMREMTPSUT value for this remote service. "INTEGER" and "PRINTABLESTRING" are ASN.1 types. The default is "PRINTABLESTRING".

TA_DMREMTPSUT: string[1..64]

Identifies the TP service user title for the remote system providing this remote service. Some users of OSI TP implementations require this attribute. It is not required for OS 2200 OLTP-TM2200, OpenTI, A Series Open/OLTP, or BEA eLink OSI TP. If the TA_DMTPSUTTYPE value is "PRINTABLESTRING", the maximum length is 60 characters, which must comply with the ASN.1 type of PRINTABLESTRING. If the TA_DMTPSUTTYPE value is "INTEGER", the maximum length must fit into a LONG. The value must be defined prior to defining the remote TPSUT.

Limitations

None.

Back to Top

Previous

Next