Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-147
SIGNALPROCESSTIMEOUT Procedure
specifies the time period, in 0.01-second units, after which a timeout message
should be queued on $RECEIVE. This value must be greater than 0D.
param1 input
INT:value
identifies the timeout message read from $RECEIVE.
param2 input
INT(32):value
identifies the timeout message read from $RECEIVE (same purpose as
param1).
tag output
INT:ref:1
returns an identifier associated with the timer. This
tag should be used only to call
the CANCELPROCESSTIMEOUT procedure.
Condition Code Settings
< (CCL) indicates that SIGNALPROCESSTIMEOUT is unable to allocate a time-list
element (TLE).
= (CCE) indicates that SIGNALPROCESSTIMEOUT is successful.
> (CCG) indicates that the given timeout value is illegal or that there is a bounds
error on
tag.
Considerations
•
SIGNALPROCESSTIMEOUT and CANCELPROCESSTIMEOUT
A process can use the SIGNALPROCESSTIMEOUT procedure with the
CANCELPROCESSTIMEOUT procedure to verify that some programmatic
operation finishes within a certain process execution time. The process calls
SIGNALPROCESSTIMEOUT before initiating the operation and then periodically
reads $RECEIVE to watch for timer expiration. The process calls
CANCELPROCESSTIMEOUT after completion of the timed operation if the
process has not been signaled on $RECEIVE.
•
Measuring the time that a process is executing
The SIGNALPROCESSTIMEOUT procedure measures the time that the process is
executing user code and system code. This procedure excludes the time spent by
the processor processing interrupts while the process is running.