ZCOM C I/F Library Routines

ZINIT (3X)

4.In a multi-threaded application, if this routine is called the second time by a thread while some ZCOM APIs are in-progress in the other threads, the access to the ZCOM system will be re-initialized. The in-progress APIs will detect this and ‘retry’ internally. This is handled automatically and is transparent to the application.

RETURN VALUE Routine zinit 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;

 

 

zsinfo_type sip;

 

 

if (ierr = zinit (&sip)) {

 

 

 

/* error return code */

 

 

}

 

 

 

else {

 

 

 

 

/* good return code */

 

 

}

 

 

FILES

 

 

 

 

/opt/acc/include/zcom/zcomsys.h

ZCOM subsystem general include file,

 

 

 

containing data types, data

 

 

 

structures, constants, error codes,

 

 

 

masks, etc. Note that this must be the

 

 

 

first include file before any other

 

 

 

ZCOM include files.

 

/opt/acc/include/zcom/zcomcall.h

ZCOM routine function prototypes

 

 

 

(requires ANSI C compilation).

SEE ALSO

zopen(3X), zrntimer(3X).

 

242

Chapter 4