TRANSFER Reference Manual

GET-ITEM-REC-B40
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–309
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.
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
automatically padded 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. MAX-DATASIZE can contain
values ranging from 0 through 2000. 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.
PAD-CHAR
is the character used to pad returned records that are shorter than the maximum
length specified by MAX-DATASIZE.
RETN-CODE
is the return code. TISERV returns a code in this field to indicate one of the
following entries.
0 OK
-4001 W-EOF
4035 E-ITEM-NOT-FOUND
4051 E-MUST-BE-YN
4052 E-RESERVED-MUST-BE-N
-4086 W-DATASIZE-ADJUSTED
4087 E-INVALID-MAX-DATASIZE
-4089 W-DATA-TRUNCATED
4092 E-INVALID-NUM-RQSTD
4110 E-INVALID-CODE-CONV
4116 E-PRIMARY-NOT-FOUND
4119 E-EXTOBJ-ERR
4127 E-NO-ATTACHMENT
4128 E-MUST-BE-ALTERNATE
4133 E-NOT-EDIT-FILE
4470 E-BAD-ID-OR-PASSWORD
To indicate problems with an item handle:
4062 E-INVALID-ITEM
-4063 W-ITEM-NOT-RETURNED