cjrollbacktrn (Roll back unconcluded transactions)

Format

cjrollbacktrn [server-name] [-nameserver provider-URL]
      -gid global-transaction-ID

To Page Top

Function

Specifies an unconcluded (Prepared) global transaction ID existing on the J2EE server and rolls back 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 Usage (KFCB40133-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).

To Page Top

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, 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 rolled back.

To Page Top

Input examples

cjrollbacktrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

To Page Top

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).

To Page Top

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 rolled back. 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

To Page Top