Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Command Requirements
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 4-5
Response Modifiers
When SMOD is specified, only objects in UP/GREEN, DOWN/RED, and
PENDING/YELLOW states are included. So, for example, a STATUS command with a
NOT^RED SMOD value should not include UNDEFINED or UNKNOWN objects in
the response.
Response Modifiers
The response modifiers determine the amount and type of information returned for each
object in the output object list.
The Response Modifier (_INPUT.MOD.Z^RMOD)
The response modifier (RMOD) controls the level of detailed information returned for
informational commands. RMOD is valid for the STATUS command only; its values
have the following meanings:
Note. It is the responsibility of the command thread to map the set of states supported by the
subsystem into the set of DSNM states (see “Object States” on page 4-7).
Error reporting is independent of SMOD. Unreachable, undefined, or ill-formed objects should
be reported as errors according to the EMOD (see the error modifier discussion in “The Error
Modifier (_INPUT.MOD.Z^EMOD)” on page 4-6).
ZDSN^RMOD^BRIEF Return the DSNM object state for each object (UP,
DOWN, PENDING) and possibly one line of descriptive
text (ZDSN^VTY^RESULTTEXT); see “Object States”
on page 4-7. This is the default.
ZDSN^RMOD^DETAIL Return the object state and append as much additional
detailed status (ZDSN^VTY^TEXT) as available to each
object on the output object list (see individual command
descriptions in this section).
Note. SUMMARY-type response modifiers are handled entirely by the I process frame and are
never encountered by the command thread itself.