OpenTP1 Version 7 Operation
xarforce (Change the status of an XAR transaction)
Format
xarforce {-c|-r|-f} {-t OpenTP1-transaction-ID | -u client-transaction-ID | -n entry-number} |
Function
The xarforce command changes the status of the transaction corresponding to a specific OpenTP1 transaction ID, client transaction ID, or entry number.
Options
-c
Changes the status of a transaction managed by the XA resource service to Heuristic Commit. With this option, you can only change the status of a transaction in prepared state, as displayed by the xarls command.
-r
Changes the status of a transaction managed by the XA resource service to Heuristic Rollback. With this option, you can only change the status of a transaction in prepared state, as displayed by the xarls command.
-f
Invalidates a transaction managed by the XA resource service. With this option, you can only invalidate a transaction whose status as displayed by the xarls command is heuristic hazard, heuristic commit, heuristic rollback, or heuristic mix.
-t OpenTP1-transaction-ID~<80 character hexadecimal>
Specifies the ID of the OpenTP1 transaction whose status is to be changed. Specify the OpenTP1 transaction ID as displayed by the xarls command with the -a or -p option specified.
-u client-transaction-ID~<280 character hexadecimal>
Specifies the client transaction ID of the transaction whose status is to be changed. Specify the ID as displayed by the xarls command with the -a or -p option specified.
-n entry-number~<decimal between 1 and 8192>
Specifies the entry number of the transaction whose status is to be changed. Specify the entry number as displayed by the xarls command with the -a or -p option specified.
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA32029-E | Processing could not continue due to insufficient memory. | Standard error output |
KFCA32103-E | Invalid usage of the xarforce command. | Standard error output |
KFCA32123-E | Processing could not execute because shared memory was unavailable. | Standard error output |
KFCA32124-E | V/R of the XA resource service is invalid. | Standard error output |
KFCA32126-E | XA resource service is shut down. | Standard error output |
KFCA32127-E | Timeout occurred during an RPC. | Standard error output |
KFCA32128-E | Network error occurred during an RPC. | Standard error output |
KFCA32130-I | Help message | Standard output |
KFCA32133-E | There is no transaction with the specified transaction ID. | Standard error output |
KFCA32134-E | There is no transaction with the specified entry number. | Standard error output |
KFCA32135-E | The status of the transaction specified by the transaction ID could not be changed. | Standard error output |
KFCA32136-E | The status of the transaction specified by the entry number could not be changed. | Standard error output |
KFCA32137-I | The transaction corresponding to the transaction ID was committed. | Standard output |
KFCA32138-I | The transaction corresponding to the transaction ID was rolled back. | Standard output |
KFCA32139-I | The transaction corresponding to the transaction ID was invalidated. | Standard output |
KFCA32140-I | The transaction corresponding to the entry number was committed. | Standard output |
KFCA32141-I | The transaction corresponding to the entry number was rolled back. | Standard output |
KFCA32142-I | The transaction corresponding to the entry number was invalidated. | Standard output |
KFCA32143-E | The XA resource server is inactive. | Standard error output |
KFCA32144-E | The OpenTP1 system is inactive. | Standard error output |
KFCA32156-E | An error was detected during execution of the xarforce command. | Standard error output |
Notes
The following table shows the relationships between the command options and transaction status.
Option | Transaction Status | ||||
---|---|---|---|---|---|
A | I | P | R | H | |
-c | N | N | Y | N | N |
-r | N | N | Y | N | N |
-f | N | N | N | N | Y |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.