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

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

T_DM_OSITP Class Definition

Overview

The T_DM_OSITP class defines the OSI TP 1.3 protocol related configuration information for a specific local or remote domain access point.

Attribute Table

Table 17 DM_MIB(5): T_DM_OSITP Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMAPT(r)	string	rw-r--r--	string[1..78]	N/A
TA_DMAEQ(r)	string	rw-r--r--	string[1..78]	N/A
TA_DMNWDEVICE	string	rw-r--r--	string[1..78]	N/A
TA_DMACN	string	rw-r--r--	"{XATMI \| UDT}"	"XATMI"
TA_DMAPID	short	rw-r--r--	0 <= num <= 32767	N/A
TA_DMAEID	short	rw-r--r--	0 <= num <= 32767	N/A
TA_DMURCH	string	rw-r--r--	string[0..30]	N/A
TA_DMMAXLISTENINGEP	short	rw-r--r--	1 <= num <= 32767	3
TA_DMXATMIENCODING	string	rw-r--r--	"{CAE \| PRELIMINARY \| OLTP_TM2200}"	"CAE"
(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_DMACCESSPOINT: string[1..30]

The local or remote domain access point name for which this entry provides the protocol-specific configuration information. This field matches the domain access point name given in the T_DM_LOCAL or T_DM_REMOTE entry that defines the protocol independent configuration of the domain access point.

TA_STATE:

GET: "{VALid}"

A GET operation retrieves configuration information for the T_DM_OSITP object. The following state indicates 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 configuration information for the selected T_DM_OSITP 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. This state change is allowed in the state "INValid" and results in the state "VALid".
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. This state change is allowed in the state "VALid" and results in the state "INValid".

TA_DMAPT: string[1..78]

The application process title of this local or remote domain access point in object identifier form.

TA_DMAEQ: string[1..78]

The application entity qualifier of this local or remote domain access point in integer form.

TA_DMNWDEVICE: string[1..78]

Specifies the network device to be used for this local domain access point. This attribute is relevant only when defining a local domain access point; it is ignored for a remote domain access point.

TA_DMACN: "{XATMI | UDT}"

The application context name to use with this local or remote domain access point. When establishing a dialogue to a remote domain access point, the application context name from the remote domain access point is used, if it is present. If it is absent, the application context name from the local domain access point is used. The value "XATMI" selects the use of the X/Open defined XATMI Application Service Element (ASE) and encoding. The value "UDT" selects the use of the ISO/IEC 10026-5 User Data Transfer encoding.

TA_DMAPID: 0 <= num <= 32767

This optional attribute defines the application process invocation identifier to be used on this local or remote domain access point.

TA_DMAEID: 0 <= num <= 32767

This optional attribute defines the application entity invocation identifier to be used on this local or remote domain access point.

TA_DMURCH: string[0..30]

Specifies the user portion of the OSI TP recovery context handle for this local domain access point. It may be required by an OSI TP provider in order to perform recovery of distributed transactions after a communications line or system failure.

This attribute is relevant only when defining a local domain access point; it is ignored for a remote domain access point.

TA_DMMAXLISTENINGEP: 0 <= num <= 32767

Specifies the number of endpoints awaiting incoming OSI TP dialogues for this local domain access point. This attribute is relevant only when defining a local domain access point; it is ignored for a remote domain access point.

TA_DMXATMIENCODING: "{CAE | PRELIMINARY | OLTP_TM2200}"

Specifies the version of the XATMI protocol used to communicate with a remote system. This attribute is valid only when describing a remote domain access point. Valid values are:

"CAE" (default)

"PRELIMINARY" (used with Unisys MCP OLTP systems)

"OLTP_TM2200" (used with Unisys TM 2200 systems)

Limitations

Deleting or updating an instance of this class is not permitted in the following scenarios:

The instance of the class corresponds to a local domain access point and the domain gateway group associated with the local domain access point is active.
The instance of the class corresponds to a remote domain access point and the domain gateway group associated with the remote domain access point is active.

On SET operations that add or update an instance of this class, the specific local or remote domain access point specified in the TA_DMACCESSPOINT attribute must exist in the T_DM_LOCAL class or the T_DM_REMOTE class. If the domain access point does not exist, a "not defined" error is returned for the TA_DMACCESSPOINT attribute, and the operation fails.