ACC Programmer's Reference Guide

Chapter 4 187
ZCOM C I/F Library Routines
ZCONFIG (3X)
Interface
Configuration
There are 6 interface configuration actions. They are used to alter t he
parameters related to an interface card, and for controlling the operation
of an interface card.
Action ZcDSC_CHNG_FW_FILE (1) modifies the firmware file name
(used to download the MUX card). This change will have no effect until
the interface card is restarted, causing the new firmware file to be used
to download the card.
Action ZcDSC_CREATE_IFT (2) allocates the internal data structures
required for a new interface card. That is, it creates a new Interface
Table entry.
Action ZcDSC_START_CARD (3) starts up an interface. This initializes
the hardware, the ports and terminals according to the configuration
kept in the ZCOM tables. In functionality, it is identical to a zmon restart
command.
Action ZcDSC_HALT_CARD (4) halts the hardware and stops new
requests to the ACC interface card. All pending buffers and terminals
linked to the i nterface remain unchanged. This function prepares an
Interface Table entry for reassignment to different hardware (a new
MUX interface card).
Action ZcDSC_STOP_CARD (5) stops an interface card a s i n action
ZcDSC_HALT_CARD. In addition, all buffers linked to the interface and
its terminals are released. Terminals are then set to unavailable. This
function may be used to prepares an interface for re-linki ng to different
hardware, or to eliminate all pending resources for a failed card. It is
identical to a zmon shutdown command.
Action ZcDSC_REASSIGN_IFT (6) associates an interface table entry
with a different MUX interface card. An interface must be halted or
stopped(i.e. action ZcDSC_ HALT_CARD or ZcDSC_STOP_CARD) before
this request can be issued.