cjlisttrn (display information about transactions operating in J2EE server)

Organization of this page

Format
Function
Arguments
Input examples
Output format
Return values
Notes

Format

cjlisttrn [server-name] [-nameserver provider-URL]
     [-gid global-transaction-ID] [-pending]
     [-time elapsed-time] [-bqual] [-tp1]

To Page Top

Function

This command displays a list of the statuses and elapsed times of the transactions operating in the specified J2EE server.

If there are multiple J2EE servers operating on the same OS, you must issue the cjlisttrn command separately for all the J2EE server processes related to the transaction.

This command can be executed if true is set for the ejbserver.distributedtx.XATransaction.enabled key in the usrconf.properties file (user property file for the J2EE server).

To Page Top

Arguments

server-name

Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.

-nameserver provider-URL

Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:

protocol-name: : host-name: port-number

For details on the specification items, see 2.1.2 Provider URL.

-gid global-transaction-ID

Specifies the ID of the global transaction that is to be displayed.

-pending

Specifies that the command is to display information for any of the following types of unconcluded transactions that are being processed:

Preparing
Prepared
Committing
Rollingback
HeuristicCommit
HeuristicRollback
HeuristicMixed
HeuristicHazard

-time elapsed-time

Specifies an elapsed time (in seconds) since the transactions were started, as an integer in the range 0 to 2147483647. Information is displayed only for transactions whose elapsed time exceeds the amount of time specified in this option.

-bqual

Specifies that the command is to display all Xid branch IDs related to transactions.

-tp1

Displays the transaction global identifier and transaction branch identifier of OpenTP1 corresponding to the global transaction ID of Application Server.

If an OpenTP1-linked transaction exists, this argument adds and displays the transaction global identifier and transaction branch identifier of OpenTP1 in the output results.

If the transaction is not linked to OpenTP1, the transaction global identifier and transaction branch identifier of OpenTP1 are not displayed.

To Page Top

Input examples

cjlisttrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

To Page Top

Output format

When -tp1 is specified in the argument

[Global transaction information]
Status      GlobalTransactionId                   ElapsedTime BranchType   TP1TRNGID    TP1TRNBID
----------------- -------------------------------------------------------- ----------- -------------- ---------------- ----------------
transaction-status global-transaction-ID elapsed-time branch-type GID-of-OpenTP1 BID-of-OpenTP1
[branch-ID-list-of-Xid]
transaction-status global-transaction-ID elapsed-time branch-type GID-of-OpenTP1 BID-of-OpenTP1
[branch-ID-list-of-Xid]
...
 
total count number-of-displayed-entries

When -tp1 is not specified in the argument

[Global transaction information]
Status         GlobalTransactionID      ElapsedTime BranchType
----------------- -------------------------------------------------------- ----------- --------------
transaction-status global-transaction-ID elapsed-time branch-type
[branch-ID-list-of-Xid]
transaction-status global-transaction-ID elapsed-time branch-type
[branch-ID-list-of-Xid]
...
total count number-of-displayed-entries

transaction-status

Active: Active
MarkedRollback: Marked for rollback
Preparing: Undergoing preparation
Prepared: Waiting for a conclusion instruction from the Superior
Committing: Undergoing commit processing
RollingBack: Undergoing rollback processing
HeuristicCommit: Was committed forcibly
HeuristicRollback: Was rolled back forcibly
HeuristicMixed: Data consistency was lost because the transaction was partially committed or rolled back
HeuristicHazard: Not known whether the transaction was committed or rolled back
Invalid: Other internal inconsistency occurred

global-transaction-ID

ID of the target global transaction.

elapsed-time

Elapsed time since the transaction was started. However, if the transaction's branch-type is Top (recovered) or Sub (recovered), this item displays the elapsed time since recovery from the status file. If the transaction's branch-type is Xid (recovered), this item displays the elapsed time since the new transaction was created after Xid recovery.

branch-type

Top: Top root branch
Sub: Subordinate branch
Top(recovered): Top root branch recovered from status file
Sub(recovered): Subordinate branch recovered from status file
Xid(recovered): New branch that was created because the corresponding branch was not found after the Xid was recovered from the XAResource

branch-ID-list-of-Xid

List of all Xid branch IDs related to the transactions.

GID-of-OpenTP1

Displays the transaction global identifier of OpenTP1 corresponding to the global transaction ID of Application Server.

BID-of- OpentTP1

Displays the transaction branch identifier of OpenTP1 corresponding to the global transaction ID of Application Server.

number-of-displayed-entries

Number of displayed entries.

To Page Top

Return values

0:: The command terminated normally.
1:: The command terminated abnormally.
3:: A timeout occurred.
9:: The command could not be executed because there are no administrator privileges (in Windows).

To Page Top

Notes

When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify provider-URL -nameserver); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver global-transaction-ID -gid provider-URL).
When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).
If the -gid, -pending, and -time options are all specified concurrently, information is output only for transactions that satisfy all of the conditions.

To Page Top