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 IDDescriptionOutput destination
KFCA32029-EProcessing could not continue due to insufficient memory.Standard error output
KFCA32103-EInvalid usage of the xarforce command.Standard error output
KFCA32123-EProcessing could not execute because shared memory was unavailable.Standard error output
KFCA32124-EV/R of the XA resource service is invalid.Standard error output
KFCA32126-EXA resource service is shut down.Standard error output
KFCA32127-ETimeout occurred during an RPC.Standard error output
KFCA32128-ENetwork error occurred during an RPC.Standard error output
KFCA32130-IHelp messageStandard output
KFCA32133-EThere is no transaction with the specified transaction ID.Standard error output
KFCA32134-EThere is no transaction with the specified entry number.Standard error output
KFCA32135-EThe status of the transaction specified by the transaction ID could not be changed.Standard error output
KFCA32136-EThe status of the transaction specified by the entry number could not be changed.Standard error output
KFCA32137-IThe transaction corresponding to the transaction ID was committed.Standard output
KFCA32138-IThe transaction corresponding to the transaction ID was rolled back.Standard output
KFCA32139-IThe transaction corresponding to the transaction ID was invalidated.Standard output
KFCA32140-IThe transaction corresponding to the entry number was committed.Standard output
KFCA32141-IThe transaction corresponding to the entry number was rolled back.Standard output
KFCA32142-IThe transaction corresponding to the entry number was invalidated.Standard output
KFCA32143-EThe XA resource server is inactive.Standard error output
KFCA32144-EThe OpenTP1 system is inactive.Standard error output
KFCA32156-EAn 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.

OptionTransaction Status
AIPRH
-cNNYNN
-rNNYNN
-fNNNNY
Legend:
A: Active
I: Idle
P: Prepared
R: Rollback only
H: Heuristically completed
Y: Can be specified
N: Cannot be specified