850-MODIFY-BEGRNG-<Index>

Name

Description

When you need to update a range of data without interruption, the 850-MODIFY-BEGRNG-<Index> routine retrieves the first database record in the range and readies it for updating by an 820-STORE-<FileName> routine.

Using the API in a Program

850-MODIFY-BEGRNG-<Index> must be paired with 860-MODIFY-NXTRNG-<Index> .

You must populate the delimiting DB fields and WS-DB-BEG-RNG before using 850-MODIFY-BEGRNG-<Index> .

Input Values


Field	Description
<Index>	You must specify the database index name that you want to create a record in.
Record retrieval variables (also known as `DB` fields)	You must populate the index key fields used to locate the record before using this call. Fill in only the `DB` fields that define the appropriate range; leave empty those `DB` fields that do not define the range.
WS-DB-BEG-RNG	Move the symbolic constant <IndexName>-<IndexFieldName> to the field WS-DB-BEG-RNG in order to tell the interface which key is the last significant one defining the range. The symbolic constant is numerically equivalent to the position of the named field in the Index.

Return Values


Field	Description
<FileName>-SW	The Modify routines set the <FileName>-SW switch to indicate the outcome of the read. This routine sets the logical value <FileName>-NOTFOUND or <FileName>-FOUND based on the outcome of the read process.

Programming Example

See 860-MODIFY-NXTRNG-<Index>.