Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

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