PXFSIGSUSPEND(3F)				      Last changed: 2-26-98

NAME    [Toc]    [Back]

     PXFSIGSUSPEND - Waits for a signal

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	PXFSIGSUSPEND (jsigset,	ierror)
     INTEGER jsigset, ierror

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     IEEE standard interface for FORTRAN 77

DESCRIPTION    [Toc]    [Back]

     The PXFSIGSUSPEND subroutine uses sigsuspend(2) to	replace	the signal
     mask of the process with the specified jsigset set	and then suspend
     the process until delivery	of a signal whose action is either to
     execute a signal-catching function	or to terminate	the process.  The
     following is a list of valid arguments for	this routine:

     jsigset   A default integer input variable	containing a handle created
	       by PXFSTRUCTCREATE(sigset,...).

     ierrno    A default integer output	variable that contains zero if
	       PXFSIGSUSPEND was successful and	nonzero	if PXFSIGSUSPEND
	       was not successful.

     PXFSIGSUSPEND always returns an error if control is returned.  Any	of
     the following error values	may also be returned:

     EINTR	    The	signal is caught by the	calling	process	and control
		    is returned	from the signal-catching function.

     EBADHANDLE	    The	jsigset	argument is invalid.

     On	IRIX systems, this routine is in libfortran.so which is	linked by
     default when compiling programs with the MIPSpro 7	Fortran	90 compiler
     or	when compiling programs	with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     When using	the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk,	or IRIX	systems, all arguments must be of default
     kind unless documented otherwise. On UNICOS and UNICOS/mk,	default
     kind is KIND=8 for	integer, real, complex,	and logical arguments; on
     IRIX systems, the default kind is KIND=4.

NOTES    [Toc]    [Back]

     Replace any Fortran reference to sigsuspend() with	a subroutine call
     to	PXFSIGSUSPEND.

SEE ALSO    [Toc]    [Back]

     sigsuspend(2)
     PXFSTRUCTCREATE(3F)

     Application Programmer's Library Reference	Manual,	publication
     SR-2165, for the printed version of this man page.