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

File System Procedures

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

4-36

TMF_TXBEGIN_

This procedure is the same as BEGINTRANSACTION except that it includes a new

parameter to specify a timeout value.

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.

#include <cextdecs(TMF_TXBEGIN_)>

short TMF_TXBEGIN_ ( [ long timeout ] ,

[ long _near *trans-begin-tag ] );

status := TMF_TXBEGIN_ ( [ timeout ] ! i

[ , trans-begin-tag ] ) ! o

CALLABLE, RESIDENT, EXTENSIBLE;

0 Successful completion.

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

maximum number of RECEIVE or SEND message blocks.

82 TMF not running.

83 Too many transactions (a single-threaded requester tried to initiate a

transaction while it still had one in progress, or a multithreaded

requester attempted to initiate more concurrent transactions than there

were TFILE entries).

84 TMF not configured.

86 Audit trail at begin-trans-disable threshold, or operator has disabled the

BEGINTRANSACTION procedure.

98 TFILE was opend using a nonzero sync-depth and all transaction

control blocks (TCBs) within the caller’s CPU are currently occupied.