Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

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

T_APPQTRANS Class Definition

Overview

The T_APPQTRANS class represents run-time attributes of transactions associated with application queues.

Limitations

It is not possible to retrieve all instances of this class by leaving all key fields unset. Instead, sufficient key fields must be specified to explicitly target a single application queue space. For example, if all key fields except TA_XID are set in an request using tpcall(), all T_APPQTRANS objects associated with the specified queue space will be retrieved.

It is important to keep in mind that transactions represented by objects of this class are not necessarily associated with the application in which they are retrieved. Care must be taken when heuristically committing or aborting a transaction because the transaction may actually belong to or have an effect on another application. The value of the TA_XID attribute is not guaranteed to be unique across applications.

Attribute Table

Table 10 APPQ_MIB(5): T_APPQTRANS Class Definition Attribute Table

Attribute^a	Type	Permissions	Values	Default
`TA_XID`( k )( * )	string	`R--R--R--`	`string`[1..78]	N/A
`TA_APPQSPACENAME`(k)(*)	string	`r--r--r--`	`string`[1..15]	N/A
`TA_QMCONFIG`( k )( * )	string	`r--r--r--`	`string`[1..78]	N/A
`TA_LMID`( k )( * )	string	`r--r--r--`	`string`[1..30]	N/A
`TA_STATE`^b	string	`R-XR-XR--`	`GET`: `"`{`ACT` \| `ABY` \| `ABD` \| `COM` \| `REA` \| `DEC` \| `HAB` \| `HCO`}`"` `SET`: `"`{`HAB` \| `HCO`}`"`	N/A N/A
( k )—`GET` key field^c( * )—required `SET` key field

a. All attributes of class T_APPQTRANS are local attributes.
b. All operations on T_APPQTRANS objects—both GET and SET—silently open the associated queue space (that is, implicitly set the state of the queue space to OPEn if it is not already OPEn or ACTive). This may be a time-consuming operation if the queue space is large.
c. Sufficient key fields must be supplied in a GET operation to explicitly target a single application queue space.

Attribute Semantics

TA_XID: string[1..78]

Transaction identifier as returned by tx_info() and mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.

TA_APPQSPACENAME: string[1..15]

Name of the application queue space associated with the transaction.

TA_QMCONFIG: string[1..78]

Absolute pathname of the file or device where the application queue space is located.

TA_LMID: string[1..30] (no comma)

Identifier of the logical machine where the application queue space is located.

TA_STATE:

GET: {ACTive | ABortonlY | ABorteD | COMcalled | REAdy | DECided |
HAbord | HCommit}

A GET operation retrieves run-time information about the selected transactions. The following list describes the meaning of the TA_STATE attribute returned in response to a GET request. All states are ACTive equivalent for purposes of permissions checking.

`ACTive`	The transaction is active.
`ABortonlY`	The transaction has been identified for rollback.
`ABorteD`	The transaction has been identified for rollback and rollback has been initiated.
`COMcalled`	The initiator of the transaction has called `tpcommit()` and the first phase of two-phase commit has begun.
`REAdy`	All of the participating groups on the retrieval site have successfully completed the first phase of two-phase commit and are ready to be committed.
`DECided`	The second phase of the two-phase commit has begun.
`SUSpended`	The initiator of the transaction has suspended processing on the transaction.

SET: {HABort | HCOmmit}

A SET operation updates the state of the selected transactions. The following list describes the meaning of the TA_STATE attribute returned by a SET request. States not listed cannot be set.

`HABort`	Heuristically abort the transaction. Successful return leaves the object in the `HABort` state.
`HCOmmit`	Heuristically commit the transaction. Successful return leaves the object in the `HCOmmit` state.