GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-22
^ENDTRANSACTION
indicates the outcome of the call. The value of status is one of the following:
Considerations
•
DO^CP causes the calling task to be suspended.
•
If GDSX is run as a process pair, TSCODE automatically calls DO^CP upon the
return from the USER^BACKUP user exit so that the primary and backup
processes are synchronized at startup.
Examples
•
For an example of user global checkpointing by DO^CP, see the description of
Q^CP[X] on page 8-57.
•
See the description of the USER^BACKUP on page 9-10 for an example showing
how user global checkpointing can be done when a GDSX process pair is
initialized.
^ENDTRANSACTION
This procedure completes a TMF transaction initiated by ^BEGINTRANSACTION.
You do not need to complete the call to ^ENDTRANSACTION with a call to ^AWAITIO
or ^AWAITIOX in a user task. See Appendix D, Using Pseudo Procedures in a TS/MP
Environment for an example of using this procedure.
A trace record is written after a successful call to ^ENDTRANSACTION 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. See Tracing GDSX on
page 2-80 for more information.
The syntax, condition code settings, and considerations regarding this procedure are
the same as the counterpart in the NonStop TMF Application Programmer’s Guide.
FAULT
When a situation is detected programmatically that requires investigation, USCODE
may call FAULT and pass a fault number that is reported in an EMS message.
TSCODE stores the fault number in tcb.fault.
If a task is not to be restarted (noretn parameter equal to 0), control is returned to the
calling user exit or task. FAULT can be called with the noretn parameter equal to 0
from any user exit or task except the first five exits that can be called by TSCODE:
•
PROCESS^ASSIGNS
•
PROCESS^USER^PARAMS
0 The checkpoint failed
1 The data queued in checkpoint buffer was successfully checkpointed to the
backup process