Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

Requesting Status About a List
3-28
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
I Process Development Process
Joining Two Lists: _JOIN^LIST
Use _JOIN^LIST to append all members of a source list to a destination list. When two
lists are joined, data is not moved in memory. The source list is empty afterwards.
Requesting Status About a List
Use the following library services to get information about lists.
Determining if a List is Empty: _EMPTY^LIST
_EMPTY^LIST is a Boolean value that is TRUE if list has no members.
Determining the Number of List Members: _MEMBERSOF^LIST
_MEMBERSOF^LIST is the type INT(32) number of members currently in a list.
Initializing Object List Members: _FOBJECT^INIT
Every subsystem object processed by DSNM is defined by the contents of a
ZDSN^DDL^FOBJECT^DEF structure, known as a “formatted object” or “FOBJECT
structure.” The FOBJECT structure contains fields used directly by the command thread
(and internal fields used by the I process frame and libraries).
It is important that every object processed by the command thread be represented in a
properly initialized FOBJECT structure. Objects on the input list sent to the command
thread by the frame are correctly initialized at the time the command thread is first
dispatched.
Each object on an intermediate list or on the output list must also be represented in an
FOBJECT structure that has been correctly initialized from a previously initialized
source FOBJECT.
The source FOBJECT structure may define the same object that the new FOBJECT
structure defines, or a parent object from which a new object has been derived. “Parent”
here means the parent of the new object in a name hierarchy, which includes the
subsystem hierarchy and an asterisk (*) object name, if supported by your I process.
error := _JOIN^LIST ( dest-list
,source-list );
_EMPTY^LIST ( list )
_MEMBERSOF^LIST ( list )