ACC Programmer's Reference Guide

Chapter 4 249
ZCOM C I/F Library Routines
ZOPEN (3X)
The libraries libzcom_c.a and libpthread.a must be linked into the calling
program by giving the options “-lzcom_c -lpthread” options to cc(1) or
ld(1).
Threads
Considerations
This routine may be called from a multi-threaded application using the
POSIX (1003.1c) kernel threads API package. This routine has the
following characteristics when called by a multi-threaded application:
See the NOTES section below for more information on using this routine
in a multi-threaded application.
PARAMETERS
cancellation point Thread cancellation can occur when a thread calls this
routine.
async-cancel unsafe The calling thread’s cancelability type must be
PTHREAD_CANCEL_DEFERRED if cancellation is
enabled.
async-signal unsafe It cannot be called from a signal handler.
fork unsafe It cannot be called by a child process after fork(2) but
before exec(2).
zap
(Return Param)
ZCOM address (node, ZLU number, and checksum).
Node contains the local node as defined in the TTGEN
configuration file.
pflag Set to ZcPRIMARY_ZLU(1) if this ZLU is to be
primary ZLU for this program. Any other value
(ZcAUXILIARY_ZLU) defines it as an auxiliary ZLU.
Bit ZCOM_ZOPEN_NEW (0x8000) tells the routine to
return an error if we are using an existing ZLU.
name Name to be given to the opened ZLU. The name must be
unique within the local node ZLU table. The name may
beamaximumof7 characters long, and must be
null-terminated.
limit Queue size limit. If 0 is specified, then the default queue
size limit (defined in the TTGEN configuration file) is
used.