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

File System Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
4-18
RESUMETRANSACTION
RESUMETRANSACTION
This procedure sets the current transaction of the calling process either to the nil state
or to the transaction identifier of the specified transaction. You identify the desired
transaction by supplying the trans-begin-tag returned by a previous call to
BEGINTRANSACTION.
RESUMETRANSACTION makes it possible for you to write multithreaded requesters
that can process two or more transactions at the same time: the requester can only
work on one transaction at a time. By using RESUMETRANSACTION to manipulate
the current transaction, however, the requester can switch from one active transaction
to another.
To use RESUMETRANSACTION, your program must include trans-begin-tag in
all BEGINTRANSACTION calls and must remember which tag applies to which active
transaction.
If RESUMETRANSACTION returns an error, this is an indication that future attempts to
use the transaction for updates to the database will result in an error. The requester
(or its backup) that initiated the transaction must still explicitly terminate the transaction
by calling either ENDTRASACTION or ABORTTRANSACTION. The final outcome of
the transaction will be indicated by the result of one of the calls.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
is a file system error number:
#include <cextdecs(RESUMETRANSACTION)>
short RESUMETRANSACTION ( long trans-begin-tag );
status := RESUMETRANSACTION (
trans-begin-tag ); ! i
0 Successful completion.
76 Transaction ending or aborting.
78 Invalid or obsolete transaction identifier.
82 TMF not running.
84 TMF not configured.