Guardian Procedure Calls Reference Manual

TIMER_START_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
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).
NOTE: The TIMER_START_ procedure is supported only in H-series and J-series RVUs.
Syntax for C Programmers
#include <cextdecs(TIMER_START_)>
__int32_t TIMER_START_ ( long long timeoutValue
,long long param1
,long long param2
,__int32_t _far *TLEid );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := TIMER_START_ ( timeoutValue ! i
, param1 ! i
, param2 ! i
, TLEid ); ! o
Parameters
timeoutValue
input
INT(64):value
is a value greater than zero that specifies the time period (in microseconds) after which a
timeout message is queued on $RECEIVE. One second equals 1,000,000 microseconds.
param1
input
INT(64):value
is part of the timeout message read from $RECEIVE.
TIMER_START_ Procedure 1421