TRANSFER Reference Manual

Commonly Used Fields
TISERV UOW Descriptions
2–12 069139, Update 1 to 40969 Tandem Computers Incorporated
A reference with ITEM-HANDLE can fail in all of the same ways a reference with
ITEM-ID can fail. In addition, the following special cases can occur:
If you use an item number that is less than the number of items requested in the
UOW being referenced but greater than the number of items actually returned by
the UOW being referenced, the warning W-ITEM-NOT-RETURNED (-4063) is
returned.
An item handle cannot refer to an item returned after the twentieth UOW that
produces an item within the same IPC. This reference produces the error E-
INVALID-ITEM (4062).
UOW numbers and item numbers that are otherwise out of range produce the
error E-INVALID-ITEM (4062).
If you refer to an item that was deleted between its return and the attempted
reference with ITEM-HANDLE, one of the following errors is returned, depending
on the UOW you specified:
4035 E-ITEM-NOT-FOUND
4037 E-PARENT-NOT-FOUND
4039 E-COMPNT-NOT-FOUND
For example, to scan a folder and then save an item found there into another
folder, your process would perform these steps:
1. Specify the SCAN-FOLDER UOW.
2. Specify one of the SAVE-ITEM UOWs using ITEM-HANDLE in place of
ITEM-ID. If you issued SCAN-FOLDER immediately before SAVE-ITEM, and
you wanted to save the second item returned in the other folder, you would
set UOW-NUMBER to -1 and ITEM-NUMBER to 2.
3. Send the IPC to TISERV.
PIC 9(4) COMP Fields For programs that are written in languages other than COBOL and SCREEN COBOL,
fields defined as PIC 9(4) COMP must contain values in the range of 0 through 9999.
In TAL, for example, these fields would have a type of INT, but if you enter a value
outside this range, the TRANSFER delivery system returns an error.