cjlisttrn (display information about transactions operating in J2EE server)

Format

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

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 when the following settings are in effect in usrconf.properties (user properties file for the J2EE server):

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.

Input examples

cjlisttrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

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.

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 Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista).

Notes