TRANSFER Reference Manual

GET-ITEM-COMPNT-A01
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–273
ITEM-ID
identifies the parent item to which the components belong. To refer to an item
produced by a previous UOW within the same IPC, you can replace ITEM-ID with
ITEM-HANDLE, which is defined in the “Commonly Used Fields” subsection of
this manual.
START-POSITION
is the relative position in the components list of the first item for which data is to
be returned.
OPTIONS
provides criteria for selecting component items by ITEM-TYPE or by COMPNT-
TYPE. ITEM-TYPE is a numeric value that the application defines and then
assigns to the item through the CREATE-ITEM UOW. COMPNT-TYPE is a
numeric value that the TRANSFER delivery system saves with the component
when the component item is attached to the parent through the ATTACH-
COMPNT-A01 UOW.
In these options, the entry Y selects the option, and the entry N suppresses the
option.
To select filtering by item type:
1. Set FILTER-BY-ITEM-TYPE to Y.
2. Set ITEM-TYPE to the item type to be retrieved.
To select filtering by component type:
1. Set FILTER-BY-COMPNT-TYPE to Y.
2. Set COMPNT-TYPE to the component type to be retrieved.
NUM-REQUESTED
is the total number of component items for which data is to be returned, starting
with the item indicated by START-POSITION. For example, to return ten
components beginning with the component at relative position six, set START-
POSITION to 6 and NUM-REQUESTED to 10. The NUM-REQUESTED field can
contain values ranging from 1 through 400; the value in this field directly affects
the size of the response.