ISMSETUPLIMIT defines the upper bounds of the file. This logical end-of-file (EOF) is set only for the key defined by KEYOFREF. The user's RECORD contains the value of the upper bound. If UPPERLIMIT has a value and an attempt is made to access beyond this limit, an end-of-file (EOF) condition is returned.
The ISMSETUPLIMIT procedure requires the following parameters to return a set-upper-limit result:
ISMSETUPLIMIT (ISAMFILE, KEYOFREF, KEYLEN, RECORD)
-
ISAMFILE—The user's file.
-
KEYOFREF—Contains the key information used to carry out key comparisons. The key length must be set in [31:16]. Refer to the key information under “KEYEDIO Procedures.”
-
KEYLEN—Specifies the length of the entire record.
-
RECORD—The user's record area.
The set-upper-limit result value is listed as follows:
|
Field |
Value |
Result [26:10] |
Mnemonic |
Meaning |
|---|---|---|---|---|
|
[9:1] |
1 |
98 |
KEYISINVALID |
KEYOFREF did not match any of the keys. Bit 0 will also equal 1. |
