Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Command Requirements

Distributed Systems Network Management (DSNM) Subsystem Interface Development

Guide—109759 4-13

The AGGREGATE Command

AGGREGATE issues the subsystem command(s) that return the current operational

status of objects. This command summarizes the operational status of all objects in a

subsystem. If the subsystem employs a manager, the summary is for all objects

controlled by the manager. If there is no manager, Z^MANAGER^OCCURS is 0.

For the input list object, only the fields Z^SUBSYS, Z^MANAGER^OCCURS and

Z^MANAGER are relevant. Object type, object name, and HMOD are irrelevant and

should be ignored.

Valid Modifiers

None; any modifiers present should be ignored.

Output Object Requirements

For each input list object, return one output object for each object type in the subsystem,

designated as follows:

Append a type ZDSN^VTY^COUNTERS counters structure (described by

ZDSN^DDL^COUNTERS^DEF) containing the number of objects of Z^OBJTYPE in

each DSNM state. The relevant counters structure fields are:

Count objects in ZDSN^STATE^NULL in the Z^GREEN counter, which here is

interpreted as “exists.”

Accumulate objects in both ZDSN^STATE^UNDEFINED and

ZDSN^STATE^UNKNOWN in the Z^UNDEFINED counter.

Z^SUBSYS Subsystem

Z^OBJTYPE Object type

Z^OBJNAME Blank

Z^MANAGER Manager, if any; blank otherwise

Z^RESULT Null (0 value)

INT(32) Z^GREEN;

INT(32) Z^UP = Z^GREEN;

INT(32) Z^RED;

INT(32) Z^DOWN = Z^RED;

INT(32) Z^YELLOW;

INT(32) Z^PENDING = Z^YELLOW;

INT(32) Z^UNDEFINED;

INT(32) Z^INERROR;