Guardian Procedure Calls Reference Manual

SIGNALTIMEOUT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
OSS Considerations
Messages
Example
Related Programming Manual
Summary
The SIGNALTIMEOUT 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.
Syntax for C Programmers
#include <cextdecs(SIGNALTIMEOUT)>
_cc_status SIGNALTIMEOUT ( __int32_t time-out-value
,[ short param1 ]
,[ __int32_t param2 ]
,[ short _near *tag ] );
• 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.
• The function value returned by SIGNALTIMEOUT, which indicates the condition code, can be
interpreted by the _status_lt(), _status_eq(), or _status_gt() function (defined
in the file tal.h).
Syntax for TAL Programmers
CALL SIGNALTIMEOUT ( timeout-value ! i
,[ param1 ] ! i
,[ param2 ] ! i
,[ tag ] ); ! o
Parameters
timeout-value
input
INT(32):value
specifies the time period, in 0.01-second units, after which a timeout message is queued on
$RECEIVE. This value must be greater than 0D.
1380 Guardian Procedure Calls (S)