NAME

tkadmin query transaction - displays information about a transaction

SYNOPSIS

tkadmin query transaction -server servername tid [-state] [-originator] [-participants] [-global]

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

tid Identifies the transaction. 

[-state] Shows transaction state information for the server. 

[-originator] Shows the application that initiated the transaction - that is, the application that issued the “begin tran” functionality. 

[-participants] Lists the participating applications in the transaction. 

[-global] Shows the global identifier for the transaction. 

DESCRIPTION

The tkadmin query transaction command displays information about the specified transaction. (Valid transaction identifiers for a server can be displayed with the tkadmin list transactions command.)  By default, all information is displayed and preceded by descriptive field names. To display information without the field names (if, for example, the information is to be used in a script), the appropriate options must be specified. 

EXAMPLES

The following command displays information about transaction 65536.  The output includes the descriptive field names. 

% tkadmin query transaction 65536

State: commitcomplete
Originator: 0101e0823800ef0b861da930c037cf57aa77
Participants: 0101e0823800ef0b861da930c037cf57aa77
Global: 0001000001120101e0823800ef0b861da930c037cf57aa77

The following command displays state information, only, for transaction 65536 :

% tkadmin query transaction 65536 -state

commitcomplete

PRIVILEGE REQUIRED

Encina Monitor query (q) permission to the application server

Encina RQS query (q) permission to the RQS server

Encina SFS query (Q) permission to the SFS server

RELATED INFORMATION

tkadmin abort transaction

tkadmin force transaction

tkadmin list transactions

  —  March 1997