TRANSFER Reference Manual

SCAN-FOLDER
TISERV UOW Descriptions
2–464 069139, Update 1 to 40969 Tandem Computers Incorporated
NUM-REQUESTED. The TRANSFER delivery system assigns only enough space
to accommodate the NUM-RETURNED elements in ITEMS-RETURNED. If
another UOW response follows this one in the same IPC, this next response begins
immediately after the element last returned.
SCAN-FOLDER Operation
SCAN-FOLDER retrieves the IDs of the items in the range denoted by ITEM-ID and
NUM-REQUESTED and places these IDs in the array named ITEMS-RETURNED. If
the items in the folder are ordered by creator name, they are returned in the order
determined by the configured collating sequence. The OPTIONS structure allows you
to selectively retrieve items of a particular type.
The number of items returned might be smaller than the number requested because
the folder contains fewer items than specified in NUM-REQUESTED; in this case, the
W-EOF warning is returned in the RETN-CODE field.
You can use the last item ID returned in ITEMS-RETURNED as input in ITEM-ID for
the next request.