File Formats, Data Descriptions, MIBs, and System Processes Reference
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.
TA_DMLACCESSPOINT(k)(*) |
||||
TA_STATE(r)(k) |
|
|||
|
||||
(r)—required when a new object is created |
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.