# PXFALARM

POSIX Subroutine: Schedules an alarm.

## Module

USE IFPOSIX

CALL PXFALARM (iseconds,isecleft,ierror)

iseconds | (Input) INTEGER(4). The number of seconds before the alarm signal should be delivered.
isecleft | (Output) INTEGER(4). The number of seconds remaining until any previously scheduled alarm signal is due to be delivered. It is set to zero if there was no previously scheduled alarm signal.
ierror | (Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFALARM subroutine arranges for a SIGALRM signal to be delivered to the process in seconds iseconds.

On Linux* and macOS systems, SIGALRM is a reserved defined constant that is equal to 14. You can use any other routine to install the signal handler. You can get SIGALRM and other signal values by using PXFCONST or IPXFCONST.

On Windows* systems, the SIGALRM feature is not supported, but the POSIX library has an implementation you can use. You can provide a signal handler for SIGALRM by using PXFSIGACTION.

Parent topic: POSIX* Library Routines

## See Also

PXFCONST
IPXFCONST
PXFSIGACTION