Reference Guide

ZCOM C I/F Library Routines
ZINIT (3X)
Chapter 4 241
PAR AMETER S sip (Return Param) ZCOM system information data structure containing
the following fields:
NOTES 1. If the calling program has already opened a primary ZLU, the
primary ZLU will be reset after calling zinit: the ZLU remains open
and its contents is not disturbed, but it stops being the ‘primary’ ZLU
of the calling program. The calling program will no longer have a
primary ZLU and need to call zopen to open a primary ZLU again
(usually with the same name, hence the same ZLU will be opened).
The other opened ZLUs are not affected by calling zinit. See
zopen(3X) for more information about the primary ZLU.
2. The zinit routine will reset the node timeouts to the default values.
Hence, any user specified node timeout must be set again after
calling zinit. See zrntimer(3X) for more information.
3. In a multi-threaded application, this routine is to be called only once
by any one of the threads. Once zinit returns successfully, the
necessary initialization tasks are completed for all threads, and all
subsequent calls to ZCOM APIs will be allowed. There is no need for
the other running threads or the newly created threads to call this
routine again. Usually, zinit is to be called during the main program’s
initialization phase, before any threads are generated.
sizrev ZCOM software revision code (4 digits).
sinode ZCOM system local node number.
sinzlu Total number of ZLU tables in the ZCOM system.
sinltt Total number of Logical Terminal Tables in the ZCOM system.
sinptt Total number of Physical Terminal Tables in the ZCOM system.
sinift Total number of Interface Tables in the ZCOM system.
sintzlu Total number of terminal ZLUs in the ZCOM system.
siszlu1 First program ZLU in the ZLU table.
sipqlim Default program ZLU queue limit.
siltsze Size (in bytes) of the Logical Terminal Table (LTT).
sispare Reserved for future use.