Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Commands

Distributed Systems Network Management (DSNM) Subsystem Interface Development

Guide—109759 2-13

The INQUIRE Command

Use the INQUIRE command to obtain the current status of objects as recorded in the

DSNM object database. Response time to the INQUIRE command can be faster than

that of the STATUS command, but the response to the STATUS command can be more

up-to-date than that of the INQUIRE command. See “Considerations” for details.

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 its format. Possible

response modifiers are: BRIEF, DETAIL, SUMMARY, SUMMARY-BYOBJECT,

and SUMMARY-BYTYPE.

highlight-modifier

determines the scope of the command, based on information in the DSNM object

database. Possible highlight modifiers are: FROM-DISPLAY, DEFINED,

UNDEFINED, MONITORED, NOT-MONITORED, ACCEPTABLE, and

UNACCEPTABLE. There is no default for the highlight modifier.

INQUIRE objectspec [, objectspec ]...

[, hierarchy-modifier ]

[, error-modifier ]

[, state-modifier ]

[, response-modifier ]

[, highlight-modifier ]