Reference Guide

ZCOM C I/F Library Routines
ZCONFIG (3X)
Chapter 4190
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)