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

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

T_DM_CONNECTION Class Definition

Overview

The T_DM_CONNECTION class represents the status of connections between domain access points.

Attribute Table

Table 13 DM_MIB(5): T_DM_CONNECTION Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMLACCESSPOINT(k)(*)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMRACCESSPOINT(k)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMTYPE	string	`r--r--r--`	`"`{`TDOMAIN` }`"`	N/A
TA_STATE(k)(*)	string	`rwxr-xr--`	`GET`: `"`{`ACT` \| `SUS` \| `INI` \| `INA` \| `UNK`}`"` `SET`: `"`{`ACT` \| `INA`}`"`	N/A N/A
Attributes available when `TA_DMTYPE=TDOMAIN:`
TA_DMCURENCRYPTBITS	string	`r--------`	`"`{`0` \| `40` \| `56` \| `128`}`"`^Note1	`"0"`
(k)—a key field for object retrieval (*)—a required key field for all `SET` operations on the class

^{Note 1}The link-level encryption value of 40 bits is provided for backward compatibility.

Attribute Semantics

TA_DMLACCESSPOINT: string[1..30]

The name of the local domain access point identifying the connection between the domains.

On GET and SET operations, a specific local domain access point must be specified for this attribute.

TA_DMRACCESSPOINT: string[1..30]

The name of the remote domain access point identifying the connection between the domains.

On GET and SET operations, if TA_DMRACCESSPOINT is absent, all the T_DM_CONNECTION entries for the local access point specified by TA_DMLACCESSPOINT are selected.

TA_DMTYPE: "{TDOMAIN }"

The type of domain, which can be "TDOMAIN".

TA_STATE:

GET: "{ACTive | SUSpended | INItializing | INActive | UNKnown}"

A GET operation retrieves run-time information for the connection. 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.

`"ACTive"`	The connection is active.
`"SUSpended"`	The connection is awaiting retry.
`"INItializing"`	The connection is initializing.
`"INActive"`	The specified domain access points are disconnected. (This state is only returned by gateways running BEA Tuxedo release 7.1 or later.)
`"UNKnown"`	The connection state of the specified domain access points cannot be determined.

SET: "{ACTive | INActive}"

A SET operation updates run-time information for the connection. The following states indicate the meaning of a TA_STATE in a SET request. States not listed may not be set.

`"ACTive"`	Connect the specified domain access points. If the current state is `"SUSpended"` or `"INActive"`, `SET:"ACTive"` places the connection into the state `"INItializing"`, otherwise there is no change.
`"INActive"`	Disconnect the specified domain access points and destroy the object.

Attributes available when TA_DMTYPE=TDOMAIN

TA_DMCURENCRYPTBITS: "{0 | 40 | 56 | 128}"

The level of encryption in use on this connection. "0" means no encryption, while "40", "56", and "128" specify the encryption length (in bits). This attribute is valid only for gateways running BEA Tuxedo release 7.1 or higher. For all other gateways, this value is set to "0".

Note: The link-level encryption value of 40 bits is provided for backward compatibility.

Limitations

The Domain gateway administration (GWADM) server and the domain gateway supporting the local domain access point specified in the TA_DMLACCESSPOINT attribute must be active in order to perform GET or SET operations on connections to that access point.