ZCOM C I/F Library Routines

ZCONFIG (3X)

TYPES OF CONFIGURATION FUNCTION

} portret;

 

 

struct {

 

 

zaddr_type

zaddr;

/* Terminal ZLU */

int32

error;

/* Return ZCOM error */

} termret;

 

 

struct {

 

 

uint32

iftno;

/* Interface card number */

uint32

portno;

/* Port number */

uint32

subchno;

/* Subchannel number */

int32

status;

/* Return status */

} portscret;

 

 

} data;

 

 

} zcfgret_type;

 

 

The header is the same as in the configuration data. Its fields are returned without change for the caller to identify the response.

The union field data contains response data returned from the specified configuration. The relevant sub-field to be used depends on header.config.

Refer to the individual configuration sections for more information on response data.

DSC Control

The DSC control function is to provide global control and status on the access of DSC functions. There are 3 DSC control actions.

Action ZcENABLE_DSC(1) is to enable the DSC access after it has been disabled. By default, the DSC access is enabled when ZCOM system is started up.

Action ZcDISABLE_DSC(2) is to disable DSC access. When disabled, local processes attempting DSC functions will be suspended. For DSC requests from remote system, ZCOM error -41 (ZEDSCLOCK, DSC function is disabled) is returned.

Action ZcDSC_SEND_RECFG(3) is used to broadcast a “Reconfiguration Complete” system event message to all interested programs and protocol drivers. This action should only be used after completing all zconfig() calls to dynamically reconfigure the ZCOM subsystem. Any process or protocol driver which has previously called the ZCOM zevent_rcvr() routine will be notified with a system event message. A dynamic reconfiguration complete event message returns an event type of

ZCOM_SETYPE_RECONFIG.

Chapter 4

195