GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-23
FAULT
•
USER^INIT^CONFIG^PARAMS
•
USER^INITIALIZE
•
USER^VERSION
During execution of these five exits, the monitor task, which handles the EMS
messages, has not been created.
If a task is to be restarted (noretn is equal to 1), TSCODE calls the USER^STOP exit,
with the suspended calling task as the current task. Then, if the auto^restart^flag of
the 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.
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