E@DBLOCKPRV

Name

The E@DBLOCKPRV call has the following format:

DN@<Logical>(E@DBLOCKPRV)

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

Description

Once you have defined a position in the file with a successful E@DBLOCKNLT, use E@DBLOCKPRV to process the record previous to the current position. This routine reads the record preceding the current record for this index and prepares it for updating by E@DBSTORE.

Using the API in a Program

You must precede E@DBLOCKPRV 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.