TRANSFER Reference Manual

SCAN-FOLDER-BY-KEY
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–471
FILTER-BY-ITEM-TYPE
allows you to filter the scan by selecting only items of a given type from the
folder.
To select filtering, set FILTER-BY-ITEM-TYPE to Y and use the ITEM-
TYPE field to specify the item type.
To suppress filtering, set FILTER-BY-ITEM-TYPE to N.
In the response, the input to FILTER-BY-ITEM-TYPE and ITEM-TYPE is
echoed as output.
SKIP-EXACT
indicates whether TISERV begins its retrieval with the item specified by the
starting key fields or with the next item in the folder.
Y Start retrieval with the first item following the item specified by the
starting key fields (if that item is present) or with the first item
following (if the exact item is not present).
N Start retrieval with the exact item specified by the starting key fields
(if that item is present) or with the first item following (if the exact
item is not present).
In the response, SKIP-EXACT is set to Y.
DUPLICATE-RESTART
controls the use of the STARTING-DUPLICATE field.
Y The STARTING-DUPLICATE field is used in conjunction with
STARTING-KEY to identify the first item to return.
N The STARTING-DUPLICATE field is ignored.
On the initial call to SCAN-FOLDER-BY-KEY, set DUPLICATE-RESTART to
N. In the response, DUPLICATE-RESTART is automatically set according to
the last item returned in the current scan; use this setting for DUPLICATE-
RESTART in a request for a subsequent scan of the same folder.
The RESERVED-3 through RESERVED-7 fields in the OPTIONS structure are
reserved for use by Tandem. These fields are always set to N.