ACC Programmer's Reference Guide

162 Chapter4
ZCOM C I/F Library Routines
ZCNTL (3X)
rcode Control request code:
ZCOM_MRQCODE_CNTWR
ZCOM_MRQCODE_TERM
ZCOM_MRQCODE_ENB
ZCOM_MRQCODE_DSB
ZCOM_MRQCODE_ACT
ZCOM_MRQCODE_DEA
(3) - Control write (length in len)
(6) - Set terminal parameters
(7) - Enable terminal
(8) - Disable terminal
(9) - Activate polling
(10) - Deactivate pollin
To operate normally, a terminal ZLU must be enabled
(rcode=ZCOM_MRQCODE_ENB) and activated
(rcode=ZCOM_MRQCODE_ACT). If the terminal ZLU is deactivated
(rcode=ZCOM_MRQCODE_DEA), the ZCOM subsystem cannot receive
incoming messages from that terminal (used for flow-control). If it is disabled
(rcode=ZCOM_MRQCODE_DSB), data messages can neither be sent nor
received from the terminal.
Request ZCOM_MRQCODE_TERM is used to configure a terminal with new
parameters, which are protocol dependent. Control write request
ZCOM_MRQCODE_CNTWR provides a means of passing protocol specific
control information to a terminal. These two requests require setting up the ibuf and
len parameters.
mhp Pointer to message header. It contains some data fields to be sent with the data
message. See the NOTES section in zsend(3X) for what fields must be set up by
the caller. If NULL is specified, default values are used.
For its structure, refer to the subsection on ‘Message Header’ in the Multi-protocol
ACC Programmers’ Reference Guide.
ibuf, len If rcode=ZCOM_MRQCODE_CNTWR, ibuf contains the control data for the
protocol, and len indicates the length of the control data. If
rcode=ZCOM_MRQCODE_TERM, ibuf contains the configuration data for the
terminal as described below, and the len indicates the total length of the
configuration data. For other values of rcode, ibuf and len are not used.
rstat
(ReturnParam)
Return status. Only used for requests issued with ‘wait’, i.e. mode =
ZMODE_WAIT. NULL may be used if the return status is not required.