cjlisttrnfile (display transaction information for stopped J2EE server)

Format

cjlisttrnfile [server-name] [-gid global-transaction-ID]
      [-bqual]

Function

This command displays a listing of transaction statuses from the status file generated in a stopped J2EE server. The command can be applied only to a J2EE server on the host at which the command is executed.

This command can be executed when the following settings are in effect in usrconf.properties (user properties file for the J2EE server) and the J2EE server is operating:

Arguments

server-name
Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.
The target status file is determined from the status file directory information that has been set for the specified server. Status file directory information refers to the following property value settings in usrconf.properties (user properties file for the J2EE server):
  • ejbserver.distributedtx.ots.status.directory1
  • ejbserver.distributedtx.ots.status.directory2
-gid global-transaction-ID
Specifies the global transaction ID of the transactions that are to be displayed.
-bqual
Specifies that the command is to display all Xid branch IDs related to the transactions.

Input examples

cjlisttrnfile MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

Output format

[Global transaction information(status file)]
status file1: status-file-name
[status file2: status-file-name]
host    (recorded in status file): "host-name"
J2EE server(recorded in status file): "server-name"
Status          GlobalTransactionId      BranchType
------------------------ ------------------------------ ----------------
transaction-status global-transaction-ID branch-type
[branch-ID-list-of-Xid]
transaction-status global-transaction-ID branch-type
[branch-ID-list-of-Xid]
...
Total count: number-of-displayed-entries

status-file-name
Name of the status file to be displayed by this command.
host-name
Host name or IP address for which the above status file was generated (host name or IP address written to the status file).
server-name
Name of the J2EE server for which the above status file was generated (J2EE server name written to the status file).
global-transaction-ID
ID of the target global transaction.
transaction-status
  • Prepared: Waiting for a conclusion instruction from the Superior
  • Committing: Undergoing commit 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
branch-type
  • Top: Top root branch
  • Sub: Subordinate branch
branch-ID-list-of-Xid
List of all Xid branch IDs related to the transactions.
number-of-displayed-entries
Number of displayed entries.

Return values

0:
The command terminated normally (there is no transaction).
1:
The command terminated abnormally.
6:
The warning ended (a transaction exists).
7:
The warning ended (it is not known whether a transaction exists).
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