Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

The INQUIRE Command
2-14
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Commands
FROM-DISPLAY causes the command to use the names on the NetStatus display
instead of resolving them through Distributed Name Service (DNS), thus speeding
name resolution. The FROM-DISPLAY parameter is valid only if you are issuing a
command from the NetStatus command line and all objects specified in the
command appear on the NetStatus screen. (Refer to the NetStatus User’s Guide for
more information on FROM-DISPLAY.)
Considerations
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. However, because the STATUS command obtains status information
from the subsystems directly, it produces more up-to-date information. Take your
immediate needs into account when choosing between using INQUIRE and STATUS.
Because the SUMMARY, SUMMARY-BYOBJECT, and SUMMARY-BYTYPE
response modifiers return the number of objects in each state, the state modifier is
ineffective with them. DSNM ignores the state modifier if it is combined with any of
these response modifiers.
Because the INQUIRE command retrieves status information from the in-memory copy
of the DSNM object database, it does not return the status of dynamic objects, such as
PATHMON-controlled terminals (which are not added to the database), or of objects
added to your network configuration after the DSNM object database was built.
Example
The following command returns status information for all the PATHMON-controlled
TCPs controlled by manager process \LONDON.$PMUK that are in either the UP or
PENDING state:
INQUIRE TCP * UNDER $PMUK, NOT-DOWN
Because no hierarchy modifier is specified, this command also returns the status of all
the UP or PENDING terminals controlled by that TCP. The default response modifier
BRIEF returns one line of information for each object. A sample response to this
command is:
PATHWAY TCP TCP1 UNDER \LONDON.$PMUK Up
PATHWAY TERM UKPWT1 UNDER \LONDON.$PMUK Up
PATHWAY TERM UKPWT4 UNDER \LONDON.$PMUK Pending
PATHWAY TERM UKPWT5 UNDER \LONDON.$PMUK Up
PATHWAY TERM UKPWT6 UNDER \LONDON.$PMUK Pending
PATHWAY TERM UKPWT7 UNDER \LONDON.$PMUK Pending
PATHWAY TERM UKPWT8 UNDER \LONDON.$PMUK Up
PATHWAY TERM UKPWT10 UNDER \LONDON.$PMUK Up