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.
Chapter 4 | 283 |