ZCOM C I/F Library Routines

 

ZCONFIG (3X)

Terminal

There are 5 terminal configuration actions. They are for altering various

Configuration

internal linkages and terminal tables in the ZCOM runtime system

 

memory.

 

Action ZcDSC_CREATE_LTT_PTT (1) creates a simple terminal that has

 

one Logical Terminal Table (LTT) and one Physical Terminal Table

 

(PTT).

 

 

NOTE

For this new ZCOM terminal, zconfig() allocates data structures in the

 

kernel for ZCOM drivers to access. However, related data structures for

 

this terminal must also be allocated on the target ACC card to complete

 

the task. To allocate the related firmware data structures, use zcntl()

 

with the ZCOM_MRQCODE_TERM rcode value (see the zcntl(3X) man

 

page).

 

Action ZcDSC_CREATE_LTT_ON_PTT (2) creates and links an LTT to

 

 

an existing terminal. The newly created LTT becomes an inbound

 

multiplexing terminal and bit ZCOM_LTFLAG_IMX of field “ltaddr” is

 

set automatically.

 

Action ZcDSC_CLEAR_TERM (3) clears a terminal for deletion. It

 

flushes data buffers and removes the receivers of a terminal. It is usually

 

used to prepare a terminal for deletion. Note that a terminal must be

 

disabled before it can be cleared.

 

Action ZcDSC_DELETE_TERM (4) removes a terminal and releases its

 

table space to the free pool. If a terminal has multiple LTTs linked to it,

 

only the LTT is removed, the PTT is untouched. Otherwise, both the LTT

 

and PTT are removed. If the PTT is to be removed, it must be disabled

 

and have no pending or active I/O requests. Action

 

ZcDSC_CLEAR_TERM is designed to “clear” a terminal for deletion.

 

Action ZcDSC_MOVE_TERM (5) is to re-link a terminal to a different

 

port, on the same or different interface cards. After moving the terminal

 

entry, the terminal must be re-configured, enabled and activated (i.e.

 

ZCNTL request 6, 7 and 9) before it can be re-used. A terminal must be

 

disabled and have no active I/O requests before it can be moved.

 

Configuration Data

 

header.config

 

ZCOM_ZCONFIG_TERM (terminal configuration)

Chapter 4

219