TRANSFER Reference Manual

GET-ITEM-REC-B40
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–307
HDR
is the UOW header. The UOW-CODE value is 148.
STARTING-KEY
identifies the first possible item data record that can be retrieved. The record is
determined by the ITEM-ID, REC-TYPE, and REC-SEQ-NUM specified. 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 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
record sequence number greater than or equal to REC-SEQ-NUM or
with type greater than REC-TYPE and any sequence number.
N Only records of type REC-TYPE are returned.
ANY-SEQ-NUM
is meaningful only if ANY-REC-TYPE is set to N.
If ANY-REC-TYPE is set to N and ANY-SEQ-NUM is set to N, one record
at most is returned. If SKIP-EXACT is set to N, the record matches the
REC-TYPE and REC-SEQ-NUM specified in STARTING-KEY.
If ANY-REC-TYPE is set to N and ANY-SEQ-NUM is set to Y, up to NUM-
REQUESTED records of type REC-TYPE with sequence numbers greater
than or equal to REC-SEQ-NUM are returned.