![]() |
![]() |
|
|
T_TRANSACTION CLASS
Overview
The T_TRANSACTION class represents run-time attributes of active transactions within the application.
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| 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) |
TA_GSTATE |
long |
R-XR-XR-- |
GET: "PREP|PABT|PCOM" SET:"{HCO|HAB}" |
N/A N/A |
|
1All attributes in Class T_TRANSACTION are local attributes.
2One or more TA_GRPNO and TA_GSTATE 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
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() (that is, 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. |
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 (see TA_GSTATE below). 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. |
ACTive |
The transaction is active in the indicated group. |
ABorteD |
The transaction has been identified for rollback and rollback has been initiated for the indicated group. |
ReaDOnly |
The group has successfully completed the first phase of two-phase commit and has performed only read operations on the resource manager, thus making it unnecessary to perform the second phase of commit for this group. |
REAdy |
The group has successfully completed the first phase of two-phase commit and is ready to be committed. |
HCOmmit |
The group has been heuristically committed. This may or may not agree with the final resolution of the transaction. |
HABort |
The group has been heuristically rolled back. This may or may not agree with the final resolution of the transaction. |
DONe |
This group has completed the second phase of the two-phase commit. |
HCOmmit |
Heuristically commit the group's work as part of the indicated transaction. State change allowed only when TA_GSTATE is REAdy, TA_STATE is REAdy, and the indicated group is not on the coordinator's site. Successful return leaves the object in the HCOmmit state. |
HABort |
Heuristically rollback the group's work as part of the indicated transaction. State change allowed only when TA_GSTATE is ACTive or REAdy, TA_STATE is REAdy, and the indicated group is not on the coordinator's site. Successful return leaves the object in the HABort state. |
Limitations
None.
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|