850-MODIFY-MIDRNG-<Index>
Name
850-MODIFY-MIDRNG-<Index>
Description
When you need to update a range of data, starting at a given point in the range, use 850-MODIFY-MIDRNG-<Index> . The 850-MODIFY-MIDRNG-<Index> retrieves the first database record in the specified range and readies it for updating by an 820-STORE-<FileName> routine.
Using the API in a Program
You can use 850-MODIFY-MIDRNG-<Index> in a sequence with 850-FIND-SUBRNG-<Index> and 860-MODIFY-NXTRNG-<Index>
You must populate the delimiting DB
fields and WS-DB-BEG-RNG
before using 850-MODIFY-MIDRNG-<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)
|
Define the beginning and ending values of the last key
by moving the appropriate values to the record retrieval fields named DB-
<KeyFieldName>.
|
|
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. |