ACC Programmer's Reference Guide

Chapter 4 219
ZCOM C I/F Library Routines
ZINFO (3X)
The returned logical terminal table (mode =ZcLTT_TBL)consistsofthe
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.
Routine zinfo returns 0 if successful. Otherwise, a non-zero error code is
returned. See / opt/acc/include/zcom/zcomsys.h for the lis t of ZCOM
error codes and their meanings.
#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 */
}