ENABLE Reference Manual

THE GENERAL SERVER
Usage-Dependent Fields
KEY-SPECIFIER Field
This field applies to a READ operation (code 1), UPDATE operation
(code 2), and DELETE operation (code 3). The requester must
supply the two-byte key specifier for the current key of
reference in this field. Supplying binary zero indicates the
primary key.
COMPARE-LENGTH Field
This field applies to a random READ operation (code 1). A
random READ operation is one with a FUNCTION-CODE equal to EX,
AP, AG, or GN. For each random READ, the requester must set
this field to the byte length of the leading portion of the
supplied key value. For READ EXACT and READ APPROXIMATE only,
a zero value indicates the total defined key length is to be
used. For READ APPROXIMATE Generic, the value of this field
corresponds to the length of the key to be used to establish a
keyset for future READ operations.
RECORD-LENGTH Field
This field applies to an open operation (code 0), a read
operation (code 1), an UPDATE operation (code 2), a DELETE
operation (code 3), and an INSERT operation (code 4).
If the requester sets this field to zero before the open
operation, the General Server returns the expected value for
RECORD-LENGTH in this field. The expected value is the byte
length of the record for the file being opened. For unstructured
files without the ODDUNSTR attribute, this value is rounded up by
one byte if the byte length is an odd number.
The requester should not change the value of this field for any
other operation. The General Server sets this field to the
length of the record read in for a READ operation.
E-11