Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-144
FILE_SETKEY_ Procedure
indicates a non-unique alternate key, the record is skipped only if both
its alternate key and its primary key match the corresponding portions
of the specified
key-value (which should be an alternate key value
concatenated with a primary key value) for
key-length bytes
(which should be the sum of the alternate and primary key lengths).
This option is not supported for positioning by primary key in relative or
entry-sequenced files.
<1> return records in descending key order. (The file is read in reverse.)
<2> specifies that positioning is performed to the last record in a set of
records. This bit is ignored unless <1> is also set.
If the
options parameter is omitted, 0 is used.
comparelength input
INT:value
is the length (in bytes) of the key used for comparing generic mode and exact-
positioning mode that is used to decide when to stop returning these records. The
value must be no longer than the
key-value-len value. If omitted or 0, the
value used is the smaller value of
key-value-len or keylength of the key
specified by the
keyspecifier parameter.
Considerations
The considerations for the KEYPOSITION[X] Procedures
(Superseded by FILE_SETKEY_ Procedure) apply to the FILE_SETKEY_ procedure.