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

File System Procedures

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

4-31

TMF_RESUME_

This procedure allows a process to resume a previously suspended transaction.

Resuming a transaction means:

1. Making the transaction the current transaction

2. Taking over as the ENDTRANSACTION caller for the transaction

After successfully resuming a transaction, the calling process can then issue an

ENDTRANSACTION call. The process that suspended the transaction and the one

that resumes it need not reside in the same CPU, but they must reside in the same

EXPAND node. Only one process will succeed in resuming a previously suspended

transaction.

The transaction identifier passed to this procedure is the one returned by

TMF_SUSPEND_; it can also, however, be obtained by calling TMF_GET_TX_ID_.

This procedure cannot be used for transactions that were begun on a different

EXPAND node.

Resuming a transaction uses one of the entries in the calling process’ TFILE. If the

process has not explicitly opened the TFILE, the resumed transaction uses the one

TFILE entry that exists for all processes. If there are no available TFILE entries when

the call to TMF_RESUME_ is issued, the call is rejected with file system error 83 (too

many transactions).

If the calling process is the primary process of a NonStop process pair and the TFILE

is being checkpointed, the calling process should checkpoint the TFILE after calling

TMF_RESUME_ to modify the backup process’ TFILE accordingly.

Syntax for C Programmers

Syntax for TAL Programmers

#include <cextdecs(TMF_RESUME_)>

short TMF_RESUME_ ( long long txid );

status := TMF_RESUME_ ( txid ) ! i

CALLABLE, EXTENSIBLE;