Manualshelf

TRANSFER Reference Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series
461462463464465466467468469470
READ-NEXT-NAME
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–427
READ-NEXT-NAME Operation
READ-NEXT-NAME scans the TRANSFER name directory and returns the next name
or group of names encountered on each call. You can use this UOW to display lists of
folder names, distribution list names, or correspondent names. In selecting names for
retrieval, this UOW supports wild-card matching of names. The following actions
depend on the version of the TRANSFER delivery system that processes your
READ-NEXT-NAME UOW:
Names on a node that runs TRANSFER version B40 are saved in the directory
according to the collating sequence configured for the TRANSFER system, and are
returned in this same order.
Names on a remote node that runs TRANSFER version B20 are returned in the
order in which they were stored; this is the order determined by the B20 collating
sequence.
Names on a remote node that runs a version of the TRANSFER delivery system
prior to B40 are skipped if they are invalid on versions prior to B40.
Names on a remote node that runs a B40 or later version of the TRANSFER
delivery system that are valid names for an earlier version of the TRANSFER
delivery system are returned, even if the names are not valid on the B40 node.
If the number of elements remaining in the list is less than or equal to the number
requested, or if no elements matching the searching criteria were found, the warning
W-EOF is returned in the RETN-CODE field.
In SCREEN COBOL programs, it is recommended that the response definition be used
as the definition for the UOW request. You accomplish this by setting the NUM-
RETURNED field to 0 before transmitting each request. This ensures that the length of
the response is the same as the length of the UOW.
If a name returned by this UOW is given back to the TRANSFER delivery system, only
the fully qualified form of this name is guaranteed to refer to the same object. If any
other NAME-FORMAT is specified, the name might cause a different object to be
identified.