Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 5-1
5
DSNM Process Startup Functions
Scope of This Section
DSNM processes call a startup procedure as the first step in the main procedure.
Typically, the startup procedure reads parameters via library calls, and then continues
with other process-specific initialization.
Processes retrieve process parameters and configuration parameters from either the
startup message or the DSNMCONF file, depending on how the system is configured
and how the parameter-retrieval procedures are called. Processes retrieve subsystem and
CI configuration information from the DSNMCONF file.
The structure and content of the DSNMCONF file is discussed in Section 6,
“Configuring a New Subsystem Into DSNM.” This section describes:
•
The startup message
•
The ways in which startup messages and configuration files are searched
•
How the structures into which processes retrieve startup and configuration
parameters are declared and defined
•
The intended usage and syntax of the library procedures that retrieve the following
information into predefined structures for use by the frame and the command thread:
•
Process parameters and configuration parameters from the startup message and
the DSNMCONF file
•
Subsystem configuration information
•
CI configuration information
DSNM Process Startup Message
The format of the parameter portion of the RUN command for DSNM processes appears
in bold next. These are the parameters that are sent to the new process in the startup
message.
[ RUN ] program-file [ / run-option [ , run-option ] ... / ]
[ process-parameter [, process-parameter ] ...]
[; DSNM-config-parameter [, DSNM-config-parameter ] ...]
Process parameters are specific to the particular process itself. These parameters are
accepted by the process, regardless of the STARTUP [PARAMS] value in the
$SYSTEM.SYSTEM.DSNM file (see Section 6, “Configuring a New Subsystem Into
DSNM”).
DSNM configuration parameters are ignored unless STARTUP [PARAMS] is YES in
the environment (see “DSNM Configuration Parameters” on page 5-3). If you specify
DSNM configuration parameters but no process parameters, the configuration parameter
list must begin with a semicolon (;).