ZCOM C I/F Library Routines

ZCNTL (3X)

Modes 5 and 7 are only meaningful when rcode is 3.

Some bits (when set) in the mode parameter can cause zcntl to behave differently. Refer to the NOTES section in zsend(3X) for details.

rcode

Control request code:

 

 

ZCOM_MRQCODE_CNTWR

(3) - Control write (length in len)

 

ZCOM_MRQCODE_TERM

(6) - Set terminal parameters

 

ZCOM_MRQCODE_ENB

(7) - Enable terminal

 

ZCOM_MRQCODE_DSB

(8) - Disable terminal

 

ZCOM_MRQCODE_ACT

(9) - Activate polling

 

ZCOM_MRQCODE_DEA

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

172

Chapter 4