ZCOM C I/F Library Routines

ZINFO (3X)

NOTES

The returned logical terminal table (mode = ZcLTT_TBL) consists of the

 

basic table and the logical terminal table extension (the extension size is

 

configurable in the TTGEN configuration file). The size of this buffer

 

should be large enough to hold the required information.

 

ATTENTION

 

Note that this call returns the contents of the internal tables used to

 

implement the ZCOM subsystem. As such, these tables are subject to

 

change from release-to-release and may require an application be

 

recompiled in order to function correctly on a new release. The release

 

notes for each new release will indicate whether a recomplilation is

 

required.

RETURN VALUE

Routine zinfo 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;

uint32

mode;

char

ibuf[size]; /* "size" is user-determined, and is >= len */

int32

len;

if (ierr = zinfo (&zaddr, mode, ibuf, len)) { /* 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.

238

Chapter 4