HP Advanced Communications Controllers (ACC) manual Zmapr

Models: Advanced Communications Controllers (ACC)

1 328
Download 328 pages 30.05 Kb
Page 265
Image 265

 

 

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).

Chapter 4

265

Page 265
Image 265
HP Advanced Communications Controllers (ACC) manual Zmapr