ZCOM C I/F Library Routines

ZCONFIG (3X)

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.

Chapter 4

201