GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-76
^SIGNALINTERRUPT
•
You can still issue an SCF INFO TASK command on a LINE or SU to determine its
tcb.state.<1> value after ^SHUTDOWN is called. If this bit is set to 1, the task is in
the stop-pending state, meaning that it will die after all its openers are closed. Once
all the openers are closed or terminated, the primary and backup GDSX processes
are stopped.
•
A call to ^SHUTDOWN is the same as issuing the following SCF STOP command:
STOP PROCESS $GDSX-process-name
•
A call to ^TERMINATE is the same as issuing the SCF STOP command with an
exclamation point:
STOP PROCESS $GDSX-process-name !
^SIGNALINTERRUPT
The ^SIGNALINTERRUPT entry point for the ^SIGNALTIMEOUT procedure sets a
timer to a given number of units of elapsed time. When the time expires, the calling task
receives an indication in the form of a system message on $RECEIVE in the case of a
DEVICE^HANDLER task or on $RECEIVE in the case of a LINE^HANDLER task.
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as the SIGNALTIMEOUT
procedure in the Guardian Procedure Calls Reference Manual.
Considerations
•
Because the working stack images of tasks are swapped to and from an extended
data segment during I/O operations, I/O must be performed to and from global
buffers.
•
The tag parameter of ^SIGNALINTERRUPT holds the address of the IOCB
allocated when ^SIGNALTIMEOUT or ^SIGNALINTERRUPT was called. It is an
INT(32) variable.
•
^SIGNALINTERRUPT sets CCL if an IOCB cannot be allocated.
•
The entry point ^SIGNALINTERRUPT within ^SIGNALTIMEOUT modifies
^SIGNALTIMEOUT’s typical handling of the resultant system message. Suppose
that a signal initiated by ^SIGNALINTERRUPT pops. When the -22 system
message is queued for the task and the task is currently in a timed wait condition
(timeout-value is not equal to -1D), and waiting for some resource (such as buffer
space or an IOCB), the task is prematurely removed from the timed-wait list and
dispatched.