OpenTP1 Version 7 Operation
trnrbk (Roll back transactions)
Format
Trnrbk {-t [-af]|-T transaction-global-identifier [-af]} |
Function
When the information displayed by the trnls command indicates READY(p,n) status, the trnrbk command rolls back a transaction branch forcibly, notifies the other transaction branches, and then terminates the transactions. This command should be entered when a root transaction branch is to be rolled back.
The trnrbk command is entered when no transaction branch constituting a global transaction is able to determine the transaction for some reason (communication error, etc.). All the transaction branches in the global transaction must be rolled back in order to avoid inconsistency with other transactions. If a communication error has occurred, the transaction cannot be terminated until communication among its transaction branches has been completed. When the -f option is specified, the transaction is terminated forcibly. If the communication error is temporary, it is better to execute the trnrbk command without specifying the -f option.
Options
-t
Specifies that all transactions on READY(p,n) status that are managed by the transaction manager on the corresponding computer are to be rolled back. Information about the transactions to be rolled back will be output to the standard output.
-T transaction-global-identifier~<16 alphanumeric characters>
Specifies the transaction global identifier that is to be rolled back, but only if it is on READY(p,n) status. Information about the transaction to be rolled back will be output to the standard output.
The global transaction identifier can be obtained by the trnls -t command.
-a
Specifies that information about the transactions is to be output to the standard output.
When this option is omitted, only the OpenTP1 system node ID through the service name will be output to the standard output.
-f
Specifies that the transactions are to be terminated forcibly.
When this option is omitted, the transactions are not terminated forcibly.
Output format
When the -a option is specified, the output format is the same as output format (1) for the trnls command; otherwise, it is the same as output format (5) for the trnls command.
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA00970-E | Processing error occurred during trnrbk command execution. | Standard error output |
KFCA00977-I | Help message | Standard output |
KFCA00978-E | Usage of trnrbk command is invalid. | Standard error output |
KFCA00979-E | trnrbk command execution environment has not been set up. | Standard error output |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.