Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

_SUCCESSOR^LM
A-122
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_SUCCESSOR^LM
_SUCCESSOR^LM returns the address of the list member placed on the list
immediately after the current list member was added.
next-list-member returned value
INT .EXT
is the address of the successor list member.
list input
is the name of a _LIST.
list-member input
INT .EXT
is a pointer to a current member of list.
Considerations
•
List members are logically ordered. The first (or front or head) member is the
earliest put on the list and the last (or end or tail) member is the latest. Each
member has a successor and a predecessor, the predecessor of the first and the
successor of the last being _NULL.
•
list-member must be a current member, or @list-member must be _NULL.
If @list-member is _NULL, the address of the first member of list is
returned.
•
Successive list members are not necessarily stored at increasing memory addresses.
You cannot determine the order of list members by comparing their addresses.
•
_SUCCESSOR^LM returns _NULL if one of the following is true:
•
list-member is the last member of list.
•
list is empty.
•
An error occurs.
@next-list-member := _SUCCESSOR^LM ( list
,list-member );