TRANSFER Reference Manual

SCAN-BY-ITEM-NAME
TISERV UOW Descriptions
2–460 069139, Update 1 to 40969 Tandem Computers Incorporated
the same scan. 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, the next response
begins immediately after the element last returned.
SCAN-BY-ITEM-NAME Operation
SCAN-BY-ITEM-NAME retrieves information about one or more named items in a
folder. Only information about named items that meet the search criteria is returned;
other named items, and all unnamed items, are ignored. Clients typically issue this
UOW to retrieve the item ID associated with an item name in a particular folder.
The TRANSFER delivery system returns an item name or an array of such names,
starting either at the named item that you specify or at the next named item (the one
following the item specified). To start searching for the first item names that match the
SIMPLE-ITEM-NAME subfield of the QUALIFIED-ITEM-NAME field, set the FIRST-
CALL subfield to Y.
Alternatively, to continue a previous search from the point specified by the SIMPLE-
ITEM-NAME subfield of QUALIFIED-ITEM-NAME, set the FIRST-CALL field to N.
Also, the values returned for RECALL-MATCH-LENGTH and SIMPLE-ITEM-NAME
(NUM-RETURNED) in the previous response must be supplied as the values for
RECALL-MATCH-LENGTH and QUALIFIED-ITEM-NAME, respectively, in the next
request for this UOW.
To start the search with the first named item in the folder, enter a value of spaces or *
in ITEM-NAME and set FIRST-CALL to Y.
If the value of NUM-REQUESTED is 1, the TRANSFER delivery system assumes that
the QUALIFIED-ITEM-NAME will resolve to a unique name.
Items are returned in the order determined by the configured collating sequence by
item name; the folder's ordering criteria do not affect the order in which named items
are returned by this UOW.