Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-9
TIMER_START_ Procedure (H-Series RVUs Only)
TIMER_START_ Procedure (H-Series RVUs
Only)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
The TIMER_START_ procedure sets a timer to a given number of units of elapsed
time, as measured by the processor clock. When the time expires, the calling process
receives an indication in the form of a system message on $RECEIVE.
TIMER_START_ measures the timeout value in microseconds. The process that calls
this procedure becomes the owner of the underlying Time List element (TLE).
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
error return value
INT32
indicates the outcome of the call:
error=TIMER_START_(timeoutValue, param1, param2, TLEid)
INT(32) TIMER_START_ (TOV, PARAM1, PARAM2, TLEID)
CALLABLE, RESIDENT;
EXTERNAL;
Value Definition
0 Indicates the call is successful and the time has
been started
590 Indicates the parameter values are invalid or
inconsistent
3600 Indicates that TIMER_START_cannot allocate a
TLE. This occurs when all available TLEs are
used.