HP Integrity NonStop H-Series - Manual (Page 77)

Hierarchy Modifier
Modifiers
4–2 098571 Tandem Computers Incorporated
If you specify a hierarchy modifier and a state or highlight modifier, DSNM
applies the hierarchy modifier before it applies the state or highlight modifier.
(This permits you to apply a command to the subordinates of an object that does
not satisfy the other modifiers.)
Some DSNM commands do not allow for the use of all modifiers. See detailed
information on each DSNM command in Section 2, “DSNM Commands,” for
specific information.
Hierarchy Modifier The hierarchy modifier alters the scope of the command based upon the subsystem
object hierarchy. If a hierarchy modifier is not specified, the command applies to the
objects named in the object specification and all the objects’ subordinates.
The three possible values for the hierarchy modifier are :
ONLY The command affects the specified objects, but not the objects that are
subordinate to them.
SUBONLY The command affects the objects subordinate to the specified objects, but
not the specified objects themselves.
ALL The command affects both the specified objects and their subordinate
objects.
The default hierarchy modifier is ALL.
An individual object specification can include a hierarchy modifier, in which case the
hierarchy modifier is not separated from its object specification by a comma. A
hierarchy modifier specified outside of the object specification is specified after the list
of object specifications and is separated from the object specification by a comma. A
hierarchy modifier specified outside of the object specification applies to all object
specifications in the command except those that contain their own hierarchy modifiers.
Examples
As an example, assume that TCP1 and TCP2 are aliases for different Pathway TCPs,
and LONDON is a group of SNAX lines.
In the following command, the value of the hierarchy modifier, which is ONLY,
modifies all object specifications in the list; thus, the command starts the LONDON
SNAX lines, TCP1, and TCP2, but does not start the subordinate objects.
START SNAX LINE LONDON, TCP1, TCP2, ONLY
In the following command, ONLY is part of the TCP2 object specification because it is
separated from TCP2 by a space. Thus, TCP2 is started but its subordinate objects are
not. Because the hierarchy modifier default value, which is ALL, is applied to the
other object specifications, the command starts LONDON SNAX lines, their
subordinate PUs and LUs, TCP1, and TCP1’s subordinate objects.
START SNAX LINE LONDON, TCP1, TCP2 ONLY