ACC Programmer's Reference Guide

284 Chapter4
ZCOM C I/F Library Routines
ZSEND (3X)
The following data structures are used for the zsend call. See
/opt/acc/include/zcom/zcomsys.h for further details.
* Mode=8 (ZcMODE_WAIT - send and await status)
The return status rstat indicates whether there is any problem with
the send (zero means successful). The calling program (or thread) is
suspended by this call while the transmission is in progress. In a
multi-threaded application, only the calling thread will be
suspended, the other threads are not affected. When transmission is
completed, the call is returned with the return status in rstat.This
mode is used if the caller cannot continue unless the data message
is completely sent.
This mode of transmission is not only slower but also has a higher
processing overhead than the no wait options described above. This
mode does not provide for any timeouts at this level, i.e., it returns
only if the protocol completes or times out the transmission. It
should therefore be used with caution.