TRANSFER Reference Manual

Commonly Used Fields
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–11
ITEM-HANDLE Field To refer to an item produced by a previous UOW within the same IPC, you can replace
ITEM-ID with ITEM-HANDLE. You can also use an ITEM-HANDLE to refer to an
external object. ITEM-HANDLE is defined as follows:
DEF item-handle.
02 handle-flag PIC X(8). !VALUE HIGH-VALUES
02 uow-number TYPE BINARY 16.
02 item-number TYPE BINARY 16.
END.
HANDLE-FLAG
distinguishes the item handle from a standard item ID.
UOW-NUMBER
identifies the UOW that produced the item to which you are referring. A positive
number is the ordinal of the UOW within the current IPC. The number 1
represents the first UOW. A negative number is the sequence position of the
UOW being referenced, counting back from the UOW currently being processed.
For example, -1 represents the UOW immediately before the UOW currently being
processed, while -2 indicates the UOW two UOWs back. Zero is not a valid value.
ITEM-NUMBER
identifies the item to which you want to refer within the UOW being referenced.
A positive number is the ordinal of the item among the items returned in either an
ITEM-ID field or an ITEMS-RETURNED array of the response UOW that
produced the items. The number 1 represents either the first item or the only item
in the UOW that always returns a single item. A negative number is the sequence
number of the item within the UOW to which you are referring, counting back
from the last item returned: the number -1 represents the last item in the UOW, -2
the next-to-the-last item, and so forth. Zero is not a valid value.
Note Negative sequence numbers point only to items actually returned. If, for example, you request 10 items
and only 5 are returned, -1 refers to the fifth item returned, not the tenth item requested; -2 refers to the
fourth item returned, not the ninth item requested.
You can substitute an item handle for the standard item ID in any UOW that, within
the same IPC, follows the UOW whose item you want to reference. An item handle is
valid only within one IPC.
You can use an item handle more than once, either in the same UOW or in successive
UOWs after the one that produced the item being referenced.