E@DBLOCKSUBRNG

Name

The E@DBLOCKSUBRNG call has the following format:

DN@<Logical>(E@DBLOCKSUBRNG)

where <Logical> identifies the database file to use to perform the E@DBLOCKSUBRNG call.

Description

E@DBLOCKSUBRNG performs similarly to the E@DBLOCKBEGRNG, but it allows for more precision in defining the range, because it lets you specify beginning and ending values on the last key field defining the range.

Using the API in a Program

E@DBLOCKSUBRNG must be paired with E@DBLOCKNXTRNG.

You must populate the delimiting D@ fields and E@DBBEGRNG before using E@DBLOCKSUBRNG.

Input Values

Field	Description
<Logical>	You must specify the database index name that you want to create a record in.
Record retrieval variables (also known as D@ fields)	Define the beginning and ending values of the last key by moving the appropriate values to the record retrieval fields named D@<KeyFieldName>.
E@DBSUBRNG	Move a number into E@DBSUBRNG in order to tell the interface which key is the last significant one defining the range. This number is equivalent to the position of the field in the index.

Return Values

Field	Description
D<prefix>@NOTFOUND – or – E@KEY@FOUND	The Modify 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.