DM_MIB(5)

A GET operation retrieves configuration information for the T_DM_ACL 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 is defined and inactive. This is the only valid state for this class. ACL groups are never active.

A SET operation updates configuration information for the selected T_DM_ACL object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

"NEW"	A new object is created. A state change is allowed only when in the "INValid" state. A successful return leaves the object in the "VALid" state.
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. A state change is allowed only when in the "VALid" state. A successful return leaves the object in the "INValid" state.

Limitations

None.

T_DM_CONNECTION Class Definition

Overview

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

Attribute Table

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 \| TOPEND}"	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

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.

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

The type of domain, which can be either "TDOMAIN" or "TOPEND".

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.

T_DM_EXPORT Class Definition

Overview

The T_DM_EXPORT class represents local resources that are exported to one or more remote domains through a local access point.

Attribute Table

DM_MIB(5): T_DM_EXPORT Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMRESOURCENAME(r)(k)(*)	string	rw-r--r--	string[1..15]	N/A
TA_DMLACCESSPOINT(k)(*)	string	rw-r--r--	string[1..30]	* (meaning all)
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMACLNAME	string	rw-r--r--	string[1..15]	N/A
TA_DMCONV	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMRESOURCETYPE	string	rw-r--r--	"{SERVICE \| QSPACE \| QNAME}"	"SERVICE"
TA_DMREMOTENAME	string	rw-r--r--	string[1..30]	N/A
Attributes available from remote access points of TA_DMTYPE=SNAX\|OSITPX\|TOPEND:
TA_DMINBUFTYPE	string	rw-r--r--	string[0..513]	N/A
TA_DMOUTBUFTYPE	string	rw-r--r--	string[0..513]	N/A
Attributes available from remote access points of TA_DMTYPE=OSITPX:
TA_DMCOUPLING(r)	string	rw-r--r--	"{TIGHT\|LOOSE}"	"LOOSE"
TA_DMINRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMOUTRECTYPE(r)	string	rw-r--r--	string[0..78]	""
Attributes available from remote access points of TA_DMTYPE=TOPEND:
TA_DMTE_PRODUCT	string	rw-r--r--	string[1..32]
TA_DMTE_FUNCTION	string	rw-r--r--	string[1..8]
TA_DMTE_TARGET	string	rw-r--r--	string[1..8]	Spaces
TA_DMTE_QUALIFIER	long	rw-r--r--	0 <= num <= MAXLONG	0 (Zero)
TA_DMTE_RTQGROUP	string	rw-r--r--	string[1..32]
TA_DMTE_RTQNAME	string	rw-r--r--	string[1..8]
(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_DMRESOURCENAME: string[1..15]

The local resource name for entries of resource type SERVICE (the service name), QSPACE (the queue space name), and QNAME (the queue name). For a SERVICE entry, the value of this attribute corresponds to the value of the TA_SERVICENAME attribute of an active T_SVCGRP object. This resource is exported to other domains with the same name or with the alias defined in the TA_DMREMOTENAME or TA_DMTE* attributes.

The local access point name. Setting this attribute to "*" means the resource is available at all local access points.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_EXPORT object. The following states indicate the meaning of a TA_STATE set 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_DMACLNAME: string[1..15]

The name of a T_DM_ACL object to use for security on this local service. When access is permitted from TOPEND remote access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QSPACE". This attribute is not permitted if TA_DMRESOURCETYPE="QNAME".

TA_DMCONV: "{Y | N}"

Specifies whether this local service is conversational or not. When access is permitted from TOPEND remote access points, this attribute must be set to "N" for entries of TA_DMRESOURCETYPE="QSPACE" or "QNAME".

TA_DMRESOURCETYPE: "{SERVICE | QSPACE | QNAME}"

Specifies whether this entry is for a "SERVICE", "QSPACE", or "QNAME". The default is "SERVICE".

TA_DMREMOTENAME: string[1..30]

For entries of type "SERVICE" or "QSPACE", this attribute specifies the name exported through non-TOPEND remote access points.

Attributes available from remote access points of TA_DMTYPE=SNAX|OSITPX|TOPEND

TA_DMINBUFTYPE: string[0..513]

type[:subtype]—input buffer type, optionally followed by subtype. If this attribute is present, it defines the buffer type [and subtype] accepted. This attribute should be defined for entries of TA_DMRESOURCETYPE="SERVICE" when access is permitted from remote access points using OSITPX with the UDT application context, or when using SNAX. When access is permitted from TOPEND remote access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

For BEA TOP END service and queue name entries, the valid values for type are: FML32, CARRAY, and X_OCTET.

TA_DMOUTBUFTYPE: string[0..513]

type[:subtype]— output buffer type, optionally followed by subtype. If this attribute is present, it defines the buffer type [and subtype] output by the service. This attribute should be defined for entries of TA_DMRESOURCETYPE="SERVICE" when access is permitted from remote access points using OSITPX with the UDT application context, or when using SNAX. When access is permitted from TOPEND remote access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE" or "QNAME".

For BEA TOP END service and queue name entries, the valid values for type are: FML32, CARRAY, and X_OCTET.

Attributes available from remote access points of TA_DMTYPE=OSITPX

TA_DMCOUPLING: string"{TIGHT|LOOSE}"

Optional. The valid value for this parameter can be either "TIGHT" or "LOOSE".

TA_DMINRECTYPE and TA_DMOUTRECTYPE: string[1..78]

Optional. The input to these parameters are the same as for TA_DMINBUFTYPE and TA_DMOUTBUFTYPE consisting of a type[:subtype] field.

Attributes available from remote access points of TA_DMTYPE=TOPEND

TA_DMTE_PRODUCT: string[1..32]

The BEA TOP END product name. When access is permitted from TOPEND remote access points, this attribute must be specified if TA_DMRESOURCETYPE="SERVICE" and "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_FUNCTION: string[1..8]

The BEA TOP END function name. When access is permitted from TOPEND remote access points, this attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_TARGET: string[1..8]

The BEA TOP END Message Sensitive Routing (MSR) target. This attribute is optional for entries of TA_DMRESOURCETYPE="SERVICE", "QSPACE", or "QNAME" when access is permitted from TOPEND remote access points.

TA_DMTE_QUALIFIER: 0 <= num <= MAXLONG

The BEA TOP END function qualifier. This attribute is optional for entries of TA_DMRESOURCETYPE="SERVICE" or "QNAME" when access is permitted from TOPEND remote access points. This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_RTQGROUP: string[1..32]

The BEA TOP END Recoverable Transaction Queuing (RTQ) queue group name. This attribute must be specified for TA_DMRESOURCETYPE="QSPACE" when access is permitted from TOPEND remote access points. This attribute is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

TA_DMTE_RTQNAME: string[1..8]

The BEA TOP END RTQ queue name. This attribute must be specified for TA_DMRESOURCETYPE="QSPACE" and access is permitted from TOPEND remote access points. This attribute is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

Limitations

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

T_DM_IMPORT Class Definition

Overview

The T_DM_IMPORT class represents remote resources that are imported through one or more remote domain access points and made available to the local domain through one or more local domain access points.

Attribute Table

DM_MIB(5): T_DM_IMPORT Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMRESOURCENAME(r)(k)(*)	string	rw-r--r--	string[1..15]
TA_DMLACCESSPOINT(k)(*)	string	rw-r--r--	string[1..30]	* (meaning all)
TA_DMRACCESSPOINTLIST(k)(*)	string	rw-r--r--	string[1..92]	* (meaning all)
TA_STATE(r)	string	rwxr-xr--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMAUTOTRAN	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMCONV	string	rw-r--r--	"{Y \| N}"	"N"
TA_DMLOAD	short	rw-r--r--	1 <= num <= 32,767	50
TA_DMPRIO	short	rw-r--r--	1 <= num <= 100	50
TA_DMRESOURCETYPE	string	rw-r--r--	"{SERVICE \| QSPACE \| QNAME}"	"SERVICE"
TA_DMREMOTENAME	string	rw-r--r--	string[1..30]	N/A
TA_DMROUTINGNAME	string	rw-r--r--	string[1..15]	N/A
TA_DMTRANTIME	long	rw-r--r--	0 <= num <= 32,767	30
Attributes available from remote access points of TA_DMTYPE=SNAX\|OSITPX\|TOPEND:
TA_DMINBUFTYPE	string	rw-r--r--	string[0..256]	N/A
TA_DMOUTBUFTYPE	string	rw-r--r--	string[0..256]	N/A
Attributes available from remote access points of TA_DMTYPE=OSITPX:
TA_DMAUTOPREPARE(r)	string	rw-r--r--	"{Y\|N}"	"N"
TA_DMINRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMOUTRECTYPE(r)	string	rw-r--r--	string[0..78]	""
TA_DMTPSUTTYPE(r)	string	rw-r--r--	"{INTEGER\|PRINTABLESTRING}"	""
TA_DMREMTPSUT(r)	string	rw-r--r--	string[0..64]	""
Attributes available from remote access points of TA_DMTYPE=TOPEND:
TA_DMTE_PRODUCT	string	rw-r--r--	string[1..32]
TA_DMTE_FUNCTION	string	rw-r--r--	string[1..8]
TA_DMTE_TARGET	string	rw-r--r--	string[1..8]	Spaces
TA_DMTE_QUALIFIER	long	rw-r--r--	0 <= num <= MAXLONG	0 (Zero)
TA_DMTE_RTQGROUP	string	rw-r--r--	string[1..32]
TA_DMTE_RTQNAME	string	rw-r--r--	string[1..8]
(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_DMRESOURCENAME: string[1..15]

The remote resource name used for entries of resource type SERVICE (the service name), QSPACE (the queue space name), and QNAME (the queue name). This resource is imported from remote domains with the same name or with the alias defined in the TA_DMREMOTENAME or TA_DMTE* attributes.

The name of the local domain access point through which this imported resource should be made available. If this attribute is set to "*", the resource is made available through all local domain access points.

TA_DMRACCESSPOINTLIST: string[1..92]

Identifies the remote domain access point through which this resource should be imported. TA_DMRACCESSPOINTLIST is a comma-separated failover domain list; it can contain up to three remote domain access points of up to 30 characters each. If this attribute is set to "*", the resource can be imported from all remote access points.

TA_STATE:

A GET operation retrieves configuration information for the T_DM_IMPORT object. 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.

"VALid"

The object exists.

A SET operation updates the configuration information for the selected T_DM_IMPORT 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. A state change is allowed in the state "INValid" and results in the state "ACTive".
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. A state change is allowed in the state "ACTive" and results in the state "INValid".

TA_DMAUTOTRAN: "{Y | N}"

When a request is received for a resource that is not already within a transaction, this attribute automatically starts a transaction for this resource. The default is "N".

TA_DMCONV: "{Y | N}"

A boolean value ("Y" or "N") specifying whether the service is conversational. When access is permitted from TOPEND remote access points, this attribute must be set to "N" for entries of TA_DMRESOURCETYPE="QSPACE" or "QNAME".

TA_DMLOAD: 1 <= num <= 32,767

The service load.

TA_DMPRIO: 1 <= num <= 100

The dequeuing priority. Service requests with a higher priority are serviced first.

TA_DMRESOURCETYPE: "{SERVICE | QSPACE | QNAME}"

Specifies whether this entry is for a "SERVICE", "QSPACE", or "QNAME". The default is "SERVICE".

TA_DMREMOTENAME: string[1..30]

For entries of type "SERVICE" or "QSPACE", this attribute specifies the name imported through non-TOPEND remote access points.

TA_DMROUTINGNAME: string[1..15]

The name of a T_DM_ROUTING object to use for routing criteria for this "SERVICE" or "QSPACE".

TA_DMTRANTIME: 1 <= num <= 32,767

Transaction time value, in seconds, for transactions automatically started for this "SERVICE" or "QSPACE". Transactions are started automatically when a request not in transaction mode is received and the TA_DMAUTOTRAN attribute is set to "Y".

Limitation: Run-time updates to this attribute are not reflected in active requests.

Attributes available from remote access points of TA_DMTYPE=SNAX|OSITPX|TOPEND

TA_DMINBUFTYPE: string[0..256]

type[:subtype]—input buffer type, optionally followed by subtype. If this attribute is present, it defines the buffer type [and subtype] accepted. This attribute should be defined for entries of DMRESOURCETYPE="SERVICE" when access is permitted to remote access points using OSITPX with the UDT application context, or when using OSITPX or SNAX. When access is permitted from TOPEND remote access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE".

For BEA TOP END service and queue name entries, the valid values for type are: FML32, CARRAY, and X_OCTET.

TA_DMOUTBUFTYPE: string[0..256]

type[:subtype]—output buffer type, optionally followed by subtype. If this attribute is present, it defines the buffer type [and subtype] output by the service. This attribute should be defined for entries of DMTYPE="SERVICE" when access is permitted to remote access points using OSITPX or SNAX. When access is permitted from TOPEND remote access points, this optional attribute may be specified if TA_DMRESOURCETYPE="SERVICE". This attribute is not permitted if TA_DMRESOURCETYPE="QSPACE" or "QNAME".

For BEA TOP END service and queue name entries, the valid values for type are: FML32, CARRAY, and X_OCTET.

Attributes available from remote access points of TA_DMTYPE=OSITPX

TA_DMAUTOPREPARE: string"{Y|N}"

Optional. The valid value for this parameter can be either "Y" or "N".

TA_DMINRECTYPE and TA_DMOUTRECTYPE: string[1..78]

Optional. The input to these parameters are the same as for TA_DMINBUFTYPE and TA_DMOUTBUFTYPE consisting of a type[:subtype] field.

TA_DMTPSUTTYPE: string"{INTEGER|PRINTABLESTRING"}

Optional. The input for this parameter can be either "INTEGER" or "PRINTABLESTRING".

TA_DMREMTPSUT: string[1..64]

Optional. If the TA_DMTPSUTTYPE parameter is set to "INTEGER" this parameter must contain an integer value in the range MINLONG to MAXLONG. If the TA_DMTPSUTTYPE parameter is set to "PRINTABLESTRING" this parameter must contain the TPSU-Title in PRINTABLESTRING form with a maximum length of 64 characters.

Attributes available from remote access points of TA_DMTYPE=TOPEND

TA_DMTE_PRODUCT: string[1..32]

The BEA TOP END product name. This attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". It is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_FUNCTION: string[1..8]

The BEA TOP END function name. This attribute must be specified if TA_DMRESOURCETYPE="SERVICE" or "QNAME". It is not permitted if TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_TARGET: string[1..8]

The BEA TOP END Message Sensitive Routing (MSR) target. This attribute is optional attribute for entries of TA_DMRESOURCETYPE ="SERVICE", "QSPACE", or "QNAME".

TA_DMTE_QUALIFIER: 0 <= num <= MAXLONG

The BEA TOP END function qualifier. This attribute is optional for entries of TA_DMRESOURCETYPE="SERVICE" and "QNAME". It is not permitted for entries of TA_DMRESOURCETYPE="QSPACE".

TA_DMTE_RTQGROUP: string[1..32]

The BEA TOP END Recoverable Transaction Queuing (RTQ) queue group name. This attribute must be specified if TA_DMRESOURCETYPE="QSPACE". It is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

TA_DMTE_RTQNAME: string[1..8]

The BEA TOP END RTQ queue name. This attribute must be specified if TA_DMRESOURCETYPE="QSPACE". It is not permitted if TA_DMRESOURCETYPE="SERVICE" or "QNAME".

Limitations

None.

T_DM_LOCAL Class Definition

Overview

The T_DM_LOCAL class defines a local domain access point. A local domain access point is used to control access to local services exported to remote domains and to control access to remote services imported from remote domains.

Attribute Table

DM_MIB(5): T_DM_LOCAL 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_DMSRVGROUP(r)	string	rw-r--r--	string[1..30]	N/A
TA_DMTYPE	string	rw-r--r--	"{TDOMAIN \|OSITPX \| SNAX \| TOPEND}"	"TDOMAIN"
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMAUDITLOG	string	rw-r--r--	string[1..78]	N/A
TA_DMBLOCKTIME	short	rw-r--r--	0 <= num <= 32,767	TA_BLOCKTIME in T_DOMAIN^{Note 1}
TA_DMMAXRAPTRAN	short	rw-r--r--	0 <= num <= 32,767	16
TA_DMMAXTRAN	short	rw-r--r--	0 <= num <= 32,767	TA_MAXGTT in T_DOMAIN ^{Note 2}
TA_DMSECURITY	string	rw-r--r--	"{NONE \| APP_PW \| DM_PW \| DM_USER_PW \| CLEAR \| SAFE \| PRIVATE}"	"NONE"
TA_DMTLOGDEV	string	rw-r--r--	string[1..78]	N/A
TA_DMTLOGNAME	string	rw-r--r--	string[1..30]	"DMTLOG"
TA_DMTLOGSIZE	long	rw-r--r--	1 <= num <= 2048	100
Attributes available when TA_DMTYPE=TDOMAIN\|TOPEND:
TA_DMCONNECTION_POLICY	string	rwxr--r--	"{ON_DEMAND \| ON_STARTUP \| INCOMING_ONLY}"	"ON_DEMAND"
TA_DMRETRY_INTERVAL	long	rwxr--r--	0 <= num <= MAXLONG	60
TA_DMMAXRETRY	long	rwxr--r--	0 <= num <= MAXLONG	0
TA_DMCONNPRINCIPALNAME	string	rwxr--r--	string[0..511]	""
TA_DMMACHINETYPE	string	rw-r--r--	string[0..15]	""
Attributes available when TA_DMTYPE=OSITPX\|TOPEND:
TA_DMBLOB_SHM_SIZE	long	rw-r--r--	1 <= num <= MAXLONG	1000000
(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

^{Note 1} Current value of TA_BLOCKTIME in the T_DOMAIN class

^{Note 2} Current value of TA_MAXGTT in the T_DOMAIN class

Attribute Semantics

The name of this T_DM_LOCAL entry—an identifier unique within the scope of the T_DM_LOCAL and T_DM_REMOTE entry names in the domain configuration.

TA_DMACCESSPOINTID: string[1..30]

The domain access point identifier. This identifier is unique across all local and remote domain access points.

TA_DMSRVGROUP: string[1..30]

The group name in which the administrative server and gateway process of the local domain reside.

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

The type of domain: "TDOMAIN" for a BEA Tuxedo system domain, "OSITPX" for an OSITP 4.0 or later domain, "SNAX" for an SNA domain, or "TOPEND" for a BEA TOP END domain. The presence or absence of other attributes depends on the value of this attribute.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_LOCAL object. The following states indicate the meaning of a TA_STATE set 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_DMAUDITLOG:string[1..78]

The name of the audit log file for this local domain.

TA_DMBLOCKTIME: 0 <= num <= 32,767

Specifies the maximum wait time allowed for a blocking call. The value sets a multiplier of the SCANUNIT parameters specified in the T_DOMAIN object. The value SCANUNIT * TA_BLOCKTIME must be greater than or equal to SCANUNIT and less than 32,768 seconds. If this attribute is not specified, the default is set to the value of the TA_BLOCKTIME attribute specified in the T_DOMAIN object. A timeout always implies a failure of the affected request. Notice that the timeout specified for transactions in the T_DOMAIN is always used when the request is issued within a transaction.

TA_DMMAXRAPTRAN: 0 <= num <= 32,767

The maximum number of remote domain access points that can be involved in a single transaction.

TA_DMMAXTRAN: 0 <= num <= 32,767

The maximum number of simultaneous transactions allowed on this local domain access point. This number must be greater than or equal to T_DOMAIN.TA_MAXGTT.

TA_DMSECURITY: "{NONE | APP_PW | DM_PW | DM_USER_PW | CLEAR | SAFE | PRIVATE}"

The type of security enabled on this domain. This attribute must be set to one of the following:

"NONE"

No security is enabled.

"APP_PW"

Valid only when TA_DMTYPE="TDOMAIN". Application password-based security is enabled.

"DM_PW"

Valid only when TA_DMTYPE="TDOMAIN" or TA_DMTYPE="OSITPX". Domain password-based security is enabled.

"DM_USER_PW"

Valid only when TA_DMTYPE="SNAX". Translation of principal names is enabled.

"CLEAR"

Valid only when TA_DMTYPE="TOPEND". BEA TOP END security is enabled between the local domain and the BEA TOP END system. Network messages are sent in plain text.

"SAFE"

Valid only when TA_DMTYPE="TOPEND". BEA TOP END security is enabled between the local domain and the BEA TOP END system. Network messages are protected by a checksum.

"PRIVATE"

Valid only when TA_DMTYPE="TOPEND". BEA TOP END security is enabled between the local domain and the BEA TOP END system. Network messages are encrypted.

TA_DMTLOGDEV: string[1..78]

The device (raw slice) or file containing the domain TLOG for this local domain access point. The TLOG is stored as a BEA Tuxedo System VTOC table on the device. For reliability, the use of a device (raw slice) is recommended.

TA_DMTLOGNAME: string[1..30]

The domain TLOG name for this local domain access point. If more than one TLOG exists on the same device, each TLOG must have a unique name.

TA_DMTLOGSIZE: 1 <= num <= 2048

The size in pages of the TLOG for this local domain access point. This size is constrained by the amount of space available on the device identified in TA_DMTLOGDEV.

Attributes available when TA_DMTYPE = TDOMAIN | TOPEND

TA_DMCONNECTION_POLICY:"{ON_DEMAND | ON_STARTUP | INCOMING_ONLY}"

Specifies the conditions under which a local domain gateway tries to establish a connection to a remote domain. Supported values are: "ON_DEMAND", "ON_STARTUP", or "INCOMING_ONLY".

"ON_DEMAND"

Means that a connection is attempted only when requested by either a client request to a remote service or an administrative "connect" command. The default setting for TA_DMCONNECTION_POLICY attribute is "ON_DEMAND". The "ON_DEMAND" policy provides the equivalent behavior to previous releases, in which the TA_DMCONNECTION_POLICY attribute was not explicitly available. Connection retry processing is not allowed with this policy.

"ON_STARTUP"

Means that a domain gateway attempts to establish a connection with its remote domain access points at gateway server initialization time. Remote services (that is, services advertised by the domain gateway for this local access point) are advertised only if a connection is successfully established to that remote domain access point. Therefore, if there is no active connection to a remote domain access point, then the remote services are suspended. By default, this connection policy retries failed connections every 60 seconds; however, you can specify a different value for this interval using the TA_DMMAXRETRY and TA_DMRETRY_INTERVAL attributes.

"INCOMING_ONLY"

Means that a domain gateway does not attempt an initial connection to remote domain access points upon starting, and remote services are initially suspended. The domain gateway is available for incoming connections from remote domain access points, and remote services are advertised when the domain gateway for this local domain access point receives an incoming connection. Connection retry processing is not allowed when the connection policy is "INCOMING_ONLY".

TA_DMRETRY_INTERVAL: 0 <= num <= MAXLONG

The number of seconds between automatic attempts to establish a connection to remote domain access points. The minimum value is 0 and the maximum value is 2147483647. The default setting is 60. If TA_DMMAXRETRY is set to 0, then setting TA_DMRETRY_INTERVAL is not allowed.

This attribute is valid only when the TA_DMCONNECTION_POLICY attribute is set to "ON_STARTUP". For other connection policies, automatic retries are disabled.

TA_DMMAXRETRY: 0 <= num <= MAXLONG

The number of times that a domain gateway tries to establish connections to remote domain access points. The minimum value is 0 and the maximum is MAXLONG. MAXLONG indicates that retry processing is repeated indefinitely, or until a connection is established. For a connection policy of "ON_STARTUP", the default setting for TA_DMMAXRETRY is MAXLONG. Setting this attribute to 0 turns off the auto retry mechanism. For other connection policies, auto retries are disabled.

The TA_DMMAXRETRY attribute is valid only when the connection policy is "ON_STARTUP".

TA_DMCONNPRINCIPALNAME: string[0..511]

The connection principal name identifier, which is the principal name used for verifying the identity of this local domain access point when establishing a connection to a remote domain access point. This attribute only applies to domains of type TDOMAIN that are 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 local domain access point.

For default authentication plug-ins, if a value is assigned to the TA_DMCONNPRINCIPALNAME attribute for this local domain access point, it must be the same as the value assigned to the TA_DMACCESSPOINTID attribute for this local domain access point. If these values do not match, the local domain gateway process will not boot, and the system will generate the following userlog(3c) message: ERROR: Unable to acquire credentials.

TA_DMMACHINETYPE: string[0..15]

Used for grouping domains so that encoding/decoding of messages between

domains can be bypassed. If TA_DMMACHINETYPE is not specified, the default is to turn encoding/decoding on. If the value set for the TA_DMMACHINETYPE field 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.

This attribute is valid only when TA_DMTYPE=TDOMAIN.

Attributes available when TA_DMTYPE = OSITPX | TOPEND

TA_DMBLOB_SHM_SIZE: 1 <= num <= MAXLONG

Relevant only to local domain access point entries. Specifies the amount of shared memory allocated to storing binary large object log information specific to OSITPX or TOPEND.

Limitations

When the Domain gateway administration (GWADM) server supporting the local domain access point specified in the TA_DMLACCESSPOINT attribute is active, you cannot SET the TA_STATE to INValid or update the following attributes: TA_DMACCESSPOINTID, TA_DMMAXRAPTRAN, TA_DMMAXTRAN, TA_DMSRVGROUP, TA_DMTYPE, TA_DMTLOGDEV, TA_DMTLOGNAME, TA_DMTLOGSIZE, TA_DMMACHINETYPE, or TA_DMCODEPAGE.

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.

Attribute Table

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_DMMAXENCRYPTBITS	short	rw-r--r--	"{0}"	"0"
TA_DMMINENCRYPTBITS	short	rw-r--r--	"{0}"	"0"
TA_DMMULTIPLEXING	string	rw-r--r--	0<= num <= 32767	0
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

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:

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.

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 the domain access point. This attribute comprises the application process title as an object identifier form followed by the application entity qualifier as an integer, using he following form: {object identifier},{integer qualifier}.

TA_DMNWADDR: string[1..631]

The semicolon-separated list of network addresses to use for this access point. This attribute uses the following form: address[,{IP|CONS|CLNS}][;address[,{IP|CONS|CLNS}]...]

Each element in the list is an address followed by an optional address type. If the optional address type is absent, it defaults to IP. If the address type is IP, the network address takes one of the following forms:

//hostname[:port_number]

#.#.#.#[:port_number]

If the port_number component is absent, the default RFC 1006 port "102" is used. If the address type is CONS or CLNS, an example address could be an X, 121, or NSAP address consisting of 1-20 hexadecimal octets preceded by 0x.

0x9900010012000001234abcde9900

For a local domain access point, this contains the list of up to eight addresses to listen on. For a remote domain access point, it 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 use on this domain access point. Either 1-32 ASCII non-control characters or 1-32 hexadecimal octets preceded by 0x.

TA_DMDNRESOLUTION: "{STARTUP | RUNTIME}"

Defines the hostname form of a network address when DNS resolution takes place for the address. If set (or defaulted) to STARTUP the resolution of hostname to an actual IP address takes place at gateway startup.

Note: This attribute is relevant only when defining a local domain access point and 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_DMMAXENCRYPTBITS: "{0}"

This attribute is not currently used. It is reserved for future enhancements to OSITPX, and will involve negotiating a maximum encryption level.

TA_DMMINENCRYPTBITS: "{0}"

This attribute is not currently used. It is reserved for future enhancements to OSITPX, and will involve negotiating a minimum encryption level.

TA_DMMULTIPLEXING: 0 <= num <= 32767

This attribute is not currently used. It is reserved for future enhancements to OSITPX, and will involve specifying the level of multiplexing to be performed to the destination remote domain access point.

TA_DMPSEL: string[1..10]

This optional attribute is the Presentation Service Access Point address to be used on this domain access point. Values can include either 1-4 ASCII non-control characters or 1-4 hexadecimal octets preceded by 0x.

TA_DMSSEL: string[1..34]

This optional attribute is the Session Service Access Point address to be used on this domain access point. Valid values can include either 1-16 ASCII non-control characters or 1-16 hexadecimal octets preceded by 0x.

TA_DMTAILORPATH: string[1..78]

This optional attribute is the full pathname of the OSI TP tailor file used for tuning the OSI TP stack in a local domain access point. If no value is supplied or the value is set to the NULL string, then the OSI TP stack will run using default values for tuning parameters.

Note: This attribute is relevant only when defining a local domain access point and 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 parameter is valid only when describing an RDROM. Valid values are:

"CAE"

"PRELIMINARY"

"OLTP_TM2200"

"NATIVE_A_SERIES"

Note: Ths attribute is relevant only for remote domain access points and is ignored for local domain access points.

TA_DMEXTENSIONS: string[1..78]

This optional attribute is a string that will be used for future enhancements to OSITPX, which will involve adding new parameters to the LDOM or RDOM sections.

TA_DMOPTIONS: "{SECURITY_SUPPORTED}"

This optional attribute will be a bit mask field in the DM_OSITPX structure. This parameter is valid only when describing an RDOM. The valid values are

SECURITY_SUPPORTED.

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 administration (GWADM) server for the local access point is active.
The instance of the class corresponds to a remote domain access point and any OSI TP Domain gateway administration (GWADM) server is active.

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

T_DM_PASSWORD Class Definition

Overview

The T_DM_PASSWORD class represents configuration information for inter-domain authentication through access points of type TDOMAIN.

Attribute Table

DM_MIB(5): T_DM_PASSWORD Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMLACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMRACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMLPWD(r)	string	-w-------	string[1..30]	N/A
TA_DMRPWD(r)	string	-w-------	string[1..30]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV \| REC}"	N/A 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

The name of the local domain access point to which the password applies.

The name of the remote domain access point to which the password applies.

TA_DMLPWD: string[1..30]

The local password to be used to authenticate connections between the local domain access point identified by TA_DMLACCESSPOINT and the remote domain access point identified by TA_DMRACCESSPOINT.

TA_DMRPWD: string[1..30]

The remote password to be used to authenticate connections between the local domain access point identified by TA_DMLACCESSPOINT and the remote domain access point identified by TA_DMRACCESSPOINT.

TA_STATE:

GET:"{VALid}"

A GET operation retrieves configuration information for the selected T_DM_PASSWORD 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 | RECrypt}"

