TRANSFER Reference Manual

SCAN-FOLDER-BY-KEY
TISERV UOW Descriptions
2–476 069139, Update 1 to 40969 Tandem Computers Incorporated
SCAN-FOLDER-BY-KEY Example
The following example illustrates the operation of the SCAN-FOLDER-BY-KEY UOW.
Six items are stored in a folder with an APPLIC-DEFINED ordering discipline.
The items are stored as shown in Table 2-21.
Table 2-21. SCAN-FOLDER-BY-KEY Sample Items
Item Ordering Key Length Ordering Key Duplicate Indicator
First-item 4 TERM
Second-item 4 TERM First-dup
Third-item 4 TERM Second-dup
Fourth-item 7 TERM244
Fifth-item 7 TERM245
Sixth-item 7 TERM246
To scan the first five items in the folder, issue a SCAN-FOLDER-BY-KEY UOW with
the following values:
Set SKIP-EXACT to N (suggested value for initial call)
Set DUPLICATE-RESTART to N (for initial call)
Set NUM-REQUESTED to 5 (request for 5 items)
Set STARTING-KEY-LEN to 0 (to retrieve the first item in the folder)
Set GENERIC-KEY-LEN to 0 (generic matching is not used)
Set MAX-KEY-LEN to 6 (maximum number of bytes to be retrieved)
Set PAD-CHAR to *
Ignore STARTING-DUPLICATE and set DUPLICATE-RESTART to N
Ignore STARTING-KEY and set STARTING-KEY-LEN to 0