HP UX 11i v1 I/O Cards manual 244

ZCOM C I/F Library Routines

ZMAPR (3X)

PARAMETERS
	zap	ZCOM address to be mapped.
	mzap ZCOM address to be mapped onto.
NOTES	On a successful return from zmapr, accessing the source ZLU is actually
	directed to the destination ZLU. If the source ZLU was a program ZLU,
	all messages that were queued on it will be flushed (i.e., returned to the
	free queue). If it was a terminal ZLU, the linkage to the terminal is lost.
	Usually, this is not desirable because the previously associated terminal
	is unusable.
RETURN VALUE	Routine zmapr returns 0 if successful. Otherwise, a non-zeroerror code
	is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM
	error codes and their meanings.
EXAMPLE	#include		<zcom/zcomsys.h>
	#include		<zcom/zcomcall.h>
	int32		ierr;
	zaddr_type		zaddr;
	zaddr_type		maddr;

if (ierr = zmapr (&zaddr, &maddr)) { /* error return code */

}

else {

/* good return code */

}

FILES

/opt/acc/include/zcom/zcomsys.h	ZCOM subsystem general include file,
	containing data types, data structures,
	constants, error codes, masks, etc. Note that
	this must be the first include file before any
	other ZCOM include files.
/opt/acc/include/zcom/zcomcall.h	ZCOM routine function prototypes
	(requires ANSI C compilation).

244 Chapter 4