Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Commands
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 2-23
The UPDATE Command
The UPDATE Command
Use the UPDATE command to modify object attributes in the DSNM object database
that control:
•
Whether an object is monitored when it appears on the NetStatus display
•
What states cause an object to be highlighted on the NetStatus display
The UPDATE command returns a response for only those objects that are not
successfully updated.
The UPDATE command line must include a MONITOR, NOMONITOR, or ACCEPT
parameter.
objectspec
is the object specification. The syntax for the object specification is provided in
“Object Specification” on page 2-2.
hierarchy-modifier
determines which objects are affected by the command, based on the subsystem
object hierarchy: ONLY, SUBONLY, or ALL (default).
error-modifier
determines how much information is reported when the command is correct but the
objects against which the command is being applied produce errors. The error
modifier does not affect the command response for errors that result when a
command is entered incorrectly or when a name cannot be resolved. Possible error
modifiers are ERROR-BRIEF (default), ERROR-DETAIL, and
ERROR-SUPPRESS.
state-modifier
restricts the scope of the command to a subset of the specified objects, depending on
their states: UP, NOT-UP, DOWN, or NOT-DOWN. If you do not specify a value
for the state modifier, DSNM applies the command to all objects that match your
object specification, regardless of their states.
highlight-modifier
determines the scope of the command, based on information in the DSNM object
database. Possible highlight modifiers are: FROM-DISPLAY, DEFINED,
UPDATE objectspec [, objectspec ]...
[, hierarchy-modifier ]
[, error-modifier ]
[, state-modifier ]
[, highlight-modifier ]
[, MONITOR | NOMONITOR ]
[, ACCEPT [ UP ] [ DOWN ] [ PENDING ] ]