A SET operation updates configuration information for the selected T_DM_PASSWORD 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. A 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 state "INValid".
"INValid"	The object is deleted. A state change is allowed in the state "VALid" and results in the state "INValid".
"RECrypt"	Re-encrypt all passwords using a new encryption key. Applies to all password instances in the T_DM_PASSWORD and T_DM_TOPEND classes.

Limitations

Passwords cannot be re-encrypted (SET TA_STATE to "RECrypt") when any domain gateway administration server (GWADM) is running.

T_DM_PRINCIPAL_MAP Class Definition

Overview

The T_DM_PRINCIPAL_MAP class represents configuration information for mapping principal names to and from external principal names across access points of type SNAX.

Attribute Table

DM_MIB(5): T_DM_PRINCIPAL_MAP Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMLACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMRACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMPRINNAME(r)(k)(*)	string	rw-------	string[1..30]	N/A
TA_DMRPRINNAME(r)(k)(*)	string	rw-------	string[1..30]	N/A
TA_DMDIRECTION(k)	string	rw-r-----	"{IN \| OUT \| BOTH}"	"BOTH"
TA_STATE(r)	string	rw-r--r--	GET:"VAL" SET:"{NEW \| INV}"	N/A 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

The local domain access point to which the principal mapping applies.

The remote domain access point to which the principal mapping applies.

