ZCOM C I/F Library Routines

ZSEND (3X)

* 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.

The following data structures are used for the zsend call. See /opt/acc/include/zcom/zcomsys.h for further details.

284

Chapter 4