TRANSFER Reference Manual

WHERE-SAVED
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–515
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 Operation
WHERE-SAVED returns, in the array named FOLDERS-RETURNED, the names of
folders that contain the item identified by ITEM-ID. The UOW begins retrieval with
the next folder that follows the folder denoted by PREV-FOLDER, and obtains as
many folder names as the number indicated by NUM-REQUESTED. Only folders
within the depot represented by the current session are considered.
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.