Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-5
_ADD^CI
_ADD^CI
_ADD^CI retrieves CI configuration information from the DSNM configuration file
(DSNMCONF). It allocates the memory for and completes a predefined CI
configuration structure with this information. It then returns the address of the
completed structure.
You must declare an extended pointer to a structure defined by _CI^DEF in your global
definitions for each CI with which your subsystem communicates.
You must call _ADD^CI in your _STARTUP procedure for each CI class with which
your I-process communicates.
ci-config output
INT .EXT ! (_CI^DEF) !
receives the address of the _CI^DEF-defined CI configuration structure that
_ADD^CI completes with configuration parameter values for the specified CI. If an
error occurs or no configuration is found for this CI process class, a null value is
returned.
ciname input
STRING .EXT
is the process class name associated with the CI. The string must be blank or null
terminated.
The process class name of the CI is the name in the COMPONENT field of the
CI-CONFIG class records in the DSNMCONF file that specifies the CI
configuration parameters. This name is arbitrary; by custom, the object file name of
the subsystem manager is the logical name of the process class (for example,
PATHMON or SCP).
error output
INT .EXT
is the ZDSN or file-system error, if an error occurs.
error-filename output
STRING .EXT ! (ZDSN^DDL^OBJNAME^DEF) !
is the name of the DSNM configuration file associated with the returned error
value.
@ci-config := _ADD^CI ( ciname
,[ error ]
,[ error-filename ] );