ZCOM C I/F Library Routines

 

ZINIT (3X)

PARAMETERS

sip (Return Param) ZCOM system information data structure containing

 

the following fields:

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.

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.

Chapter 4

241