ACC Programmer's Reference Guide

218 Chapter4
ZCOM C I/F Library Routines
ZINFO (3X)
zap ZCOM address pointer. The node field is used to indicate from which node to retrieve the
information. The uses of zlu and zcs depend on the specified mode.
mode Type of information to return:
ZcZLU_TBL (0) - ZLU Descriptor information
ZcLTT_TBL (1) - Logical Terminal Table information
ZcPTT_TBL (2) - Physical Terminal Table information
ZcHDR_TBL (3) - Header information (zlu and zcs are not used)
ZcIFT_TBL (4) - Interface Table (zlu is the interface number, zcs is not used)
ZcNODE_BYNUM (5) - Node entry (zlu is the required node number, zcs is not used)
ZcNODE_BYIDX (6) - Node entry (zlu is the index within the node table, ranging
from 0 to maximum-1, zcs is not used)
Bit15-Whenthisbit(ZCOM_ZINFO_NAVL)isset,zinfo will return the configured
ZLU, Logical and Physical terminal information for non-available terminals. A
non-available terminal ZLU would normally result in a “Terminal is not available” error
(ZENAVL[-74]). This bit has no effect for modes ZcHDR_TBL, ZcIFT_TBL,
ZcNODE_BYNUM or ZcNODE_BYIDX.
ibuf
(Return
Param)
Buffer for return data. The full description of the layout of the return buffer is contained in
the Chapter 3, Tables and Data Structures section.
len Maximum number of bytes to be returned in ibuf. If the specified length is smaller than the
requested table size, a truncated section of the table is returned. If the specified length is
larger, only the size of the requested table is returned.