Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Commands

Distributed Systems Network Management (DSNM) Subsystem Interface Development

Guide—109759 2-15

The START Command

The START command causes DSNM to issue the subsystem-specific command(s) that

change each object to the subsystem state that corresponds to the DSNM UP state. If all

objects specified in the command are started, there is no command response. If the

command fails to start any of the objects, there is a response, listing the objects that

were not started. If the command line contains a syntax error, you receive an error

message.

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.

Considerations

In some cases, the SUBONLY modifier has no meaning when issued with the START

command. Some subsystems prevent you from requesting to start subordinate objects

without starting the objects to which they are subordinate. The SNAX/XF subsystem

requires that SNAX lines be started before PUs and LUs. PATHMON requires that

TCPs be started before terminals.

START objectspec [, objectspec ]...

[, hierarchy-modifier ]

[, error-modifier ]

[, state-modifier ]