
1-56
Status Codes
6: The key number parameter is invalid
The value stored in the key number parameter is not valid for the file
being accessed. The key number must correspond to one of the keys
defined for the file. Valid key numbers are 0 through 118.
7: The key number has changed
The key number parameter changed before a Get Next, Get Next
Extended, Get Previous, or Get Previous Extended operation. The
operation requires the same key number parameter as the previous
operation, because the MicroKernel uses positioning information
relative to the previous key number.
In a related situation, the MicroKernel returns this status code when
an application performs a Delete or Update operation immediately
following a Get operation. If the application changes the value of the
key number in the Delete or Update operation (from the value used
with the preceding Get operation), the MicroKernel deletes or
updates the record as requested and does not return this status code,
at least not at this point. However, the MicroKernel does return this
status code on the very first Get Next, Get Next Extended, Get
Previous, or Get Previous Extended operation performed after the
deletion or update, even if that Get operation uses the same key value
the application passed to the Delete or Update operation.
If you need to change key numbers between consecutive Get Next,
Get Next Extended, Get Previous, or Get Previous Extended
operations (or in Delete or Update operations as described in the
preceding paragraph), use a Get Position operation followed by a Get
Direct/Record operation to reestablish positioning for the new index
path.
8: The current positioning is invalid
You must establish the current position in order to update or delete
a record. Perform a Get or Step operation to establish the current
position. The MicroKernel also returns this status code if the
application passed an invalid position block for the file.
9: The operation encountered the end-of-file
The MicroKernel returns this status code in the following situations:
Commenti su questo manuale