Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

Adding Text Items to an Output Object:
_APPEND^OUTPUT
3-32
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
I Process Development Process
Adding Text Items to an Output Object: _APPEND^OUTPUT
For some commands, text and other variable-length items must be appended to the
output object with _APPEND^OUTPUT:
Text items are described fully under the individual command descriptions in Section 4,
“DSNM Command Requirements.”
Releasing Output List Members to the Frame: _RELEASE^OUTPUT
_RELEASE^OUTPUT releases a member of the output list to the frame. Once released,
the output list member can be removed by the frame at the next frame return. Each
output list member should be released as soon as it has been filled in completely.
The frame cannot remove an output list member that has an unreleased predecessor.
Thread termination releases all output list members.
Example: List Processing Library Services
The following sample code illustrates _FOBJECT^INIT and some of the list processing
library services described above. In this example, each input object and its hierarchical
subordinates are to appear in the output for a STATUS command:
STRUCT input^lm^def (*);
BEGIN
_INPUT^LM^HEADER;
...
END;
STRUCT output^lm^def (*);
BEGIN
_OUTPUT^LM^HEADER;
...
END;
error := _APPEND^OUTPUT ( output-list-member
,type
,[ header ]
,[ header-len ]
,[ body ]
,[ body-len ] );
_RELEASE^OUTPUT ( output-list-member );