TRANSFER Reference Manual

GET-ITEM-REC
TISERV UOW Descriptions
2–302 069139, Update 1 to 40969 Tandem Computers Incorporated
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.
RESERVED-3
is reserved for use by Tandem. This field must be set to N.
NUM-REQUESTED
specifies the number of records to be returned. This value affects the length of the
response. The records are returned starting with the lowest record type and
lowest sequence number matching the STARTING-KEY and OPTIONS selected.
All records within a record type are returned in sequence number order before
records of the next higher record type. For example, if the fields in GET-ITEM-
contain the following values:
REC-TYPE set to 2,
REC-SEQ-NUM set to 0,
SKIP-EXACT set to N,
ANY-REC-TYPE set to N,
ANY-SEQ-NUM set to Y,
NUM-REQUESTED set to 6.
the records in Figure 2-4 could be returned.