Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-97
_PUT^LM
_PUT^LM
_PUT^LM allocates memory for a new last member of a list and returns its address.
_NULL is returned if no memory is available for a new list member.
list-member returned value
INT .EXT
is the address of the new member.
list input
is the name of a _LIST.
length input
INT:value
is the length of the new member, in bytes.
initlength input
INT:value
is the number of bytes of the new member to be initialized (to the contents of
initdata, if present): otherwise, it is initialized to 0s.
initdata input
INT .EXT
is a structure or an array containing initial data for the list member.
Considerations
•
If length is not provided, initlength is taken as the length of the new
member, as well as the initializing length.
•
Normally, a list is processed either by _PUT^LM plus _GET^LM or by _PUSH^LM
plus _POP^LM, but not both.
•
_PUT^LM, if used with _POP^LM, deallocates and reuses the memory assigned to
the last element removed by _POP^LM.
@list-member := _PUT^LM ( list
,[ length ]
,initlength
,[ initdata ] );