HP UX 11i v1 I/O Cards manual Zconfig

ZCOM C I/F Library Routines

ZCONFIG (3X)

ZCONFIG (3X)

NAME	zconfig – ZCOM Dynamic System Configuration (DSC)
SYNOPSIS
#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h>	/* If compliled with ANSI C (recommended) */

int32 zconfig (zap, mode, node, cdata, rdata)

zaddr_type *zap; uint32 mode; uint32 node; zconfig_type *cdata; zcfgret_type *rdata;

DESCRIPTION Routine zconfig provides a general purpose mechanism for configuring a ZCOM system dynamically, i.e. altering some of the system tables or hardware settings while the system is running.

ATTENTION: The current release provides very limited user support for the functionality documented here. Specifically, the only supported functions are the Dynamic System Configuration (DSC) Control request to send a “Reconfiguration Complete” system event message and all of the Port Configuration actions.

The configuration modified by use of the zconfig routine is only effective while this instance of the ZCOM subsystem is running. The new configuration remains in force until changed by another call or until the ZCOM system is reinitialized. If the ZCOM subsystem is shutdown and restarted, the original configuration defined in the TTGEN configuration file is restored and all dynamic configuration changes are lost. Therefore, all permanent configuration information should be defined in the TTGEN configuration file.

This routine is intended for use by advanced user programs and should be used with care. Since this routine is used to dynamically modify the internal data structures used in the ZCOM subsystem, applications which use this functionality may need to be recompiled with new releases of the ACC base product.

The libraries libzcom_c.a and libpthread.a must be linked into the calling program by giving the options “-lzcom_c-lpthread” to cc(1) or ld(1)

178 Chapter 4