TRANSFER Reference Manual

READ-NEXT-MEMBER
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–421
READ-NEXT-MEMBER Operation
The READ-NEXT-MEMBER UOW retrieves the names of members from the
distribution list identified by DLIST-NAME in a range identified by START-MEMBER
and NUM-WANTED. To begin a retrieval with the first member on the list, set the
START-MEMBER field to spaces. The names of the retrieved members are stored in
the array MEMBER-NAME. Names are stored in a distribution list according to the
collating sequence configured for the TRANSFER system, and are returned in this
same order.
If there are X400 members of the requested distribution list, the warning W-X400-
NAMES is returned in the RETN-CODE-DETAIL field and W-EOF is returned in the
RETN-CODE field. Clients can determine whether X400 recipients exist without
requesting the GET-X400-RECIP UOW.
If a shared distribution list name is specified, the current correspondent must be one of
the following:
The creator of the distribution list, if the creator of the distribution list is currently
a member of the group
A group administrator or system administrator with write privileges on the node
where the list was created
A member of the group that owns the voluntary sign-up distribution list, and the
name being added is the correspondent's own name
Otherwise, if a shared distribution list name is specified, an E-SECURITY-
VIOLATION error is returned.
If you attempt to update a group's MEMBERS or ADMIN distribution lists, an
E-SECURITY-VIOLATION error is returned. Only the TRANSFER delivery system
has the authority to update these special distribution lists.
The response is constructed so that it can also act as a request. To use a response in
this way, set NUM-RETURNED to 0 and retransmit the UOW. The START-MEMBER
and START-TYPE fields are set up to cause proper action on the next call; thus, you
need not alter these fields after the first call. Because of this two-way feature, those
fields that contain only return values are specified as filler fields in the request.
If the number of elements remaining in the list is less than or equal to the number
requested, or if no names were found, the warning W-EOF is returned in the RETN-
CODE field.