TRANSFER Reference Manual

GET-ITEM-REC
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–301
ITEM-ID
is the item ID of the item to which the record belongs.
REC-TYPE
is the type assigned to the record. REC-TYPE describes what kind of record is
being accessed. The TRANSFER delivery system stores REC-TYPE with the
item record but does not interpret the field. The TRANSFER delivery system
stores records in increasing order by REC-TYPE, and stores records in
increasing order by REC-SEQ-NUM within each REC-TYPE.
The values 100 through 999 are assigned for use by Tandem application
packages, such as PS MAIL. You can use these values in the REC-TYPE field,
but they should have the same meaning for your application as they do for
Tandem application packages. These record types include subject text,
forward and response text, and unformatted ASCII text. An item can contain
records of many different types and multiple records of the same type.
REC-SEQ-NUM
is the sequence number to be assigned to the record. The number can range from
1 through 9999; the value 0 is invalid for this field. This field provides unique key
values for multiple records having the same ID and record type. 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.
OPTIONS
provides criteria for selecting the item data records.
SKIP-EXACT
determines whether TISERV begins its retrieval with the record specified or
the record after the one specified.
Y Begin retrieval with the record after the record specified.
N Begin retrieval with the record specified.
If the beginning record (specified by STARTING-KEY) is not present in the
file, the record after the one specified is retrieved, regardless of the setting of
SKIP-EXACT.
ANY-REC-TYPE
determines whether records not having the record type specified in
STARTING-KEY also can be returned.
Y Records of record type greater than REC-TYPE also can be returned.
ANY-SEQ-NUM is ignored. The TRANSFER delivery system
retrieves up to NUM-REQUESTED records of type REC-TYPE with a