READKGP (XFILE)

9.0D

The READKGP instruction reads, in reverse order, records that meet the key criteria for a previous XFILE READ. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

xfile

Required. A previously defined and opened XFILE variable from which data is read.

field

Optional. The name of a field.

var

Optional. A previously defined Character String Variable, Numeric Variable, string or numeric ARRAY, or individual array element.

rs

Optional. The name of a recordset.

listctl

Optional. A supported list control.

;

Optional. indicates Partial I/O.

Flags Affected: OVER

Note the following:

1. If READKGP is performed prior to a valid XFILE READ instruction, an I/O error occurs.

2. Once no further records meet the original XFILE READ criteria, the OVER Condition Flag is set to TRUE.

3. The remainder of the statement syntax is the same as a READ statement.

See Also: XML Support