E@DBKFNDNXT
Name
The E@DBKFNDNXT call has the following format:
DN@<Logical>(E@DBKFNDNXT)
where <Logical> identifies the database file and index to use to perform the E@DBKFNDNXT call.
Description
Once you have defined a position in the file with a successful E@DBKFNDGE, use the E@DBKFNDNXT routine to process database records sequentially in Index order. This routine reads the record following the current record for this index, but returns only the keys from the index.
Using the API in a Program
E@DBKFNDGE must be paired with a E@DBKFNDNXT.
Input Values
| Field | Description |
|---|---|
| <Logical> | <Logical> identifies the database file and index to use to perform the call. |
| Index key fields | You must populate the index key fields used to locate the record before using this call. |
Return Values
| Field | Description |
|---|---|
| D<prefix>@NOTFOUND |
Each routine sets the logical value <FileName>-NOTFOUND or <FileName>-FOUND based on the outcome of the read process. The Find routines set D<prefix>@NOTFOUND to FALSE if a record is found, TRUE if a record is not found, or E@KEY@FOUND if the keys are found. |
Programming Example
For an example of programming, see E@DBFINDNXT.