The argument to be used in searching for a key was given in the KEY, KEYGE, or KEYGT specifier of a READ statement. However, the length of this argument is greater than the length of the key of reference.
The term key of reference means the key (that is, certain positions within the record) that was used for the direct retrieval of the record that was to be read. The key of reference is indicated by the keyid, which is the relative position of the start-end pair for this key within the start-end pairs listed in the KEYS specifier on the OPEN statement. The key of reference can be established through the KEYID specifier on a direct retrieval READ statement and remains in effect until it is changed in another direct retrieval READ statement. The keyid value is 1 if it has not been specified since the file was connected.
If neither the ERR nor the IOSTAT specifier is present on the I/O statement, the condition is signaled. If the condition is unhandled, the application is terminated.
Qualifying Data: The basic set of four qualifying data for I/O conditions as shown in Table 1. Within this basic set, statement has a value of READ, and parm_count has a value of 7. In addition, there are these qualifying data:
| No. | Name | Input/ Output | Data Type and Length | Value |
|---|---|---|---|---|
| 5 | key-desc | Input | Q_DATA_DESC | The q_data descriptor for key. It contains the data type and the length of key. |
| 6 | key | Input | See key-desc | Value of the key argument. The data type can be integer of length 1, 2, 4, or 8, or it can be character with any positive length not exceeding 255. |
| 7 | keyid | Input | INTEGER*4 | Value of the KEYID specifier. |
| Name | Action Taken after Resumption |
|---|---|
| RN | The current operation is ignored. The remainder of the deallocation list is processed and execution continues. |
Provide a search argument in the KEY, KEYGE, or KEYGT specifier whose length does not exceed that of the key of reference. If you want to search with a different key of reference, then for the KEYID specifier specify the ordinal number of the desired key's start-end pair in the KEYS specifier on the OPEN statement.
FOR1106