Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide
Object List Modifiers
4-4
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Command Requirements
In addition to the HMOD value in the MOD structure supplied with the command
(MOD.Z^HMOD), there may also be an HMOD value in the FOBJECT structure
associated with each input list object (FOBJ.Z^HMOD). When both are present, the
HMOD in the object structure overrides the HMOD command modifier. Table 4-2
summarizes HMOD usage.
The State Modifier (_INPUT.MOD.Z^SMOD)
The state modifier (SMOD) selects objects for operation according to their current
DSNM state. There is no default for SMOD. If omitted, the command should be
applied to all objects determined by the HMOD.
SMOD is valid for all DSNM commands except AGGREGATE, INFO and
STATISTICS. Its values have the following meanings:
SMOD is applied after HMOD: that is, it can apply to subordinates of an input list
object even if the input list object itself does not satisfy the SMOD. For example, a
START command specifying a NOT^GREEN SMOD would start subordinates of a
GREEN state object in RED and YELLOW states without attempting to start the object
itself.
Table 4-2. HMOD Usage
FOBJ.Z^HMOD MOD.Z^HMOD HMOD Associated With Object
Omitted Omitted ZDSN^HMOD^ALL (default)
Omitted Present MOD.Z^HMOD
Present Omitted FOBJ.Z^HMOD
Present Present FOBJ.Z^HMOD
ZDSN^SMOD^UP |
ZDSN^SMOD^GREEN
Apply the command only to objects on the object
list that are UP (GREEN).
ZDSN^SMOD^NOT^UP |
ZDSN^SMOD^NOT^GREEN
Apply the command only to objects on the object
list that are DOWN (RED) or PENDING
(YELLOW).
ZDSN^SMOD^DOWN |
ZDSN^SMOD^RED
Apply the command only to objects on the object
list that are DOWN (RED).
ZDSN^SMOD^NOT^DOWN |
ZDSN^SMOD^NOT^RED
Apply the command only to the objects on the
object list that are UP (GREEN) or PENDING
(YELLOW)
Note. ZDSN^SMOD^GREEN and ZDSN^SMOD^UP have the same value and may be used
interchangeably. Similarly, NOT^GREEN/NOT^UP, RED/DOWN, and NOT^RED/NOT^DOWN
are interchangeable. Externally in DSNM commands, UP, NOT-UP, DOWN, and NOT-DOWN
designate these values.