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

File System Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
4-5
ACTIVATERECEIVETRANSID
ACTIVATERECEIVETRANSID
Servers use this procedure to set their current transaction to the transaction identifier
of a particular work request queued in $RECEIVE. In the call, you supply a message
tag that you initially obtained by calling the LASTRECEIVE procedure immediately
after the READUPDATE call that accepted the message.
A multithreaded server uses ACTIVATERECEIVETRANSID either to resume
processing for a particular transaction or to properly set the current transaction before
replying to a requester. A single-threaded server uses ACTIVATERECEIVETRANSID
to reset the current transaction from the nil state to the transaction identifier of the
currently active transaction.
Syntax for C Programmers
Note. This procedure can be called from 32-bit and 64-bit applications.
Syntax for TAL Programmers
Parameters
message-tag input
INT:value
is returned by LASTRECEIVE, identifying a particular work request queued in
$RECEIVE. message-tag must be an integer between 0 and
(receive-depth - 1), inclusive, that is currently associated with a work request
queued in $RECEIVE.
ACTIVATERECEIVETRANSID returns a condition code only. For more information
about error conditions, call the FILEINFO procedure specifying the filenumber of
$RECEIVE.
The condition codes have the following meanings:
#include <cextdecs(ACTIVATERECEIVETRANSID)>
_cc_status ACTIVATERECEIVETRANSID ( short message-tag );
CALL ACTIVATERECEIVETRANSID ( message-tag ); !i
<< (CCL) indicates that an error occurred (call FILEINFO).
= (CCE) indicates successful completion.
>> (CCG) indicates that $RECEIVE was not opened with a receive-depth
equal to or greater than 1.