ZCOM C I/F Library Routines

ZCONFIG (3X)

Field header.config specifies the type of configuration. The interpretation of the header.action and data fields vary depending on the configuration type. Allowed values are:

ZCOM_ZCONFIG_CNTL

- DSC Control

ZCOM_ZCONFIG_SYS

- System Configuration

ZCOM_ZCONFIG_CARD

- Interface Configuration

ZCOM_ZCONFIG_PORT

- Port Configuration

ZCOM_ZCONFIG_TERM

- Terminal Configuration

ZCOM_ZCONFIG_PORTSC

- Port and Subchannel Configuration

Field header.action specifies what action is to be taken for the specified configuration type. Its meaning depends on header.config.

Fields header.tag1 and header.tag2 are tag parameters and will be returned without change in the response data.

The union field data contains information for the configuration request. The relevant sub-field to be used depends on header.config.

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

Response Data The response data structure consists of the header fields and a “union” data portion for completion response:

/* Configuration Response */

 

typedef struct {

 

 

zcfghdr_type

header;

/* Header Information */

union {

 

 

struct {

 

 

int32

error;

/* Return ZCOM error */

} ctlret;

struct {

int32

error;

/* Return ZCOM error */

} sysret;

 

 

struct {

 

 

uint32

iftno;

/* Interface card number */

int32

error;

/* Return ZCOM error */

} cardret;

 

 

struct {

 

 

uint32

iftno;

/* Interface card number */

uint32

portno;

/* Port number */

int32

status;

/* Return status */

194

Chapter 4