File Formats, Data Descriptions, MIBs, and System Processes Reference
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.
TA_DMACCESSPOINT(r)(k)(*) |
||||
TA_DMTYPE(k) |
||||
TA_STATE(r) |
||||
(r)—required when a new object is created |
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.
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.
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.
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.
Modify an existing object. This combination is not allowed in the |
|
TA_DMPRIORITY_TYPE =
"
{LOCAL_RELATIVE
| LOCAL_ABSOLUTE
| GLOBAL
}"
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.
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.
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.
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
.
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.
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.
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
.