Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

I Process Development Process
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 3-23
Working With Lists
The following is an example of an output list member structure definition:
STRUCT output^list^member^def (*);
BEGIN
_OUTPUT^LM^HEADER;
...
END;
The following FOBJ fields must be filled in by the command thread for each object in
the output object list according to the specifications for the individual commands
(described in Section 4, “DSNM Command Requirements”):
Output objects may have lines of text associated with them as well (see “Adding Text
Items to an Output Object: _APPEND^OUTPUT,” later in this section).
These fields are described in more detail in Section 4, “DSNM Command
Requirements.”
Working With Lists
The thread's overall task is to take a command and the input list of objects, and
transform them into an output list of objects with associated states and/or text. The two
predefined list structures available in the command context area are:
•
The input object list, extracted by the frame from the command buffer.
•
The output object list, filled in by the thread as a result of processing the command;
it is initially empty.
As shown in Figure 3-6, list members are logically ordered. The first member is the
earliest item placed on the list; the last member is the latest. Each member has a
successor and a predecessor, the predecessor of the first and the successor of the last
being _NULL.
Z^RESULT Contains the result code for the object in the response buffer. It
may be a ZDSN^ERR value (see Appendix B, “DSNM Error
Codes”), a ZDSN^STATE value, or null (zero).
Z^SUBSYS Is the subsystem to which the object belongs.
Z^OBJTYPE Is the subsystem object type of the object.
Z^OBJNAME Is the object name, blank-filled.
Z^MANAGER Is the name of the manager, if any, blank-filled.
Note. Z^OBJNAME^OCCURS and Z^MANAGER^OCCURS are present in the output object
structure, but they need not be filled in.