Reference Guide

ZCOM C I/F Library Routines
ZCONFIG (3X)
Chapter 4 219
Terminal
Configuration
There are 5 terminal configuration actions. They are for altering various
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)