ZCOM C I/F Library Routines

 

ZCONFIG (3X)

Interface

There are 6 interface configuration actions. They are used to alter the

Configuration

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 interface 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 as in 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-linking 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.

Chapter 4

187

Page 187
Image 187
HP UX 11i v1 I/O Cards manual