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:
- Value of the ejbserver.server.j2ee.feature key is 1.4
- Value of the ejbserver.distributedtx.XATransaction.enabled key is true
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
- This command cannot be executed for a J2EE server located on another host.
- If this command is executed while the J2EE server is running and processing a transaction, the validity of the displayed contents is not guaranteed. You should always execute this command while the J2EE server is stopped. If the J2EE server is started while this command is executing, initialization of the in-process transaction service may fail.
- 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 global-transaction-ID -gid); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -gid -bqual global-transaction-ID).
- 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).