Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

CI Communications
3-46
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
I Process Development Process
The definition of the _CI^DEF-defined structure is:
DEFINITION ZDSN-DDL-PCLASS-CONFIG.
02 Z-PCLASS TYPE ZDSN-DDL-PCLASS.
02 Z-PUBLIC-NAME-OCCURS TYPE ZSPI-DDL-UINT.
02 Z-PUBLIC-NAME TYPE ZDSN-DDL-PARAMNAME.
02 Z-FLAGS TYPE ZSPI-DDL-ENUM.
02 Z-PNAME-OCCURS TYPE ZSPI-DDL-UINT.
02 Z-PNAME TYPE ZDSN-DDL-PNAME.
02 Z-MAX-PROCESSES TYPE ZSPI-DDL-INT.
02 Z-OPEN-PARAMS.
03 Z-DEFAULT-QUALIFIER TYPE ZDSN-DDL-PQUAL.
03 Z-NOWAIT-DEPTH TYPE ZSPI-DDL-INT.
03 Z-OPEN-TIMEOUT TYPE ZSPI-DDL-INT2.
02 Z-NEWPROCESS-PARAMS.
03 Z-OBJECT-FILE TYPE ZDSN-DDL-OBJNAME.
03 Z-LIBRARY-FILE TYPE ZDSN-DDL-OBJNAME.
03 Z-SWAPVOL TYPE ZDSN-DDL-OBJNAME.
03 Z-PRIORITY TYPE ZSPI-DDL-INT.
03 Z-DATAPAGES TYPE ZSPI-DDL-INT.
03 Z-NUM-CPUS TYPE ZSPI-DDL-INT.
03 Z-CPUS TYPE ZSPI-DDL-INT OCCURS 16 TIMES.
03 Z-HOMETERM TYPE ZDSN-DDL-OBJNAME.
03 Z-FLAGS TYPE ZSPI-DDL-ENUM.
END
Retrieving CI Configuration Parameter Values: _ADD^CI
_ADD^CI allocates memory for the _CI^DEF-defined structure, fills it in with CI
configuration information from the DSNM configuration, and returns the address of the
filled-in structure.
You must call _ADD^CI in your _STARTUP procedure for each CI class with which
your I process communicates.
ciname is the process class name of the CI. The process class 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.
@ci-config := _ADD^CI ( ciname
,[ error ]
,[ error-filename ]);
Note. The CI process class name is configured in the DSNMCONF file (in the COMPONENT
field in the class CI-CONFIG record for this CI). See Section 6, “Configuring a New Subsystem
Into DSNM,” for more information about CI configuration.