Tuxedo
0

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

 Previous Next Contents View as PDF  

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

Table 30 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

TA_DMLACCESSPOINT: string[1..30]

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.


 

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.


 

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 or later, 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).

TA_DMRACCESSPOINT: string[1..30]

The name of the remote domain access point for this branch.

TA_DMNETTRANID: string[1..78]

The external transaction identifier used with the remote domain access point for this branch. Some types of domain gateways do not return this information; in this scenario this attribute is set to the empty string. For example, TDomains uses the local transaction identifier in TA_DMTPTRANID for branches to remote domain access points and sets this value to the empty string.

TA_DMBRANCHSTATE:

GET: "{ABD | ABY | ACT | COM | DEC | DON | HAB | HCO | HHZ | HMI | REA | UNK}"

A GET operation will retrieve run-time information for the transaction branch (when it is available for a particular domain gateway type).


 

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

Limitations

This object is never explicitly created by the administrator; it comes into existence when the application starts a multi-domain transaction. The only action an administrator can perform on this object is to set its state to "INValid", which has the effect of causing the transaction to forget heuristic transaction log records. No other attributes are writable. When a transaction state is set to "INValid", the state in the returned buffer is that of the transaction before the heuristic transaction log records are forgotten, not after.

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

On GET and SET operations, the Domain gateway administration (GWADM) server for the local access point identified in the TA_DMLACCESSPOINT attribute must be active. Otherwise, a "not defined" error is returned.

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy