---

T_TRANSACTION CLASS

Overview

The T_TRANSACTION class represents run-time attributes of active transactions within the application.

Attribute Table

T_TRANSACTION Class Definition Attribute Table

Attribute1	Type	Permissions	Values	Default
TA_COORDLMID( k )	string	R--R--R--	LMID	N/A
TA_LMID( k )	string	R--R--R--	LMID	N/A
TA_TPTRANID( * )	string	R--R--R--	string[1...78]	N/A
TA_XID( * )	string	R--R--R--	string[1...78]	N/A
TA_STATE( k )	string	R-XR-XR--	GET:"{ACT|ABY|ABD|COM| REA|DEC|SUS}" SET:"{ABD}"	N/A N/A
TA_TIMEOUT	long	R--R--R--	1 <= num	N/A
TA_GRPCOUNT	long	R--R--R--	1 <= num	N/A
TA_GRPINDEX	long	R--R--R--	0 <= num	N/A
TA_GRPNO	long	R--R--R--	1 <= num < 30,000	(2)
( k ) - GET key field ( * ) - GET/SET key, one or more required for SET operations

¹All attributes in Class T_TRANSACTION are local attributes.

²One or more TA_GRPNO attribute values may be returned with each object of the T_TRANSACTION class. The attribute values for each of these attributes belonging to the particular object are the TA_GRPCOUNT number of occurrences beginning with the TA_GRPINDEX.

Attribute Semantics

TA_COORDLMID: LMID

Logical machine identifier of the server group responsible for coordinating the transaction.

TA_LMID: LMID

Retrieval machine logical machine identifier. Note that transaction attributes are primarily kept local to a site and coordinated via common transaction identifiers by transaction management servers (TMSs).

TA_TPTRANID: string[1...78]

Transaction identifier as 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_XID: string[1...78]

Transaction identifier as returned from tx_info(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:{ACTive|ABortonlY|ABorteD|COMcalled|REAdy|DECided|SUSpended}

A GET operation will retrieve run-time information for the selected T_TRANSACTION object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned. Note that distinct objects pertaining to the same global transaction (equivalent transaction identifiers) may indicate differing states. In general, the state indicated on the coordinator's site (TA_COORDLMID) indicates the true state of the transaction. The exception is when a non-coordinator site notices a condition that transitions the transaction state to ABortonlY. This transition will eventually be propagated to the coordinator site and result in the rollback of the transaction, but this change may not be immediately reflected on the coordinator site. All states are ACTive equivalent for the purpose of determining permissions.

PREPrepare	Indicates that the transaction group contains servers that have called xa_end (TMSUSPEND) during the course of transactional work and that commit processing is beginning. This state will exist until either all servers that called xa_end (TMSUSPEND) have caused a call to xa_end (TMSUCESS), at which point the group state will become READy, or until one of the target servers does a rollback of the transaction at which point the group state will become either PostABorT or ABorteD.
PostABorT	Indicates that a server called xa_end (TPFAIL) and that the TMS has not yet called xa_rollback(). (i.e. that other servers that had called xa_end (TMSUSPEND) are being notified by the TMS in order to clean up their associated CORBA objects.
PostCOMmit	Not yet implemented.

SET: {ABorteD}

A SET operation will update run-time information for the selected T_TRANSACTION object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

unset	Modify an existing T_TRANSACTION object. This combination is allowed only when in the REAdy state and only for the purpose of updating an individual group's state. Successful return leaves the object state unchanged.
ABorteD	Abort the T_TRANSACTION object for the application. State change allowed only when in the ACTive, ABortonlY, or COMcalled states. Successful return leaves the object in the ABorteD state.

TA_TIMEOUT: 1 <= num

Time left, in seconds, before the transaction will timeout on the retrieval site. Note that this attribute value is returned only when the transaction state (TA_STATE) is ACTive.

TA_GRPCOUNT: 1 <= num

Number of groups identified as participants in the transaction by the information returned from the retrieval site.

TA_GRPINDEX: 1 <= num

Index of the first group specific attribute values (TA_GRPNO) corresponding to this object.

TA_GRPNO: 1 <= num < 30,000

Group number of the participating group.

Limitations

None.

---

---