Reference Guide

ZCOM C I/F Library Routines
ZCONFIG (3X)
Chapter 4 201
Response Data
data.cardret.iftno
This is the interface card number as in the configuration data. It indicates
the interface table entry that was created or modified.
data.cardret.error
This is the returned interface configuration error:
0 - No error (successful)
< 0 - ZCOM error code
The error message text may be fetched using \fIzcomerror\fR(3X) with a
non-zero error code.
Port Configuration There are 8 port configuration actions. Actions ZcDSC_ALL_PARMS,
ZcDSC_CFG_MODE, ZcDSC_BAUD_RATE, and ZcDSC_PORT_MODE
configure the datacomm ports on the MUX interface card. All terminal
ZLUs on the port being changed must be disabled before the port
configuration takes place (use zcntl to disable a terminal ZLU using
request code ZCOM_MRQCODE_DSB[8]). Examine the TTGEN
configuration file to determine which ports are defined for which MUX
interface cards and the terminals associated with each port.
Action ZcDSC_BREAK_REQ is used to activate the Port Break Routine
of the protocol firmware. Since Port configuration by-passes the normal
terminal transmit queues, this function is used as a software interrupt to
the protocol specific firmware to initiate a recovery process when there is
a protocol problem and the transmit queues are “blocked up”. If the
protocol for the specified port does not support this facility, error status 8
is returned.
Action ZcDSC_SET_XMIT_LIMIT changes the port transmit limit of a
specific port on a MUX card. This limit controls the flow of requests from
the host to the card for terminals on the related port.
Action ZcDSC_ENABLE_PORT enables a port after it has been disabled
(action ZcDSC_DISABLE_PORT).
Action ZcDSC_DISABLE_PORT disables a port putting it into an
inoperative state. All linked terminals are marked without actually
sending a disable request to the interface card. This is to avoid a “hung”
terminal disable request due to a hardware failure on a port. This action
is designed to isolate a port that has failed from the ZCOM system. The
ZCOM system will stop using the port and the terminals on the failed
port may then be moved or deleted.