ACC Programmer's Reference Guide

Chapter 4 283
ZCOM C I/F Library Routines
ZSEND (3X)
* Mode=1 (ZcMODE_RPT_ERRS - send no wait, report errors)
The message is transmitted without waiting for completion. A
status response will be returned on the primary ZLU of the calling
program, only if transmission errors occur. The response is
retrieved by using a zread(3X) call; it will have a message type of
six (6) or fourteen (14). Only the status is returned (in the rstat
parameter of zread(3X)). The data buffer is discarded. This mode is
used if the caller is only interested in knowing about unsuccessful
zsend (transmit) requests.
* Mode=2 (ZcMODE_DEF_STATUS - send no wait, definite status)
There is a definite response for every message sent with this mode.
The response is returned to the application’s program ZLU after the
message has been successfully sent or upon a transmit error. The
response is retrieved by using the zread(3X) call; it will have a
message type of six (6) or fourteen (14). Only the status is returned
(in the rstat parameter of zread(3X)). The data buffer is discarded.
This mode is useful in sending a large number of messages through
ZCOM with flow control.
* Mode=5 (ZcMODE_RPT_ERRS_WBUF - send no wait, report errors with
buffer)
Similar to Mode 1, however the data buffer is returned along with
the status if any transmission errors occur. In this way the data
buffer can easily be rerouted, resent or logged.
* Mode=7 (ZcMODE_DEF_STATUS_WBUF - send no wait, definite status
with buffer)
Similar to Mode 2, however both the status and the data buffer are
returned with the response. This enables a message to be sent to
multiple ZLUs in a particular order, without the program having to
store the message temporarily.