cjcommittrn (Commit unconcluded transaction)
- Organization of this page
Format
cjcommittrn [server-name] [-nameserver provider-URL] -gid global-transaction-ID
Function
Specifies the unconcluded (Prepared) global transaction ID existing on a J2EE server and commits the transaction. Note that you can use this command when the TP1 inbound integration functionality is used.
If the specified global transaction ID exists, the command concludes the transaction.
If the specified global transaction ID is invalid, the command returns KFCB40122-E and the Usage (KFCB40130-E).
If the specified global transaction ID does not exist, the command returns KFCB40131-E; however, does not return the Usage.
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).
Arguments
- server-name
-
Specifies the name of the connected J2EE server. If the server name is omitted, the host name is used as the server name.
- -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 specified contents, see 2.1.2 Provider URL.
- -gid global-transaction-ID
-
Specifies the global transaction ID of the transaction to be committed.
Input examples
cjcommittrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001
Return values
- 0:
-
The command terminated normally.
- 1:
-
The command terminated abnormally.
- 3:
-
A timeout occurred.
- 9:
-
The command cannot be executed because there are no administrator privileges (in Windows).
Notes
-
When you specify a server name in the command arguments, you must specify that name 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 the 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 argument, you must specify a case-sensitive character string that matches the server name specified in the cjsetup (set up or unsetup J2EE server).
-
If an error occurs in one of the following locations, KFCB40137-E is returned and the transaction is not committed. Resolve the error based on the message contents, and then re-execute the command.
-
Resource manager
-
Communication path to the resource manager
-
Other J2EE servers
-
Communication path to the other J2EE servers
-