Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

Parameter Types and Search Criteria
5-4
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Process Startup Functions
Parameter Types and Search Criteria
The parameter retrieval library functions retrieve parameter values from the startup
message or the DSNMCONF file, according to the search criteria specified in the
arguments passed to the procedures. (See the syntax descriptions of the procedures in
“Parameter Retrieval Library Services” on page 5-6.) Such library functions return
either the first value set obtained or the union of value sets obtained, depending on
whether the parameter is local or global.
A value set is all the records retrieved from a single configuration file (or from the
startup message) by a generic key search that excludes the SEQUENCE field.
If STARTUP [PARAMS] is set to YES, and if at least one instance of the named
parameter is found in the startup message, the startup message values determine the
value set. If not, the configuration file is searched for the first key. The first successful
search determines the value set. If no search is successful with the first key, the
procedure is repeated with the second key, and so on.
Local Parameters and Search Patterns
Local parameters consist of a single value (for example, SWAPVOL) obtained from one
source: a DSNMCONF file or the startup message.
Local Component Parameters
A local component parameter is a parameter specific to this component and class. The
first value set found by the following generic key search is returned:
Local Class Parameters
A local class parameter is a parameter specific to this class. If component is blank, it is
specific to the class as a whole. The first value set found by the following generic key
search is returned:
Note. In the following discussion on local and global parameters, mysystem refers to either the
local system, or, if the process accepts the MYSYSTEM process parameter, the system that
acts as the home system. Also, if the process has no component name (“class component” is
identical to “class blank”), only one search is performed.
mysystem DSNM class component parameter
DSNM class component parameter
mysystem DSNM class component parameter
mysystem DSNM class blank parameter
blank DSNM class component parameter
blank DSNM class blank parameter