STIMER

STIMER

Define a Timer Interval

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

`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.