TRANSFER Reference Manual

READ-NXT-GROUP-MBR
TISERV UOW Descriptions
2–416 069139, Update 1 to 40969 Tandem Computers Incorporated
MEMBER-IS-ADMIN
specifies whether the group member has group administrative privileges:
Y The interest group member has group administrative privileges.
N The interest group member does not have group administrative
privileges.
MEMBER-IS-GROUP
specifies whether the interest group member is a correspondent or a group.
Y The interest group member is a group.
N The interest group member is a correspondent.
READ-NXT-GROUP-MBR Operation
READ-NXT-GROUP-MBR retrieves the names of local members of a group and
indicates which members have group administrative privileges. (Correspondents that
are either direct or indirect group members can have group administrative privileges.)
Any correspondent can issue this request for a local interest group.
READ-NXT-GROUP-MBR retrieves from the interest group identified by
GROUP-NAME the names of group members in the range identified by
START-MEMBER and NUM-WANTED, filtered by the criteria specified in FILTER-
OPTIONS. 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
GROUP-MEMBERS array. Because storage is by internal identifiers and not by
member names, retrieved member names are not returned in any particular order.
The response is constructed so that it can also be used as a request. To use a response
in this way, set NUM-RETURNED to 0 and retransmit the UOW. The START-TYPE
and START-MEMBER fields are set up to cause proper action on the next call;
therefore, you need not alter these fields after the first call. Retrieval of names is
performed in the order of member internal identifiers; therefore, retrieved names are
not returned in any particular order.
Direct group members are those correspondents and groups that are added directly as
group members with the ADD-GROUP-MEMBER UOW. Indirect group members are
correspondents that are members of a group as a result of nested group membership
(that is, a group as a member of a group). EXPANSION-OPTION allows you to
retrieve the names of members who are direct group members (the default action) or
the names of direct and indirect group members (expansion of group membership).
Retrieval of member names from remote interest groups is not supported. If a remote
group is specified in GROUP-NAME, E-GROUP-NOT-SAME-NODE is returned.
If the number of elements remaining in the list is less than or equal to the number
requested, or if no names are found, the warning W-EOF is returned in the RETN-
CODE field.