Guardian Procedure Calls Reference Manual

param2
input
INT(64):value
is part of the timeout message read from $RECEIVE.
TLEid
output
INT(32) .EXT:ref:1
is the identifier associated with the timer. TLEid should only be used to call the TIMER_STOP_
procedure.
Returned Value
INT(32)
Outcome of the call:
The call is successful and the time has been started.0
The parameter values are invalid or inconsistent.590
TIMER_START_ cannot allocate a TLE. This error occurs when all available TLEs are used.3600
Considerations
• The message is delivered at least timeoutValue microseconds after the call. The actual
interval is somewhat longer than the specified value, because:
◦ The specified timeoutValue is rounded up to the resolution of the operating system
interval timing mechanism, which is approximately 2 milliseconds.
◦ Once the interval timer has elapsed, there is variable latency to process the timer interrupt
and schedule the process by priority.
• param1 is delivered to the user process in the SIGNAL TIMEOUT message as an INT(16); it
is truncated. param2 is delivered in the SIGNALTIMEOUT message as an INT(32); it is also
truncated.
Example
The following example sets a 60 second timer:
INT(32) TLEID;
ERR := TIMER_START_(60000000F, 10F, 32F, TLEID);
IF ERR THEN -- Timer was not started
1422 Guardian Procedure Calls (T-V)