TMF Application Programmer's Guide (G06.26+)

File System Procedures

HP NonStop TMF Application Programmer’s Guide—522419-005

4-2

ABORTTRANSACTION

This procedure aborts the current transaction (the transaction identified by the calling

process’ current transaction identifier). Any application process that is working on a

transaction can abort that transaction at any time for any reason.

If a server process aborts a transaction, the requester (or its backup) that initiated the

transaction must still explicitly terminate the transaction by calling either

ENDTRANSACTION or ABORTTRANSACTION.

When ABORTTRANSACTION returns control to the calling process, the aborted

transaction has not yet been backed out, but the transaction’s state has changed from

active to aborting. Later, the TMF backout process will back out the transaction by

restoring the transaction’s before-images to all affected disk files. When backout is

complete, all locks held for the aborted transaction are released.

If the transaction is restarted under a new transaction identifier, the new transaction

cannot access any records locked by the aborted transaction until transaction backout

is completed for the aborted transaction and the locks held by the aborted transaction

are released.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

status returned value

INT

is a file system error number:

#include <cextdecs(ABORTTRANSACTION)>

short ABORTTRANSACTION();

status := ABORTTRANSACTION;

0 Successful completion.

30 System unable to obtain message block, or is already using its

maximum number of RECEIVE or SEND message blocks.

75 Current transaction in nil state.

76 The requester called ABORTTRANSACTION while the transaction was

already in the process of ending (the transaction therefore cannot be

aborted or resumed).