ZCOM C I/F Library Routines

ZCONFIG (3X)

Port Subchannel The port subchannel configuration is only valid for the E1/T1 interface.

Configuration There are 12 port configuration actions. Actions ZcDSC_ALL_PARMS, ZcDSC_CFG_MODE, ZcDSC_BAUD_RATE, ZcDSC_PORT_MODE, ZcDSC_SET_TIMESLOTS and ZcDSC_SET_SUBC_SPECS configure the datacomm ports and/or subchannels on the MUX E1/T1 interface card. For actions other than ZcDSC_SET_TIMESLOTS and ZcDSC_SET_SUBC_SPECS all terminal ZLUs on the port being changed must be disabled before the port configuration takes place (use zcntl to disable a terminal using request code ZCOM_MRQCODE_DSB[8]). For actions ZcDSC_SET_TIMESLOTS and ZcDSC_SET_SUBC_SPECS all terminal ZLUs on the subchannel(s) being changed must be disabled before the port configuration takes place. Note that, if a timeslot is being reconfigured to a new subchannel both the old and new subchannels must have no enabled terminals, for the reconfiguration to proceed. Examine the TTGEN configuration file or use zinfo() to determine which ports/subchannels are defined for which MUX interface cards and the terminal ZLUs 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 PT_NO_BREAK (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 processing of transmit requests 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 disabled 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.

Action ZcDSC_ENABLE_SUBC enables a subchannel after it has been disabled (action ZcDSC_DISABLE_SUBC).

Chapter 4

211