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

 

---

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

 

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.

"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 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).

"ABorteD"	The transaction branch is being rolled back.
"ABortonlY"	The transaction branch has been identified for rollback.
"ACTive"	The transaction branch is active.
"COMcalled"	The transaction branch has initiated the first phase of commitment.
"DECided"	The transaction branch has initiated the second phase of commitment.
"DONe"	The transaction branch has completed the second phase of commitment.
"HABort"	The transaction has been heuristically rolled back.
"HCOmmit"	The transaction has been heuristically committed.
"Heuristic HaZard"	Communications for the transaction branch failed, and it has not been determined if rollback completed successfully.
"Heuristic MIxed"	The commitment or rollback for the transaction branch has completed and the remote domain has reported that the state of some of the resources used for the commitment or rollback is not consistent with the outcome of the transaction.
"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"	The state of the transaction could not be determined.

 

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.

Contact BEA |  Feedback |  Privacy  |