Reference Guide

ZCOM C I/F Library Routines
ZMAPR (3X)
Chapter 4 265
PAR AMETER S
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-zero error 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
zap ZCOM address to be mapped.
mzap ZCOM address to be mapped onto.
/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).