E@DBLOCKNXT

Name

The E@DBLOCKNXT call has the following format:

DN@<Logical>(E@DBLOCKNXT)

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

Description

This routine sequentially process database records for updating in index order. It reads the record following the current record for this index and prepares it for updating by E@DBSTORE.

Using the API in a Program

You must precede E@DBLOCKNXT with E@DBLOCKGE.

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.

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.