Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

Considerations
2-6
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Commands
Considerations
The following considerations apply to all DSNM commands except the AGGREGATE
command. For more information on object specification and modifiers, refer to the
User’s Guide to DSNM Commands.
•
You can use parentheses to nest object lists. Any modifiers that appear inside
parentheses are limited to the object specifications within the parentheses,
overriding any modifiers that apply to the entire command.
•
Modifiers can appear in any order as long as there is only one of each type. The
hierarchy modifier is the only exception; it can occur as part of the object
specification or as part of the command as a whole, or both.
•
If you specify more than one modifier of the same type, DSNM only uses the last
one. You can specify a hierarchy modifier within any of the object specifications,
and you can apply one to the entire command. If a hierarchy modifier is specified
within an object specification, it overrides the command’s hierarchy modifier.
•
If you enter a command that is syntactically correct, except that it includes an
incorrect or incomplete object specification, DSNM executes the command for all of
the objects that can be resolved.
DSNM Object States
One purpose of DSNM is to present a uniform representation of objects and their
subsystems for status displays. To this end, subsystem objects are classified into one of
a small set of DSNM states. This set of states may be smaller than the possible set of
subsystem states for the object. The subsystem interface process must be able to map
the states of the subsystem objects to the following DSNM object states:
Canceling Commands
If you are using NetCommand, you can cancel any command still in progress by
pressing the Break key. When you press the Break key, you see the following prompt:
Cancel?
Enter Y to cancel the command; enter N to permit it to continue. Pressing the Enter key
also permits the command to continue. If you enter Y, the command is immediately
canceled. Any portions of the command that were already completed remain in effect.
DOWN The object is unavailable or needs an operator to take action to make
it ready.
UP The object in use or available for immediate use.
PENDING The object is neither ready for use nor totally deactivated; it is in
some intermediate state such as STARTING.
UNDEFINED The object is not configured.
UNKNOWN The state of the object cannot be determined.