Function

alarm invokes the alarm callable service to generate a SIGALRM signal after the number of seconds specified have elapsed.

Parameters

seconds

The number of seconds to pass between receipt of this request and generation of the SIGALRM signal.

Usage notes

1. The default action for an alarm signal is to end a process.
2. The alarm callable service is always successful, and no return value is reserved to indicate an error.
3. An abend is generated when failures are encountered that prevent the alarm callable service from completing successfully.
4. Alarm requests are not stacked; only one SIGALRM can be scheduled to be generated at a time. If the previous alarm time did not expire and a new alarm is scheduled, the most recent alarm reschedules the time that SIGALRM is generated.
5. See Using the REXX signal services for additional information on using signals.