TRANSFER Reference Manual

GET-ITEM-REC
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–303
Figure 2-4. Record Retrieval by GET-ITEM-REC
•
•
•
1,2,1
1,2,2
1,2,3
1,2,4
1,2,5
1,2,6
REC-TYPE
ITEM-ID
Starting Point
(STARTING-KEY)
Retrieval of all
records with
ID = 1, REC-TYPE = 2
Last-Record Limit
(NUM-REQUESTED)
REC-SEQ-NUM
004
•
•
•
MAX-DATASIZE
refers to the data portion of each record; this value is the maximum number of
bytes that can be retrieved. Records that are shorter than this length are padded
automatically with the padding character specified by PAD-CHAR. Records that
are longer than this length are truncated, but the length returned by DATA-LEN is
the actual length before truncation; W-DATA-TRUNCATION is returned.
You should specify an even-numbered maximum length so that all elements of the
returned array are word aligned. If you specify an odd-numbered maximum
length, the TRANSFER delivery system automatically increments this value by 1.
MAX-DATASIZE, like NUM-REQUESTED, affects the length of the response.
Note that the value of MAX-DATASIZE cannot exceed 2000.
PAD-CHAR
is the character used to pad returned records that are shorter than the maximum
length specified by MAX-DATASIZE.