Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

I Process Development Process
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 3-27
Maintaining a List
First-In First-Out Processing: _PUT^LM / _GET^LM
Use _PUT^LM to allocate memory for a new last member of a list. Use _GET^LM to
remove the current first member from a list (the earliest member put on the list).
Last-In First-Out Processing: _PUSH^LM / _POP^LM
Use _PUSH^LM to allocate memory for a new last member of a list. Use _POP^LM to
remove the current last member from a list (the most recent member put on the list).
_PUSH^LM deallocates and reuses the memory assigned to the last element removed by
_POP^LM.
Maintaining a List
Use the following library services to delete list members or to join lists.
Deleting a List Member: _DELETE^LM
Use _DELETE^LM to delete a member of a list. Deleting a member removes it from
the list and deallocates its memory immediately; list-member is set to null.
Deleting All Members of a List: _DEALLOCATE^LIST
Use _DEALLOCATE^LIST to delete all members of a list. Memory for the list
members is deallocated immediately.
@list-member := _PUT^LM ( list
,[ length ]
,initlength
,[ initdata ] );
@list-member := _GET^LM ( list
,[ length ] );
@list-member := _PUSH^LM ( list
,[ length ]
,initlength
,[ initdata ] );
@list-member := _POP^LM ( list
,[ length ] );
error := _DELETE^LM ( list
,@list-member );
CALL _DEALLOCATE^LIST ( list );