Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-71
_LIST
_LIST
_LIST declares a list structure.
list user-provided identifier
is the name (a valid TAL identifier) of the structure that _LIST declares.
Considerations
•
The data structure known as a “list” is the basis for the I process program-
development software memory-management facility. A list consists of the structure
declared with _LIST and the list members.
•
The list structure holds control information, used by the list library procedures.
Its size and structure are fixed.
•
A list member is a block of memory, the size and description of which are
determined when the member is created with _PUT^LM or _PUSH^LM.
•
The following procedures and defines use list to extract information about and
perform operations on list members:
_DEALLOCATE^LIST (list)
_DELETE^LM (list, @list-member)
_EMPTY^LIST (list)
_FIRST^LM (list)
_GET^LM (list, [length])
_INITIALIZE^LIST ( list )
_JOIN^LIST (source-list, dest-list)
_LAST^LM (list)
_MEMBERSOF^LIST (list)
_POP^LM (list, [length])
_PREDECESSOR^LM (list, list-member)
_PUSH^LM (list, [length], initlength ,[initdata])
_PUT^LM (list, [length], initlength, [initdata])
_SUCCESSOR^LM (list, list-member)
_UNGET^LM (list, list-member)
_UNPOP^LM (list, list-member)
Example
See the example for _FOBJECT^INIT for list and list member declarations.
_LIST ( list );