HP UX 11i v1 I/O Cards manual Returnvalue

NOTES

RETURNVALUE

ZCOM C I/F Library Routines

ZINFO (3X)

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.

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 */

}

Chapter 4 219