GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-23
FAULT
CONTROLGLAGS configuration parameter is set, TSCODE restarts the task from the
beginning after a time delay given by the RESTARTTIME configuration parameter.
Using the SCF STATUS command for a task calling FAULT shows an error condition.
Other tasks continue to run normally.
fault-number input
INT:value
is a user-supplied fault number, which must be greater than 100. Fault numbers
1-100 are reserved for system use. See “Fault Messages” on page 3-26 for more
information.
noretn input
INT:value
indicates whether the calling user exit or task should be restarted after the fault is
posted. Restarting a task means the task is stopped and started by TSCODE.
The value of noretn is one of the following:
FAULT can be called with the noretn parameter equal to 0 from any user exit or
task.
tcb input
INT .EXT:ref
is a pointer containing the calling task’s TCB address.
Caution. FAULT may be called with noretn equal to 1 only from the DEVICE^HANDLER and
LINE^HANDLER user exits, because only within these exits is a user task executing.
Caution. Before calling FAULT with noretn equal to 1, a task must release all semaphores
that it holds.
CALL FAULT ( fault-number !
i
,[ noretn ] !
i
,[ tcb ] !
i
,[ p-reg ] !
i
,[ e-reg ] ); !
i
0 The user exit or task is not to be restarted. Control is given back to the calling
process. This is the default.
1 The user exit or task is to be restarted.