TA_DMPRINNAME: string[1..30]

The local principal name in the principal mapping.

TA_DMRPRINNAME: string[1..30]

The remote principal name in the principal mapping.

TA_DMDIRECTION: "{IN | OUT | BOTH}"

The direction to which the principal mapping applies.

"IN"

Is INcoming to this BEA Tuxedo domain through the given remote domain access point and local domain access point.

"OUT"

Is OUTgoing from this BEA Tuxedo domain through the given local domain access point and remote domain access point.

"BOTH"

Applies to both INcoming and OUTgoing.

TA_STATE:

GET:"{VALid}"

A GET operation retrieves configuration information for the selected T_DM_PRINCIPAL entry. 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_PRINCIPAL entry. 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. A 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 state "INValid".
"INValid"	The object is deleted. A state change is allowed in the state "VALid" and results in the state "INValid".

Limitations

In BEA Tuxedo release 7.1, the T_DM_PRINCIPAL_MAP class only applies to the SNAX domain gateway type.

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

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 \| OSITPX \| SNAX \| TOPEND}"	"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<=99	0 or 50 (see text)
Attributes available when TA_DMTYPE=SNAX and OSITPX:
TA_DMCODEPAGE	string	rw-r--r--	string[1..20]	N/A
Attributes available when TA_DMTYPE=TDOMAIN and 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]	""
(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

The name of this T_DM_REMOTE entry. TA_DMACCESSPOINT is an identifier unique within the scope of T_DM_LOCAL and T_DM_REMOTE entry names in the domain configuration.

TA_DMACCESSPOINTID: string[1..30]

The access point identifier. This identifier is unique across all local and remote domain access points.

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

The type of domain: "TDOMAIN" for a BEA Tuxedo system domain, "OSITPX" for an OSITP 4.0 or later domain, "SNAX" for an SNA domain, or "TOPEND" for a BEA TOP END domain. The presence or absence of other attributes depends on the value of this attribute.

TA_STATE:

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.

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 = number

Specifies the message priority handling for this remote domain. These parameters only apply to domains that are running BEA Tuxedo 8.0 or later software. The LOCAL_RELATIVE and LOCAL_ABSOLUTE parameters can apply to all domain types. However, the GLOBAL parameter only applies to domains of type TDOMAIN.

The LOCAL_RELATIVE parameter means that the priority associated with a request from the remote domain (for example, via the tpsprio call) is not propagated to the local domain. If the TA_DMINPRIORITY value is set, the priority of these incoming requests from the remote domain will be set relative to the TA_DMINPRIORITY value. The TA_DMINPRIORITY value must be between -99 and +99, inclusive, with 0 being the default value if the TA_DMINPRIORITY value is not set. The setting of TA_DMINPRIORITY value 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, the priority associated with a request will be sent to the remote domain (along with the request).

The LOCAL_ABSOLUTE parameter means that the priority associated with a request from the remote domain is not propagated to the local domain. However, the priority of incoming requests will be set to the absolute value of the TA_DMINPRIORITY value. If the TA_DMINPRIORITY value is not set, it defaults to 50. The TA_DMINPRIORITY value must be within a range of 1-100, inclusive, with 100 being the highest priority. For requests to the remote domain, the priority associated with a request will be sent to the remote domain (along with the request).

The GLOBAL parameter means that the priority associated with a request from the remote domain is propagated to the local domain. The default value for the specific service will be ignored locally. If the TA_DMINPRIORITY value is set, the priority of the incoming request from the remote domain will be added to the TA_DMINPRIORITY value. The sum of the priorities will then be set absolutely for the incoming request. The TA_DMINPRIORITY value must be between -99 and +99, inclusive, with 0 being the default value if the TA_DMINPRIORITY value is not set. The setting of the TA_DMINPRIORITY value 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. Setting TA_DMINPRIORITY to 0 means the priority is coming directly from the remote domain. For requests to the remote domain, the priority associated with a request will be sent to the remote domain (along with the request).

If not specified, the default is LOCAL_RELATIVE with TA_DMINPRIORITY set to 0.

Attributes available when TA_DMTYPE=SNAX and OSITPX

TA_DMCODEPAGE: string[1..20]

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

Attributes available when TA_DMTYPE=TDOMAIN and OSITPX

TA_DMACLPOLICY: {LOCAL | GLOBAL}

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

LOCAL means that the local domain modifies the identity of service requests received from this remote domain to the principal name specified in the TA_DMLOCALPRINCIPALNAME attribute for this remote domain access point. GLOBAL means that the local domain uses any credential it might receive from the remote domain on inbound service requests. If no credential is received from the remote domain, then the service request is forwarded to the service without credentials (which usually fails). If not specified, the default is LOCAL.

Note that this attribute controls whether or not the local domain accepts a credential from the remote domain. The TA_DMCREDENTIALPOLICY attribute is related to this one and controls whether or not a local domain sends credentials to the remote domain.

TA_DMLOCALPRINCIPALNAME: string[0..511]

The local principal name identifier, which is the identity assigned by the local domain to service requests received from this remote domain. This attribute only applies to domains of type TDOMAIN that are running BEA Tuxedo 7.1 or later software and domains of type and OSITPX that are running BEA Tuxedo 8.0 or later software.

The TA_DMLOCALPRINCIPALNAME attribute is valid only if the TA_DMACLPOLICY attribute for this remote domain is set (or defaulted) to LOCAL. 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 only applies to domains of type TDOMAIN that are running BEA Tuxedo 7.1 or later software.

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 only applies to domains of type TDOMAIN that are running BEA Tuxedo 8.0 or later software.

If the policy is LOCAL then the domain does not attach the credentials of the user that originated a request with the invocation to the remote domain. If the policy is GLOBAL, then the domain attaches the credentials of the user that originated the request with the invocation to the remote domain. If not specified, the default is LOCAL.

Note that this parameter controls whether or not user credentials are sent to a remote domain. The TA_DMACLPOLICY is related to this one and controls whether or not incoming credentials are accepted by a domain.

TA_DMMACHINETYPE: string[0..15]

Used for grouping domains so that encoding/decoding of messages between domains can be bypassed. If TA_DMMACHINETYPE is not specified, the default is to turn encoding/decoding on. If the value set for the TA_DMMACHINETYPE field is the same in both the DM_LOCAL and the DM_REMOTE section of a domain configuration file, 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.

Limitations

When any Domain gateway administration 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_OSITPX, T_DM_ROUTING, or T_DM_TDOMAIN.

T_DM_RESOURCES Class Definition

Overview

The T_DM_RESOURCES class represents Domains-specific configuration information.

Attribute Table

DM_MIB(5): T_DM_RESOURCES Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMVERSION(r)	string	rw-r--r--	string[1..30]	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_DMVERSION: string[1..30]

A user-supplied identifier for the Domains configuration.

Limitations

None.

T_DM_ROUTING Class Definition

Overview

The T_DM_ROUTING class represents routing criteria information for routing requests to a domain through a remote domain access point.

Attribute Table

DM_MIB(5): T_DM_ROUTING Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMROUTINGNAME(r)(k)(*)	string	rw-r--r--	string[1..15]	N/A
TA_DMBUFTYPE(r)(k)(*)	string	rw-r--r--	string[1..256]	N/A
TA_DMFIELD(r)	string	rw-r--r--	string[1..30]	N/A
TA_DMFIELDTYPE	string	rw-r--r--	"{CHAR \| SHORT \| LONG \| FLOAT \| DOUBLE \| STRING}"	N/A
TA_DMRANGES(r)	string	rw-r--r--	string[1..4096]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A 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_DMROUTINGNAME: string[1..15]

The name of the routing criteria table entry—an identifier unique within the scope of T_DM_ROUTING entries in the domain configuration.

TA_DMBUFTYPE: string[1..256]

"type1[:subtype1[,subtype2 . . . ]][;type2[:subtype3[,subtype4 . . . ]] . . . ]"

List of types and subtypes of data buffers for which this routing entry is valid. A maximum of 32 type/subtype combinations is allowed. The types are restricted to the following: FML, FML32, XML, VIEW, VIEW32, X_C_TYPE, or X_COMMON. No subtype can be specified for type FML, FML32, or XML; subtypes are required for types VIEW, VIEW32, X_C_TYPE, and X_COMMON ("*" is not allowed). Note that subtype names should not contain semicolon, colon, comma, or asterisk characters. Duplicate type/subtype pairs cannot be specified for the same routing criterion name; more than one routing entry can have the same criterion name as long as the type/subtype pairs are unique. If multiple buffer types are specified for a single routing entry, the data types of the routing field for each buffer type must be the same.

TA_DMFIELD: string[1..30]

The name of the field to which routing is applied.

For FML (and FML32) buffer types, TA_DMFIELD contains an FML field name that must be defined in an FML field table. When routing is performed, the field name is retrieved using the FLDTBLDIR and FIELDTBLS (FLDTBLDIR32 and FIELDTBLS32 for FML32) environment variables.

For VIEW (and VIEW32) buffer types, TA_DMFIELD contains a VIEW field name that must be defined in an FML VIEW table. When routing is performed, the field name is retrieved using the VIEWDIR and VIEWFILES (VIEWDIR32 and VIEWFILES32 for VIEW32) environment variables.

When routing a buffer to its correct remote domain access point, the appropriate table is used to get the data-dependent routing field value within a buffer.

For an XML buffer type, TA_DMFIELD contains either a routing element type (or name) or a routing element attribute name.

The syntax of the TA_DMFIELD parameter for an XML buffer type is as follows:

"root_element[/child_element][/child_element][/. . .][/@attribute_name]"

The element is assumed to be an XML document or datagram element type. Indexing is not supported. Therefore, the BEA Tuxedo system recognizes only the first occurrence of a given element type when processing an XML buffer for data-dependent routing. This information is used to get the associated element content for data-dependent routing while sending a message. The content must be a string encoded in UTF-8.

The attribute is assumed to be an XML document or datagram attribute of the defined element. This information is used to get the associated attribute value for data-dependent routing while sending a message. The value must be a string encoded in UTF-8.

The combination of element name and attribute name may contain up to 30 characters.

The type of the routing field can be specified by the TA_DMFIELDTYPE attribute.

TA_DMFIELDTYPE: "{CHAR | SHORT | LONG | FLOAT | DOUBLE | STRING}"

The type of the routing field specified in the TA_DMFIELD attribute. The type can be CHAR, SHORT, LONG, FLOAT, DOUBLE, or STRING; only one type is allowed. This attribute is required if TA_DMBUFTYPE is XML; it must be absent if TA_DMBUFTYPE is FML, VIEW, X_C_TYPE, or X_COMMON.

TA_DMRANGES: string[1..4096]

The ranges and associated remote access points for the TA_DMFIELD routing field. The format of the string is a comma-separated, ordered list of range/group name pairs. A range/group name pair has the following format:

"lower[-upper]:raccesspoint"

lower and upper are signed numeric values or character strings in single quotes. lower must be less than or equal to upper. To embed a single quote in a character string value, it must be preceded by two backslashes (for example, 'O\\'Brien'). The value MIN can be used to indicate the minimum value for the data type of the associated field on the machine. The value MAX can be used to indicate the maximum value for the data type of the associated field on the machine. Thus, "MIN--5" is all numbers less than or equal to -5, and "6-MAX" is all numbers greater than or equal to 6.

The meta-character "*" (wildcard) in the position of a range indicates any values not covered by the other ranges previously seen in the entry. Only one wildcard range is allowed per entry and it should be last (ranges following it are ignored).

A numeric routing field must have numeric range values, and a string routing field must have string range values.

String range values for string, carray, and character field types must be placed inside a pair of single quotes and cannot be preceded by a sign. Short and long integer values are a string of digits, optionally preceded by a plus or minus sign. Floating point numbers are of the form accepted by the C compiler or atof(3): an optional sign, then a string of digits optionally containing a decimal point, then an optional e or E followed by an optional sign or space, followed by an integer.

The raccesspoint parameter indicates the remote domain access point to which the request is routed if the field matches the range. A raccesspoint of "*" indicates that the request can go to any remote domain access point that imports the desired service.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_ROUTING 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. Successful return leaves the object state unchanged.
"INValid"	The object is deleted.

Limitations

You cannot delete an instance of the T_DM_ROUTING class if it is referenced by an instance of the T_DM_IMPORT class.

T_DM_RPRINCIPAL Class Definition

Overview

The T_DM_RPRINCIPAL class represents password configuration information for remote principal names.

Attribute Table

DM_MIB(5): T_DM_RPRINCIPAL Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMRACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMRPRINNAME(r)(k)(*)	string	rw-------	string[1..30]	N/A
TA_DMRPRINPASSWD(r)(*)	string	-w-------	string[0..8]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A 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

The remote domain access point to which the principal is applicable.

Note: The combination of TA_DMRACCESSPOINT and TA_DMRPRINNAME must be unique within the scope of TA_DM_RPRINCIPAL entries in the domain configuration.

TA_DMRPRINNAME: string[1..30]

The remote principal name.

Note: The combination of TA_DMRACCESSPOINT and TA_DMRPRINNAME must be unique within the scope of TA_DM_RPRINCIPAL entries in the domain configuration.

TA_DMRPRINPASSWD: string[0..8]

The remote password to be used for the principal name when communicating through the remote domain access point identified in TA_DMRACCESSPOINT.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_RPRINCIPAL 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. A 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 state "INValid".
"INValid"	The object is deleted. A state change is allowed in the state "VALid" and results in the state "INValid".

Limitations

In BEA Tuxedo release 7.1, the T_DM_RPRINCIPAL class applies only to the SNAX domain gateway type.

T_DM_SNACRM Class Definition

Overview

The T_DM_SNACRM class defines the SNA-CRM-specific configuration for the named local domain access point.

Attribute Table

DM_MIB(5): T_DM_SNACRM Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMSNACRM(k)(r)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMLACCESSPOINT(k)(r)	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_DMNWADDR(r)	string	rw-r--r--	string[1..78]	N/A
TA_DMNWDEVICE(r)	string	rw-r--r--	string[1..78]	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_DMSNACRM: string[1..30]

The name of this T_DM_SNACRM entry. TA_DMSNACRM is an identifier unique within the scope of the SNA CRM entries within the domain configuration used to identify this SNA CRM entry.

The name of the local domain access point entry with which this SNA CRM is used.

TA_STATE:

A GET operation retrieves configuration information for the T_DM_SNACRM 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_SNACRM object. The following states indicate the meaning of a TA_STATE set 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 entry. This combination is not allowed in the state "INValid".
"INValid"	The object is deleted. This state change is allowed in the state "VALid" and results in the state "INValid".

TA_DMNWADDR: string[1..78]

Specifies the network address for communication between the domain gateway for the local domain access point and the SNA CRM.

TA_DMNWDEVICE: string[1..78]

Specifies the network device to be used for communication between the domain gateway for the local domain access point and the SNA CRM.

Limitations

Deleting or updating an instance of the T_DM_SNACRM class is not permitted if the Domain gateway administration (GWADM) server for the referenced local access point is active.

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

T_DM_SNALINK Class Definition

Overview

The T_DM_SNALINK class represents SNAX-specific configuration information for a remote domain access point.

Attribute Table

DM_MIB(5): T_DM_SNALINK Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMSNALINK(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMSNASTACK(r)(k)	string	rw-r--r--	string[1..30]	N/A
TA_DMRACCESSPOINT(r)(k)	string	rw-r--r--	string[1..30]	N/A
TA_DMLSYSID(r)	string	rw-r--r--	string[1..4]	N/A
TA_DMRSYSID(r)	string	rw-r--r--	string[1..4]	N/A
TA_DMLUNAME(r)	string	rw-r--r--	string[1..8]	N/A
TA_DMMINWIN(r)	short	rw-r--r--	0 <= num <= 32767	N/A
TA_DMMODENAME(r)	string	rw-r--r--	string[1..8]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMSECTYPE	string	rw-r--r--	"{LOCAL \| IDENTIFY \| VERIFY \| PERSISTENT \| MIXIDPE}"	"LOCAL"
TA_DMSTARTTYPE	string	rw-r--r--	"{AUTO \| COLD}"	"AUTO"
TA_DMMAXSNASESS	short	rw-r--r--	0 <= num <= 32767	64
TA_DMMAXSYNCLVL	short	r--r--r--	0 <= num <= 2	0
(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_DMSNALINK: string[1..30]

The name of the T_DM_SNALINK entry. An identifier, unique within the scope of the SNA LINK entries within the domain configuration, used to identify this TA_DMSNALINK entry.

TA_DMSNASTACK: string[1..30]

The name of the SNAX stack entry to be used to reach this remote domain access point.

Identifies the remote domain access point name for which this entry provides the SNAX configuration data.

TA_DMLSYSID: string[1..4]

The local SYSID to be used when establishing an SNA link to the remote logical unit (LU).

TA_DMRSYSID: string[1..4]

The remote SYSID to be used when establishing an SNA link to the remote LU.

TA_DMLUNAME—>string[1..8]

Specifies the LU name associated with the remote domain access point.

TA_DMMINWIN: 0 <= num <= 32767

The minimum number of winner sessions to the remote LU.

TA_DMMODENAME: string[1..8]

Specifies the name associated with the session characteristics for sessions to the remote LU.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_SNALINK object. The following states indicate the meaning of a TA_STATE set 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 state "INValid".
"INValid"	The object is deleted.

TA_DMSECTYPE: "{LOCAL | IDENTIFY | VERIFY | PERSISTENT | MIXIDPE}"

Specifies the type of SNA security to be used on sessions to the remote LU. Valid values for this attribute are "LOCAL", "IDENTIFY", "VERIFY", "PERSISTENT", and "MIXIDPE".

TA_DMSTARTTYPE: "{AUTO | COLD}"

Specifies the type of session start-up for the destination LU. Setting this attribute to "COLD" forces a COLDSTART with the LU. If set to "AUTO", the SNACRM in conjunction with the domain gateway choose whether to COLDSTART or WARMSTART the LU.

TA_DMMAXSNASESS: 0 <= num <= 32767

Specifies maximum number of sessions to establish with the remote LU.

TA_DMMAXSYNCLVL: 0 <= num <= 2

The maximum SYNC LEVEL that can be supported to this remote LU.

Limitations

Deleting or updating an instance of the T_DM_SNALINK class that refers to a T_DM_SNASTACK class instance is not permitted under the following condition: the T_DM_SNASTACK class instance refers to a T_DM_SNACRM class instance that references a local domain access point for which the Domain gateway administration (GWADM) server is active.

On SET operations that add or update an instance of this class:

The remote domain access point specified in the TA_DMRACCESSPOINT attribute must exist in the T_DM_REMOTE class. If the access point does not exist, a "not defined" error is returned for the TA_DMRACCESSPOINT attribute and the operation fails.
The SNA stack reference name specified in the TA_DMSNASTACK attribute must exist in the T_DM_SNASTACK class. If the reference name does not exist, a "not defined" error is returned for the TA_DMSNASTACK attribute and the operation fails.

T_DM_SNASTACK Class Definition

Overview

The T_DM_SNASTACK class defines an SNA stack to be used by a specific SNA CRM.

Attribute Table

DM_MIB(5): T_DM_SNASTACK Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMSNASTACK(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMSNACRM(r)(k)	string	rw-r--r--	string[1..30]	N/A
TA_DMSTACKTYPE(r)	string	rw-r--r--	string[1..30]	N/A
TA_DMLUNAME(r)	string	rw-r--r--	string[1..8]	N/A
TA_DMTPNAME(r)	string	rw-r--r--	string[1..8]	N/A
TA_DMSTACKPARMS(r)	string	rw-r--r--	string[1..128]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A 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_DMSNASTACK: string[1..30]

The name of this T_DM_SNASTACK entry. TA_DMSNASTACK is an identifier unique within the scope of T_DM_SNASTACK entry names in the domain configuration.

TA_DMSNACRM: string[1..30]

Identifies the T_DM_SNACRM entry of the SNA CRM in which this SNA protocol stack definition is used.

TA_DMSTACKTYPE: string[1..30]

Identifies the protocol stack to be used.

TA_DMLUNAME: string[1..8]

Specifies the LU name to be used on sessions established using this stack definition.

TA_DMTPNAME: string[1..8]

Specifies the TP name associated with the SNA stack. A value of "*" means accept any TP name.

TA_DMSTACKPARMS: string[1..128]

Provides protocol stack specific parameters.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_SNASTACK 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 state "INValid".
"INValid"	The object is deleted. This state change is allowed in the state "VALid" and results in the state "INValid".

Limitations

Deleting or updating an instance of this class is not permitted if the instance of the class references a T_DM_SNACRM object which references a local domain access point for which the Domain gateway administration (GWADM) server is active.

On SET operations that add or update an instance of this class, the SNA CRM name specified in the TA_DMSNACRM attribute must exist in the T_DM_SNACRM class. If the name does not exist, a "not defined" error is returned for the TA_DMSNACRM attribute and the operation fails.

T_DM_TDOMAIN Class Definition

Overview

The T_DM_TDOMAIN class defines the TDomain specific configuration for a local or remote domain access point.

Attribute Table

DM_MIB(5): T_DM_TDOMAIN Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMACCESSPOINT(r)(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMNWADDR(r)(k)(*)	string	rw-r--r--	string[1..78]	N/A
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV}"	N/A N/A
TA_DMNWDEVICE	string	rw-r--r--	string[1..78]	N/A
TA_DMCMPLIMIT	long	rw-rw-r--	0 <= num <= MAXLONG	MAXLONG
TA_DMFAILOVERSEQ	short	rw-rw-r--	0 <= num <= 32767	See below
TA_DMMINENCRYPTBITS	string	rw-------	"{0 \| 40 \| 56 \| 128}"^{Note 1}	"0"
TA_DMMAXENCRYPTBITS	string	rw-------	"{0 \| 40 \| 56 \| 128}"^{Note 1}	"128"
(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

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

Attribute Semantics

The local or remote domain access point name for which this entry provides the TDomain-specific configuration data.

When domain level failover is in use, more than one T_DM_TDOMAIN class entry can be defined with the same TA_DMACCESSPOINT attribute value.

TA_DMNWADDR: string[1..78]

Specifies the network address associated with the access point. For a local domain access point, this attribute supplies the address to be used for listening for incoming connections. For a remote domain access point, this attribute supplies the destination address to be used when connecting to a remote domain access point. The value of this field must be unique across all T_DM_TDOMAIN entries.

TA_STATE:

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

A SET operation updates configuration information for the selected T_DM_TDOMAIN object. The following states indicate the meaning of a TA_STATE set 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 state "INValid".
"INValid"	The object is deleted. This state change is allowed in the state "VALid" and results in the state "INValid".

TA_DMNWDEVICE: string[1..78]

Specifies the network device to be used. For a local domain access point, this attribute specifies the device to be used for listening. For a remote domain access point, this attribute specifies the device to be used when connecting to the remote domain access point.

TA_DMCMPLIMIT: 0 <= num <= MAXLONG

Relevant to remote domain access points only. Threshold message size at and above which compression occurs for traffic to this access point.

TA_DMFAILOVERSEQ: 0 <= num <= 32767

Relevant to remote domain access points only. Specifies the position of this set of addressing in the failover sequence for this remote domain access point. If no failover sequence number is supplied, the first entry for this remote domain access point is allocated the number 10 greater than the highest failover sequence number known for the remote domain access point. Thus, the first entry gets 10, the second 20, and so on.

The domain gateway uses the T_DM_TDOMAIN addressing entries for a particular remote domain access point strictly in the order of their failover sequence numbers—lowest to highest.

Note: This attribute applies only to gateways running BEA Tuxedo release 7.1 and is ignored by gateways running earlier releases of the BEA Tuxedo system.

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

Relevant to remote domain access points only. When establishing a connection to this access point, this attribute specifies the minimum level of encryption required. "0" means no encryption, while "40", "56", and "128" specify the encryption length (in bits). If this minimum level of encryption is not met, link establishment fails. The default value is "0".

The value of 40 bits is provided for backward compatibility.

Note: Modifications to this attribute do not affect established connections.

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

Relevant to remote domain access points only. When establishing a network link to this access point, this attribute specifies the maximum level of encryption allowed. "0" means no encryption, while "40", "56", and "128" specify the encryption length (in bits). The default value is "128".

The value of 40 bits is provided for backward compatibility.

Note: Modifications to this attribute do not affect established connections.

Limitations

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

If the instance of the class corresponds to a local domain access point and the Domain gateway administration (GWADM) server for the local access point is active.
The instance of the class corresponds to a remote domain access point and any TDomain Domain gateway administration (GWADM) server is active.

T_DM_TOPEND Class Definition

Overview

The T_DM_TOPEND class defines the configuration for a local or remote domain access point specific to a BEA TOP END system.

Attribute Table

DM_MIB(5): T_DM_TOPEND Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMACCESSPOINT(k)(r)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMFAILOVERSEQ	short	rw-rw-r--	0 <= num <= 32767	See below
TA_DMNWADDR(r)(k)(*)	string	rw-r--r--	string[1..78]	N/A
TA_DMTE_TP_SYSTEM(r)	string	rw-r--r--	string[1..8]
TA_STATE(r)	string	rw-r--r--	GET: "VAL" SET: "{NEW \| INV \| REC}"	N/A N/A
TA_DMNWDEVICE	string	rw-r--r--	string[1..78]	N/A
TA_DMTE_PWD	string	rwx------	string[1..12]
(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

Specifies the local or remote domain access point name for which this entry provides the BEA TOP END-specific configuration data.

TA_DMFAILOVERSEQ: 0 <= num <= 32767

The domain gateway uses the T_DM_TOPEND addressing entries for a particular remote domain access point strictly in the order of their failover sequence numbers—lowest to highest.

Note: This attribute applies only to gateways running BEA Tuxedo release 7.1 and is ignored by gateways running earlier releases of the BEA Tuxedo system.

TA_DMNWADDR: string[1..78]

TA_DMTE_TP_SYSTEM: string[1..8]

Specifies the name of the BEA TOP END system.

Note: All remote domain access points accessible through a local domain access point must have the same BEA TOP END system name.

TA_STATE:

A GET operation retrieves configuration information for the T_DM_TOPEND 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 | RECrypt}"

A SET operation updates configuration information for the selected T_DM_TOPEND object. The following states indicate the meaning of a TA_STATE set 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".
"RECrypt"	Re-encrypt all passwords using a new encryption key. Applies to all password instances in the T_DM_PASSWORD and T_DM_TOPEND classes.

TA_DMNWDEVICE: string[1..78]

Specifies the network device associated with the local or remote domain access point.

TA_DMTE_PWD: string[1..12]

Specifies the password to be used when sending messages to the BEA TOP END system. Relevant only to local domain access point entries.

T_DM_TRANSACTION Class Definition

Overview

The T_DM_TRANSACTION class represents run-time information about transactions that span domains. This object can be used to find out what remote domain access points are involved in the transaction, the parent domain access point, the transaction state, and other information.

For GET operations, the attributes TA_DMTPTRANID, TA_DMTXACCESSPOINT and TA_DMTXNETTRANID may be supplied to select a particular transaction.

Attribute Table

DM_MIB(5): T_DM_TRANSACTION Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_DMLACCESSPOINT(k)(*)	string	rw-r--r--	string[1..30]	N/A
TA_DMTPTRANID(k)	string	rw-r--r--	string[1..78]	N/A
TA_STATE(r)(k)	string	rwxr-xr--	GET: "{ABD \| ABY \| ACT \| COM \| DEC \| DON \| HAB \| HCO \| HEU \| REA \| UNK}" SET: "INV"	N/A N/A
TA_DMTXACCESSPOINT(k)	string	r--r--r--	string[1..30]	N/A
TA_DMTXNETTRANID(k)	string	r--r--r--	string[1..78]	N/A
TA_DMBRANCHCOUNT	long	r--r--r--	0 <= num	N/A
TA_DMBRANCHINDEX	long	r--r--r--	0 <= num	N/A
Per branch attributes:
TA_DMBRANCHNO	long	r--r--r--	0 <= num	N/A
TA_DMRACCESSPOINT	string	r--r--r--	string[1..30]	N/A
TA_DMNETTRANID	string	r--r--r--	string[1..78]	N/A
TA_DMBRANCHSTATE	string	r--r--r--	GET: "{ABD \| ABY \| ACT \| COM \| DEC \| DON \| HAB \| HCO \| HHZ \| HMI \| REA \| UNK}"	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

Name of the local domain access point with which the transaction is associated. This is a required field for GET operations. For SET operations, TA_DMLACCESSPOINT must be specified.

TA_DMTPTRANID: string[1..78]

Transaction identifier returned from tpsuspend(3c) mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.

TA_STATE:

GET: "{ABorteD | ABortonlY | ACTive | COMcalled | DECided | DONe | HABort | HCOmmit | HEUristic | REAdy | UNKnown}"

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

"ABorteD"	The transaction is being rolled back.
"ABortonlY"	The transaction has been identified for rollback.
"ACTive"	The transaction is active.
"COMcalled"	The transaction has initiated the first phase of commitment.
"DECided"	The transaction has initiated the second phase of commitment.
"DONe"	The transaction has completed the second phase of commitment.
"HABort"	The transaction has been heuristically rolled back.
"HCOmmit"	The transaction has been heuristically committed.
"HEUristic"	The transaction commitment or rollback has completed heuristically. The branch state may give further detail on which branch has completed heuristically.
"REAdy"	The transaction has completed the first phase of a two phase commit. All the participating groups and remote domains have completed the first phase of commitment and are ready to be committed.
"UNKnown"	It was not possible to determine the state of the transaction.

SET:"{INValid}"

A SET operation updates run-time information for the selected T_DM_TRANSACTION object or objects. The following state indicates the meaning of a TA_STATE set in a SET request. States not listed may not be set.

"INValid"

Forget the specified transaction object or objects. This state change is only valid in states "HCOmmit", "HABort", and "HEUristic". If a TA_DMTPTRANID attribute value is not supplied, all heuristic transaction log records for the specified local domain access point are forgotten.

TA_DMTXACCESSPOINT: string[1..30]

If the transaction originated from a remote domain, TA_DMTXACCESSPOINT is the name of the remote domain access point through which it originated. If the transaction originated within this domain, TA_DMTXACCESSPOINT is the name of the local domain access point.

TA_DMTXNETTRANID: string[1..78]

If the transaction originated from a remote domain, TA_DMTXNETTRANID is the external transaction identifier received from the remote domain access point through which it originated. If the transaction originated within this domain, TA_DMTXNETTRANID contains the same value as the TA_DMTPTRANID attribute.

Note: This attribute is available only to gateways running BEA Tuxedo release 7.1 and higher, and is set to the NULL string "" for gateways running earlier releases of the BEA Tuxedo system.

TA_DMBRANCHCOUNT: 0 <= num

The number of branches to remote domain access points involved in the transaction. For a domain gateway that does not make branch information available, this value is zero.

TA_DMBRANCHINDEX: 0 <= num

The index of the first branch-specific attribute values (TA_DMBRANCHNO, TA_DMRACCESSPOINT, TA_DMNETTRANID, and TA_DMBRANCHSTATE) corresponding to this object.

Per branch attributes

TA_DMBRANCHNO: 0 <= num

The branch number of the participating branch (numbered from zero).