TRANSABORT

Aborts the current transaction and rolls back any updates to the database performed by the transaction.

Command Class

TCL-I command.

Syntax

TRANSABORT {transaction-information}

Syntax Elements

transaction-information
Text describing the current local transaction. This is written to the transaction-abort item.

This information makes it easier to identify the transaction or iteration of a transaction when examining the TL-ERRORS, TL-REJECT or clean log files in a Transaction Logging database.

If no text is supplied, the system uses the file name and item-id containing the program performing the transaction along with the time and date.

Comments

Reversal of updates inside a transaction is called roll-back. This is executed by restoring the 'Before' image of all updates inside the aborted transaction (held in the raw log) onto the database. The database is therefore 'rolled back' to its pre-transaction state. All other ports on the database remain active while the roll-back process is carried out.

Within a transaction, the release of Item locks is deferred until successful execution of TRANSABORT or TRANSEND.

Text is only written to the clean log if there is something in the transaction. So if you do TRANSEND then TRANSABORT with nothing between, the TRANSEND/TRANSABORT is not written to the log.