proevt( ) - Set Interval Timer

Sets an interval timer specified by a timer flag. The caller must test the timer flag to know whether the time interval has expired for the corresponding interval timer. The caller must not free the storage containing the flag until either the time interval has expired or procncel( ) has been called to cancel the specified interval timer. You can use proevt( ) to start an unlimited number of times:

Syntax

void
proevt ( seconds, pflag )
int seconds ;
char *pflag;

seconds

Specifies the duration (in seconds) to set the specified interval timer.

pflag

Points to a timer flag used to identify and monitor the specified interval timer. The caller must set *pflag to 0 before invoking proevt( ). When the time interval expires, proevt( ) sets *pflag to a non-zero value. You can test *pflag explicitly with your own code or implicitly using the prowait( ) function.

Note: This function applies only to UNIX systems. For more information on using HLC timer services, see HostLanguage Call Interface.