TMF Application Programmer's Guide (H06.06+, J06.03+)

File System Procedures

HP NonStop TMF Application Programmer’s Guide—540139-009

4-59

TMF_SUSPEND_EXT_

This procedure allows the calling process to relinquish control of a transaction— the

current transaction of the calling process. Applications that use TMF_JOIN_EXT_ must

also use TMF_SUSPEND_EXT_.

If the calling process does not relinquish control of a joined transaction by issuing a

TMF_SUSPEND_EXT call, one of the following takes place when the process that

initiated the transaction calls ENDTRANSACTION:



If the calling process is on the beginner's node, a retry error

FEJOINOUTSTANDING will be returned.



If the calling process is on a remote node, the transaction will be aborted, and

FETRANSABORTED will be returned.

Semantically, TMF_SUSPEND_EXT_ is similar to TMF_SUSPEND_ and must be used

in conjunction with TMF_JOIN_EXT_ in applications where transactions can span

EXPAND nodes. TMF_SUSPEND_ or TMF_JOIN_ or TMF_RESUME_ work only

within an EXPAND node.

The suspended transaction is no longer the current transaction of the calling process

and the calling process is no longer allowed to call ENDTRANSACTION for the

transaction. The TFILE entry previously occupied by the suspended transaction is

vacated.

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_SUSPEND_EXT_ to modify the backup process' TFILE accordingly.

Note. This procedure cannot be called by TNS applications.

Syntax for C Programmers

Note. This procedure can be called from 32-bit and 64-bit applications.

Syntax for TNS/E Programmers

Syntax for pTAL Programmers

#include <cextdecs(TMF_SUSPEND_EXT_)>

short TMF_SUSPEND_EXT_ ( long long _ptr64 *exttransid );

status := TMF_SUSPEND_EXT_ ( exttransid ) ! o

CALLABLE, EXTENSIBLE;