E@DBLOCKMIDRNG

Name

The E@DBLOCKMIDRNG call has the following format:

DN@<Logical>(E@DBLOCKMIDRNG)

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

Description

When you need to update a range of data, starting at a given point in the range, use E@DBLOCKMIDRNG. The E@DBLOCKSUBRNG retrieves the first database record in the specified range and readies it for updating by an E@DBSTORE routine.

Using the API in a Program

You can use E@DBLOCKMIDRNG in a sequence with E@DBFINDSUBRNG and E@DBLOCKNXTRNG

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

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@DBBEGRNG Move a number into E@DBBEGRNG 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.