GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-67
^RESUMETRANSACTION
Consideration
The ^REPLYX procedure differs from the Guardian counterpart in having a sixth input
parameter, iocb-tag. The procedure syntax is:
The message-tag parameter is for a message tag returned from ^RECEIVEINFO. The
tag associates this reply with a message previously received. When this parameter is
used, iocb-tag must not be used.
The iocb-tag parameter is declared as an INT(32):value. When used, this parameter
holds the address of the IOCB returned when ^SIGNALTIMEOUT or
^SIGNALINTERRUPT was called. When this parameter is used, message-tag must
not be used.
^RESUMETRANSACTION
This procedure suspends or activates the processing of a TMF transaction. For
example, when TSCODE deactivates a user task that has started a TMF transaction, it
calls ^RESUMETRANSACTION with trans-begin-tag set to 0D to suspend the user
task’s transaction. Before activating the user task, TSCODE calls
^RESUMETRANSACTION with trans-begin-tag set to the transid of the transaction to
give the TMF transaction an active status.
A user task can call ^RESUMETRANSACTION too, but it must own the current
transaction. It is the responsibility of the user task to return the suspended transaction
to active status by calling ^RESUMETRANSACTION with trans-begin-tag set to the
transid of the transaction. The transid of the transaction is stored in the variable
transtag of tcb^template.
A trace record is written after a successful call to ^RESUMETRANSACTION if bit 3 of
trace^control^flags in DCCBDECS is set to 1. The trace records contain the calling
task number of the user task and the TMF transaction identifier of the transaction to
become the current transaction. See Tracing GDSX on page 2-80 for more
information.
Except for the following consideration, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the
NonStop TMF Application Programmer’s Guide.
CALL ^REPLYX ( [ buffer ]
,[ write-count ]
,[ count-written ]
,[ message-tag ]
,[ error-return ]
,[ iocb-tag ] );