Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Commands
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 2-19
The STATUS Command
The STATUS Command
Use the STATUS command to obtain the current subsystem status of objects, as obtained
from the subsystem. The STATUS command generates more up-to-date information
than the INQUIRE command, but the response time can be slower.
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.
response-modifier
determines how much status information is returned and it s format. Possible
response modifiers are: BRIEF, DETAIL, SUMMARY, SUMMARY-BYOBJECT,
and SUMMARY-BYTYPE.
Considerations
Because the STATUS command obtains status information from the subsystems directly,
it produces more up-to-date information than the INQUIRE command. However,
because the INQUIRE command obtains status information from the object database, it
has a faster response time than the STATUS command. This is especially noticeable in
large networks.
STATUS objectspec [, objectspec ]...
[, hierarchy-modifier ]
[, error-modifier ]
[, state-modifier ]
[, response-modifier ]