E@DBLOCKBEGRNG
Name
The E@DBLOCKBEGRNG call has the following format:
DN@<Logical>(E@DBLOCKBEGRNG)
where <Logical> identifies the database file to use to perform the E@DBLOCKBEGRNG call.
Description
When you need to update a range of data without interruption, the E@DBLOCKBEGRNG routine retrieves the first database record in the range and readies it for updating by an E@DBSTORE routine.
Using the API in a Program
E@DBLOCKBEGRNG must be paired with E@DBLOCKNXTRNG.
You must populate the delimiting D@ fields and E@DBBEGRNG before using E@DBLOCKBEGRNG.
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) |
You must populate the index key fields used to locate the record before using this call. Fill in only the D@ fields that define the appropriate range; leave empty those D@ fields that do not define the range. |
| 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. |
Programming Example
See E@DBLOCKNXTRNG.