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

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

T_DM_REMOTE Class Definition

Overview

The T_DM_REMOTE class represents remote domain access point configuration information. Local resources that may be exported through one or more local domain access points are made accessible to a remote domain through a remote domain access point. Similarly, remote resources are imported from a remote domain through a remote domain access point.

Attribute Table

Table 21 DM_MIB(5): T_DM_REMOTE Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMACCESSPOINT(r)(k)(*)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMACCESSPOINTID(r)	string	`rw-r--r--`	`string`[1..30]	N/A
TA_DMTYPE(k)	string	`rw-r--r--`	`"`{`TDOMAIN` \| `SNAX` \| `OSITP` \| `OSITPX`}`"`	`"TDOMAIN"`
TA_STATE(r)	string	`rw-r--r--`	`GET`: `"VAL"` `SET`: `"`{`NEW` \| `INV`}`"`	N/A N/A
TA_DMPRIORITY_TYPE	string	`rw-r--r--`	`"`{`LOCAL_RELATIVE` \| `LOCAL_ABSOLUTE` \| `GLOBAL`}`"`	`"LOCAL_ RELATIVE"`
TA_DMINPRIORITY	string	`rw-r--r--`	-99 <= num <= 100	0 or 50
Attributes available when `TA_DMTYPE=TDOMAIN\|OSITPX`:
TA_DMACLPOLICY	string	`rwxr--r--`	`"`{`LOCAL` \| `GLOBAL`}`"`	`"LOCAL"`
TA_DMLOCALPRINCIPALNAME	string	`rwxr--r--`	`string`[0..511]	`""`
Attributes available when `TA_DMTYPE=TDOMAIN`:
TA_DMCONNPRINCIPALNAME	string	`rwxr--r--`	`string`[0..511]	`""`
TA_DMCREDENTIALPOLICY	string	`rwxr--r--`	`"`{`LOCAL` \| `GLOBAL`}`"`	`"LOCAL"`
TA_DMMACHINETYPE	string	`rw-r--r--`	`string`[0..15]	`""`
Attributes available when `TA_DMTYPE=SNAX\|OSITPX`:
TA_DMCODEPAGE	string	`rw-r--r--`	`string`[1..20]	N/A
(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 name of this T_DM_REMOTE entry—a user-specified remote domain access point identifier (logical name) unique within the scope of the T_DM_LOCAL and T_DM_REMOTE access point names in this Domains configuration.

TA_DMACCESSPOINTID: string[1..30]

The identifier for the remote domain associated with this remote domain access point for purposes of security when setting up a connection to the remote domain. This identifier is unique across all local and remote domain access points.

TA_DMTYPE: "{TDOMAIN | SNAX | OSITP | OSITPX}"

The type of domain for this remote domain access point: "TDOMAIN" for a BEA Tuxedo domain, "SNAX" for an SNA domain, "OSITP" for an OSI TP 1.3 domain, or "OSITPX" for an OSI TP 4.0 or later domain. The presence or absence of other attributes depends on the value of this attribute.

Setting TA_DMTYPE="OSITPX" is supported only by BEA Tuxedo 8.0 or later software.

TA_STATE:

GET: "{VALid}"

A GET operation retrieves configuration information for the T_DM_REMOTE 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_REMOTE 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.
`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.

TA_DMPRIORITY_TYPE = "{LOCAL_RELATIVE | LOCAL_ABSOLUTE | GLOBAL}"

TA_DMINPRIORITY = -99 <= num <= 100

Together, the TA_DMPRIORITY_TYPE and TA_DMINPRIORITY attributes specify the message priority handling for this remote domain access point. These attributes are supported by BEA Tuxedo 8.0 or later software.

For the TA_DMPRIORITY_TYPE attribute, the "LOCAL_RELATIVE" and "LOCAL_ABSOLUTE" values are valid for all remote domain types; the "GLOBAL" value is valid only for remote domains of type TDOMAIN. If not set, the TA_DMPRIORITY_TYPE attribute defaults to "LOCAL_RELATIVE".

TA_DMPRIORITY_TYPE="LOCAL_RELATIVE" means that the priority associated with a request from this remote domain access point (for example, via the tpsprio call) is not used by the local domain. Instead, the priority of incoming requests from this remote domain access point is set relative to the TA_DMINPRIORITY value; this value may be greater than or equal to -99 (lowest priority) and less than or equal to 99 (highest priority), with 0 being the default. The setting of TA_DMINPRIORITY increments or decrements a service's default priority as follows: up to a maximum of 100 or down to a minimum of 1, depending on its sign, where 100 is the highest priority. For requests to the remote domain access point, the priority associated with a request will accompany the request to the remote domain access point.

TA_DMPRIORITY_TYPE="LOCAL_ABSOLUTE" means that the priority associated with a request from this remote domain access point is not used by the local domain. Instead, the priority of incoming requests from this remote domain access point is set relative to the TA_DMINPRIORITY value; this value may be greater than or equal to 1 (lowest priority) and less than or equal to 100 (highest priority), with 50 being the default. The setting of TA_DMINPRIORITY increments or decrements a service's default priority as follows: up to a maximum of 100 or down to a minimum of 1, depending on its sign, where 100 is the highest priority. For requests to the remote domain access point, the priority associated with a request will accompany the request to the remote domain access point.

TA_DMPRIORITY_TYPE="GLOBAL" means that the priority associated with a request from this remote domain access point is adjusted by the local domain. The priority of incoming requests from this remote domain access point is adjusted relative to the TA_DMINPRIORITY value; this value may be greater than or equal to -99 (lowest priority) and less than or equal to 99 (highest priority), with 0 being the default. If TA_DMINPRIORITY is set, the priority accompanying the incoming request is added to the TA_DMINPRIORITY value to create an absolute priority setting for the incoming request. If TA_DMINPRIORITY is not set or is set to 0, the priority accompanying the incoming request is used as is by the local domain. For requests to the remote domain access point, the priority associated with a request will accompany the request to the remote domain access point.

Attributes available when TA_DMTYPE=TDOMAIN|OSITPX

TA_DMACLPOLICY: {LOCAL | GLOBAL}

The access control list (ACL) policy for this remote domain access point. This attribute applies only to domain gateways of type TDOMAIN running BEA Tuxedo 7.1 or later software and domain gateways of type OSITPX running BEA Tuxedo 8.0 or later software.

LOCAL means that the local domain replaces the credential (identity) of any service request received from the remote domain with the principal name specified in the TA_DMLOCALPRINCIPALNAME attribute for this remote domain access point. GLOBAL means that the local domain does not replace the credential received with a remote service request; if no credential is received with a remote service request, the local domain forwards the service request to the local service as is (which usually fails). If this attribute is not specified, the default is LOCAL.

Note that the TA_DMACLPOLICY attribute controls whether or not the local domain replaces the credential of a service request received from a remote domain with the principal name specified in the TA_DMLOCALPRINCIPALNAME attribute. The TA_DMCREDENTIALPOLICY attribute is related to this attribute and controls whether or not the local domain removes the credential from a local service request before sending the request to a remote domain.

TA_DMLOCALPRINCIPALNAME: string[0..511]

The local principal name identifier (credential) assigned by the local domain to service requests received from the remote domain when the TA_DMACLPOLICY attribute for this remote domain access point is set (or defaulted) to LOCAL. This attribute applies only to domain gateways of type TDOMAIN running BEA Tuxedo 7.1 or later software and domain gateways of type OSITPX running BEA Tuxedo 8.0 or later software.

The TA_DMLOCALPRINCIPALNAME attribute may contain a maximum of 511 characters (excluding the terminating NULL character). If this attribute is not specified, the local principal name defaults to the TA_DMACCESSPOINTID string for this remote domain access point.

Attributes available when TA_DMTYPE=TDOMAIN

TA_DMCONNPRINCIPALNAME: string[0..511]

The connection principal name identifier, which is the principal name used for verifying the identity of this remote domain access point when establishing a connection to the local domain access point. This attribute applies only to domain gateways of type TDOMAIN running BEA Tuxedo 7.1 or later software.

The TA_DMCONNPRINCIPALNAME attribute may contain a maximum of 511 characters (excluding the terminating NULL character). If this attribute is not specified, the connection principal name defaults to the TA_DMACCESSPOINTID string for this remote domain access point.

For default authentication plug-ins, if a value is assigned to the TA_DMCONNPRINCIPALNAME attribute for this remote domain access point, it must be the same as the value assigned to the TA_DMACCESSPOINTID attribute for this remote domain access point. If these values do not match, any attempt to set up a connection between the local domain gateway and the remote domain gateway will fail, and the system will generate the following userlog(3c) message: ERROR: Unable to initialize administration key for domain domain_name.

TA_DMCREDENTIALPOLICY: {LOCAL | GLOBAL}

The credential policy for this remote domain access point. This attribute applies only to domain gateways of type TDOMAIN running BEA Tuxedo 8.0 or later software.

LOCAL means that the local domain removes the credential (identity) from a local service request destined for this remote domain access point. GLOBAL means that the local domain does not remove the credential from a local service request destined for this remote domain access point. If this attribute is not specified, the default is LOCAL.

Note that the TA_DMCREDENTIALPOLICY attribute controls whether or not the local domain removes the credential from a local service request before sending the request to a remote domain. The TA_DMACLPOLICY attribute controls whether or not the local domain replaces the credential of a service request received from a remote domain with the principal name specified in the TA_DMLOCALPRINCIPALNAME attribute.

TA_DMMACHINETYPE: string[0..15]

Used for grouping domains so that encoding/decoding of messages can be bypassed between the machine associated with this remote domain access point and the machine associated with the local domain access point. If TA_DMMACHINETYPE is not specified, the default is to turn encoding/decoding on. If the value set for the TA_DMMACHINETYPE attribute is the same in both the T_DM_LOCAL and T_DM_REMOTE classes for a connection, data encoding/decoding is bypassed. The value set for TA_DMMACHINETYPE can be any string value up to 15 characters in length. It is used only for comparison.

Attributes available when TA_DMTYPE=SNAX|OSITPX

TA_DMCODEPAGE: string[1..20]

The name of the default translation tables to use in translating requests and replies sent through this remote domain access point.

Limitations

When any gateway administrative server (GWADM) supporting a local domain access point of the same domain type as this request is active, you cannot SET the TA_STATE to INValid or update the following attributes: TA_DMACCESSPOINTID, TA_DMTYPE, TA_DMMACHINETYPE, or TA_DMCODEPAGE.

You cannot delete an instance of the T_DM_REMOTE class if it is referenced by any instances of the following classes: T_DM_ACL, T_DM_IMPORT, T_DM_OSITP, T_DM_OSITPX, T_DM_ROUTING, or T_DM_TDOMAIN.