Chapter Contents

Previous

Next
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

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.