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

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

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_DMBLOCKTIME	long	`rwyr--r--`	0 <= `num` <= 32,767	0
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=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 ten 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.

TA_STATE:

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_DMBLOCKTIME: 0 <= num <= 32,767

Blocktime limit, in seconds, indicating the minimum amount of time a blocking API call will delay before timing out for a particular service. This attribute lets the client know that (after a specified time in seconds), no reply has been received by the server while the service request is still processing.

If not specified, the default is 0 which indicates that the system-wide BLOCKTIME value specified in the UBBCONFIG RESOURCES section is used for the service.

TA_DMCONV: "{Y | N}"

A boolean value ("Y" or "N") specifying whether this remote resource is conversational.

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.

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=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. 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.

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. 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.

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.