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

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

T_DM_OSITPX Class Definition

Overview

The T_DM_OSITPX class defines the OSI TP 4.0 or later protocol related configuration information for a specific local or remote domain access point. The T_DM_OSITPX class is supported only by BEA Tuxedo 8.0 or later software.

Attribute Table

Table 18 DM_MIB(5): T_DM_OSITPX 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_DMAET(r)	string	`rw-r--r--`	`string`[1..78]	N/A
TA_DMNWADDR(r)	string	`rw-r--r--`	`string`[1..631]	N/A
TA_DMTSEL	string	`rw-r--r--`	`string`[1..66]	N/A
TA_DMDNSRESOLUTION	string	`rw-r--r--`	`"`{`STARTUP` \| `RUNTIME`}`"`	`"STARTUP"`
TA_DMPSEL	short	`rw-r--r--`	`string`[1..10]	`""`
TA_DMSSEL	short	`rw-r--r--`	`string`[1..34]	`""`
TA_DMTAILORPATH	short	`rw-r--r--`	`string`[1..78]	`""`
TA_DMXATMIENCODING	string	`rw-r--r--`	`"`{`CAE` \| `PRELIMINARY` \| `OLTP_TM2200` \| `NATIVE_A_SERIES`}`"`	`"CAE"`
TA_DMEXTENSIONS	short	`rw-r--r--`	`string`[1..78]	`""`
TA_DMOPTIONS	short	`rw-r--r--`	`"`{`SECURITY_SUPPORTED`}`"`	`""`
(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_OSITPX 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_OSITPX object. The following states indicate the meaning of TA_STATE in a SET request. States not listed may not be set.

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

TA_DMAET: string[1..78]

The application entity title of this local or remote domain access point. This address must be unique among all hosts communicating in the OSI TP network; it matches the local AE Title on the remote (OLTP) node.

The value of this attribute consists of the application process title as an object identifier form followed by the application entity qualifier as an integer, using the following form: "{object identifier},{integer qualifier}". The braces are part of the syntax and must be included within the quotes.

TA_DMNWADDR: string[1..631]

The semicolon-separated list of network addresses to use for this local or remote domain access point. A network address may be either an IP address, if using TCP/IP networks, or a DNS name. The network address takes one of the following forms:

"#.#.#.#:port_number" IP Address
"//hostname:port_number" DNS Name
"//hostname:port_number;//hostname:port_number; ..."

If the port_number component is absent, the default port 102 is used.

For a local domain access point, the value of this attribute contains a semicolon-separated list of up to eight addresses on which to listen for connection requests. For a remote domain access point, the value of this attribute contains the preferred address for the destination domain followed by up to seven alternative addresses (in preference order) to be tried if the first is unavailable.

TA_DMTSEL: string[1..66]

The Transport Service Access Point address to be used for this local or remote domain access point. The value may be one to 32 ASCII non-control characters (those represented by the hexadecimal numbers 20 to 7E), one to 32 hexadecimal octets preceded by 0x, or "NONE"—the NULL string.

TA_DMDNRESOLUTION: "{STARTUP | RUNTIME}"

Specifies when the DNS name for the network address defined by the TA_DMNWADDR attribute should be resolved for the domain gateway (GWOSITP) associated with this local domain access point. If this attribute is set (or defaulted) to "STARTUP", the resolution of hostname to an actual IP address takes place at gateway startup. If this attribute is set to "RUNTIME", the resolution of hostname to an actual IP address takes place at gateway run time.

This attribute is relevant only when defining a local domain access point; it is ignored for a remote domain access point. On GET calls for remote domain access point instances, this attribute is set to the NULL string.

TA_DMPSEL: string[1..10]

The Presentation Service Access Point address to be used for this local or remote domain access point. Values may be one to four ASCII non-control characters (those represented by the hexadecimal numbers 20 to 7E), one to four hexadecimal octets preceded by 0x, or "NONE" (default).

TA_DMSSEL: string[1..34]

The Session Service Access Point address to be used for this local or remote domain access point. Values may be one to 16 ASCII non-control characters (those represented by the hexadecimal numbers 20 to 7E), one to 16 hexadecimal octets preceded by 0x, or "NONE" (default).

TA_DMTAILORPATH: string[1..78]

Indicates the full pathname of the optional OSI TP tailor file used for tuning the OSI TP stack for this local domain access point. Double quotes are required. If no value is supplied or the value is set to the NULL string, the OSI TP stack will run using defaults for tuning parameters.

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 | NATIVE_A_SERIES}"

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)

"NATIVE_A_SERIES" (used with Unisys MCP OLTP systems that support
this encoding type)

TA_DMEXTENSIONS: string[1..78]

Controls operations for the remote domain associated with this remote domain access point. Valid values are separated by a semicolon (;) and include "ONLINE=N/Y" (Y is the default) and "RdomAssocRetry=nn", where nn is the number of seconds to retry connecting to the online remote domain. This attribute defaults to the RdomAssocRetry tailor parameter if present, or 60 seconds if RdomAssocRetry is not present and nn is not specified.

TA_DMOPTIONS: "{SECURITY_SUPPORTED}"

Indicates optional parameters for this remote domain access point. The "SECURITY_SUPPORTED" value indicates that the remote domain associated with this remote domain access point supports the OSITP security extension. This attribute provides backward compatibility; it is valid only when describing a remote domain access point.

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.