HP UX 11i v1 I/O Cards manual Mhp, ACC Programmers’ Reference Guide Ibuf, len, Rstat, ReturnParam

Models: UX 11i v1 I/O Cards

1 298
Download 298 pages 31.75 Kb
Page 162
Image 162

ZCOM C I/F Library Routines

ZCNTL (3X)

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 .

 

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

Return status. Only used for requests issued with ‘wait’, i.e. mode =

(ReturnParam)

ZMODE_WAIT. NULL may be used if the return status is not required.

162

Chapter 4

Page 162
Image 162
HP UX 11i v1 I/O Cards manual Mhp, ACC Programmers’ Reference Guide Ibuf, len, Rstat, ReturnParam