TRANSFER Reference Manual

SCAN-FOLDER-B40
TISERV UOW Descriptions
2–468 069139, Update 1 to 40969 Tandem Computers Incorporated
ITEMS-RETURNED
is an array that contains the IDs and the unsave time of the items retrieved from
the folder. The size of this array must be consistent with the number of items
requested, as defined in 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 last element returned.
UNSAVE-TIME
is the time when the item is automatically removed from the folder. The date and
time returned is in absolute (timestamp) format. If the item has no unsave date
and time, all fields of UNSAVE-TIME are set to 0.
SCAN-FOLDER-B00 Operation
SCAN-FOLDER-B00 retrieves the IDs and unsave times of the items in the range
denoted by ITEM-ID and NUM-REQUESTED and places these values 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 only 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.