TRANSFER Reference Manual

WHERE-SAVED-C20
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–519
FOLDERS-RETURNED
is an array that contains the folder names returned by TISERV. The size of this
array must be consistent with the value specified in NUM-REQUESTED. The
array begins with the folder that follows the folder specified in PREV-FOLDER
and that contains the item. The TRANSFER delivery system assigns only enough
space to accommodate the NUM-RETURNED elements in FOLDERS-RETURNED.
If another UOW response follows this one in the same IPC, this next response
begins immediately after the element last returned.
Note Because TISERV retrieves the folders in order of their internal identification, the folder names are not
arranged in any readily apparent sequence in this array.
WHERE-SAVED-C20 Operation
WHERE-SAVED-C20 returns a list of folders to which the correspondent has access
and which contain an instance of the specified item. An array of folder names is
returned, which starts with the folder following the folder specified in which the item
is saved. Retrieval is according to the order of folder identifiers; therefore, retrieved
folder names are not in any particular order.
If the complete set of folder names in which an item is saved is to be retrieved in
multiple requests, you can use the last folder name returned from one request as input
for the next request.
The number of folders returned might be smaller than the number requested because
there are no more folders that contain the item. In this case, the W-EOF warning is
returned in the RETN-CODE field.