Chapter Contents |
Previous |
Next |
STIMER |
Portability: | SAS/C extension |
SYNOPSIS | |
DESCRIPTION | |
CAUTIONS | |
RELATED FUNCTIONS |
SYNOPSIS |
#include <spetask.h> void STIMER(type, void *exit, unit, void *intvl);
DESCRIPTION |
The SAS/C
STIMER
macro implements the functionality of the OS/390 Assembler STIMER
macro. This macro is supported only with the Systems Programming Environment
(SPE).
type
|
specifies the type of timer interval
and must be either
TASK
,
WAIT
or
REAL
. |
exit
|
specifies the address of code to
be called as a timer exit when the interval is complete. An exit address
of
0
means that no exit
is to be called. The
exit
argument should ordinarily be specified as a call to the
bldexit
function, whose first argument is the
address of the C function which is to be defined as the exit. |
unit
|
specifies the units of the timer
interval and must be either
TUINTVL
,
BINTVL
,
MICVL
,
DINTVL
,
GMT
or
TOD
. |
intvl
|
is a pointer to an area specifying the time interval or time of expiration. The size and interpretation of this data depends on the unit, as described in Application Development Reference: Services for Assembler Language Programs available from IBM. |
CAUTIONS |
Use of the SAS/C
STIMER
macro in code that uses the full run-time
library will interfere with library timer handling. Additionally, the
bldexit
function cannot be used
with the full run-time library.
Similar functionality to
STIMER
can be obtained with the full library using the functions
alarm
,
sleep
, or
clock
.
RELATED FUNCTIONS |
TTIMER
,
STIMERM
,
alarm
,
clock
,
sleep
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.