E@DBFINDEQ
Name
The E@DBFINDEQ call has the following format:
DN@<Logical>(E@DBFINDEQ)
where <Logical> identifies the database file and index to use to perform the E@DBFINDEQ call.
Description
E@DBFINDEQ reads the single database record whose key fields equal the values you set in the record retrieval variables (D@ fields) corresponding to the index key fields. Because this call looks for a specific record, all D@ fields must have a value entered before performing the routine.
Input Values
Field | Description |
---|---|
<Index> | <Logical> identifies the database file and index to use to perform the E@DBFINDEQ call. |
Record retrieval variables (also known as D@ and D# 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
The following example shows the call used to retrieve a record from the GLMASTER file (DBIFGLM).
|