Reference Guide

ZCOM C I/F Library Routines

ZCNTL (3X)

Chapter 4 175

For any i960 4-channel ACC card:

Data structure: ztrq2_type

Must set RTYP bit = 1. This usually means setting the ztrq2_type.tmreqt field

to 0x80.

The terminal type relates a protocol to the specific terminal (the

device name in a TTGEN configuration file maps to a terminal type

for each terminal). The terminal port must be the same as the

original port. To move a terminal from one port to another, use

zconfig(3X). The special terminal configuration is protocol

dependent, and corresponds to the field spec_cfg of the physical

terminal table (see zptt_type in /opt/acc/include/zcom/zcomsys.h).

Currently, a maximum of 6-byte is allowed. Configuration data

larger than this is silently truncated.

4. The tag parameters (mhp->mid.mtagw1 and mtagw2) may be used

in zcntl for identifying the origin of a response when returned from

zread(3X). They may also contain codes indicating the specific action

to be taken on completion of the request.

RETURN VALUE Routine zcntl returns 0 if successful. Otherwise, a non-zero error code is

returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM

error codes and their meanings.

If mode 8 is used and zcntl returns with zero, rstat contains the return

status: 0 means successful, a non-zero value means there was a

problem with the control request. zcomstatus(3X) may be used to retrieve

a status message, using rcode and rstat.

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

0 RTYP Ext. Req. Type Terminal Type

2 Port Number Subchannel Number

4 Group Poll Code Device Poll Code

6 Group Select Code Device Poll Code

8 Terminal Option Word

Special Terminal Configuration

(Variable Length, max. 6 bytes)