HP-UX

NAME

iintroff, iintron − will disable/reenable asynchronous handlers for a process. 

SYNOPSIS

#include <sicl.h>
int iintroff ();
 
int iintron ();

DESCRIPTION

A global asynchronous event is an event that can occur asynchronously to the normal sequential execution of a program.  In SICL, global asynchronous events occur when an SRQ occurs, or an enbabled interrupt condition occurs. 
 
iintroff disables all asynchronous handlers for all sessions in the current process. 

iintron reenables execution of all asynchronous handlers for all sessions in the current process.  Note that this routine would only need to be called after calling iintroff since asynchronous handlers are enabled by default. 
 
Neither of these routines affect the isetintr values or the handlers themselves in anyway. 
 
If an event occurs while asynchronous events are disabled, it is queued until events are reenabled.  Once asynchronous events are reenabled, the events are processed, in order, and the appropriate asynchronous handlers will be called before the iintron call completes. 
 
Calls to iintroff and iintron can be nested.  If iintroff is called twice, then iintron must be called twice before asynchronous events are reenabled. 
 
When a session is created, asynchronous events are enabled.  However, no asynchronous events are generated until the appropriate handlers are installed.
 

RETURN VALUE

The iintroff  and iintron routines return 0 if successful, or a non-zero value if an error is encountered. 
 

SEE ALSO

ionsrq(3), igetonsrq(3), ionintr(3), igetonintr(3), isetintr(3)

AUTHOR

iintroff, iintron were developed by HP. 

Hewlett-Packard Company  —  September 29, 1999