HP UX 11i v1 I/O Cards manual Name, Zeventrcvr

		ZCOM C I/F Library Routines
		ZEVENT_RCVR (3X)
		ZEVENT_RCVR (3X)
NAME		zevent_rcvr – Set up a program ZLU to receive ZCOM alarms and events
#includeSYNOPSIS	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int zevent_rcvr (rzap, action, eclass, einfop)

zaddr_type	*rzap;
int	action;
uint32	eclass;
Zclinfo_type	*einfop;

DESCRIPTION Routine zevent_rcvr is used to set up a program to receive ZCOM alarm and system event messages. When this routine is called, it causes the ZCOM subsystem to queue the indicated type(s) of events or alarms on the program queue specified by the rzap parameter. The event type is specified through the eclass parameter. The application program can read the event and/or alarm messages by issuing a zread call using the program ZLU specified in the rzap parameter. There is a limit on the number of programs that can request reception of each source of ZCOM event messages (e.g. status event of different target nodes are considered different sources). The limit is set to ZcMAX_SHARED_RCVRS, currently, 64.

If the action parameter is ZcDELETE, then the receiver linkage is deleted. That is, events and alarms of the indicated type (eclass) will no longer be delivered to that receiver ZLU.

The libraries libzcom_c.a and libpthread.a must be linked into the calling program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).

Chapter 4 209