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

File System Procedures

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

4-27

TMF_GET_TX_ID_

This procedure extracts a transactional identifier from a transaction handle. The

identifier is only valid within the lifetime of the calling process or until TMF is either shut

down or crashes. The returned identifier can be used in calls to TMF_RESUME_ to

specify the transaction to be resumed by the process. The same transactional

identifier is returned by TMF_SUSPEND_.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

status returned value

INT

is a file system error number:

For a list of all possible file system error numbers, refer to the Operator Messages

Manual.

tx-handle input

INT .EXT:ref:10

specifies the transaction handle associated with the transaction whose

transactional identifier is to be returned.

#include <cextdecs(TMF_GET_TX_ID_)>

short TMF_GET_TX_ID_ ( short _far *tx-handle ,

long long _far *txid );

status := TMF_GET_TX_ID_ ( tx-handle , ! i

txid ) ! o

CALLABLE, EXTENSIBLE;

0 Successful completion.

22 Bounds error.

29 Missing parameter(s).

78 Transaction no longer valid.

82 TMF not running.

84 TMF not configured.

715 Invalid transaction handle.