OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

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

Legend:
A: Active
I: Idle
P: Prepared
R: Rollback only
H: Heuristically completed
Y: Can be specified
N: Cannot be specified