HP 3000 Manuals HP 3000 Manuals
Appendix A ERROR MESSAGES AND RECOVERY PROCEDURES
This appendix lists the error messages that may be issued as a result of
errors encountered while accessing KSAM files. The messages are not
limited to KSAM errors since other file system errors or language errors
can occur while accessing a KSAM file.
Whenever possible, the reason the message was issued is listed under
"Meaning" and any action that can be taken to correct the error is listed
under "Action."
The messages are contained in the following tables:
Table A-1 File System Error Codes
Table A-2 COBOL Status Returns
Table A-3 BASIC Status Returns
Table A-4 KSAMUTIL Error Codes and Messages
Table A-5 FCOPY Warning and Error Messages
Table A-1. File System Error Codes
-----------------------------------------------------------------------------------------------
| CODE | MEANING | ACTION |
-----------------------------------------------------------------------------------------------
| 0 | END OF FILE | |
| 1 | ILLEGAL DB REGISTER | |
| 2 | ILLEGAL CAPABILITY | |
| 3 | OMITTED PARAMETER | |
| 4 | INCORRECT S REGISTER | |
| 5 | PARAMETER ADDRESS VIOLATION | |
| 6 | PARAMETER END ADDRESS VIOLATION | |
| 7 | ILLEGAL PARAMETER | |
| 8 | PARAMETER VALUE INVALID | |
| 9 | INCORRECT Q REGISTER | |
| 20 | INVALID OPERATION | |
| 2l | DATA PARITY ERROR | |
| 22 | SOFTWARE TIME-OUT | |
| 23 | END OF TAPE | |
| 24 | UNIT NOT READY | |
| 25 | NO WRITE-RING ON TAPE | |
| 26 | TRANSMISSION ERROR | |
| 27 | I/O TIME-OUT | |
| 28 | TIMING ERROR OR DATA OVERRUN | |
| 29 | SIO FAILURE | |
| 30 | UNIT FAILURE | |
| 31 | END OF LINE | |
| 32 | SOFTWARE ABORT | |
| 33 | DATA LOST | |
| 34 | UNIT NOT ON-LINE | |
| 35 | DATA-SET NOT READY | |
| 36 | INVALID DISC ADDRESS | |
| 37 | INVALID MEMORY ADDRESS | |
| 38 | TAPE PARITY ERROR | |
| 39 | RECOVERED TAPE ERROR | |
| 40 | OPERATION INCONSISTENT WITH ACCESS TYPE | |
| 41 | OPERATION INCONSISTENT WITH RECORD TYPE | |
| 42 | OPERATION INCONSISTENT WITH DEVICE TYPE | |
| 43 | WRITE EXCEEDS RECORD SIZE | |
| 44 | UPDATE AT RECORD ZERO | |
| 45 | PRIVILEGED FILE VIOLATION | |
| 46 | OUT OF DISC SPACE | |
| 47 | I/O ERROR ON FILE LABEL | |
| 48 | INVALID OPERATION DUE TO MULTIPLE FILE ACCESS | |
| 49 | UNIMPLEMENTED FUNCTION | |
| 50 | NONEXISTENT ACCOUNT | |
-----------------------------------------------------------------------------------------------
Table A-1. File System Error Codes (continued)
-----------------------------------------------------------------------------------------------
| CODE | MEANING | ACTION |
-----------------------------------------------------------------------------------------------
| 51 | NONEXISTENT GROUP | |
| 52 | NONEXISTENT PERMANENT FILE | |
| 53 | NONEXISTENT TEMPORARY FILE | |
| 54 | INVALID FILE REFERENCE | |
| 55 | DEVICE UNAVAILABLE | |
| 56 | INVALID DEVICE SPECIFICATION | |
| 57 | OUT OF VIRTUAL MEMORY | |
| 58 | NO PASSED FILE | |
| 59 | STANDARD LABEL VIOLATION | |
| 60 | GLOBAL RIN UNAVAILABLE | |
| 61 | OUT OF GROUP DISC SPACE | |
| 62 | OUT OF ACCOUNT DISC SPACE | |
| 63 | USER LACKS NON-SHARABLE DEVICE CAPABILITY | |
| 64 | USER LACKS MULTI-RIN CAPABILITY | |
| 71 | TOO MANY FILES OPEN | |
| 72 | INVALID FILE NUMBER | |
| 73 | BOUNDS VIOLATION | |
| 80 | SPOOFLE SIZE EXCEEDS CONFIGURATION | |
| 81 | NO "SPOOL" CLASS IN SYSTEM | |
| 82 | INSUFFICIENT SPACE FOR SPOOFLE | |
| 83 | I/O ERROR ON SPOOFLE | |
| 84 | DEVICE UNAVAILABLE FOR SPOOFLE | |
| 85 | OPERATION INCONSISTENT WITH SPOOLING | |
| 86 | NONEXISTENT SPOOFLE | |
| 87 | BAD SPOOFLE BLOCK | |
| 89 | POWER FAILURE | |
| 90 | EXCLUSIVE VIOLATION: FILE BEING ACCESSED | |
| 91 | EXCLUSIVE VIOLATION: FILE ACCESSED EXCLUSIVELY | |
| 92 | LOCKWORD VIOLATION | |
| 93 | SECURITY VIOLATION | |
| 94 | USER IS NOT CREATOR | |
| 100 | DUPLICATE PERMANENT FILE NAME | |
| 101 | DUPLICATE TEMPORARY FILE NAME | |
| 102 | I/O ERROR ON DIRECTORY | |
| 103 | PERMANENT FILE DIRECTORY OVERFLOW | |
| 104 | TEMPORARY FILE DIRECTORY OVERFLOW | |
| 106 | EXTENT SIZE EXCEEDS MAXIMUM | |
| 107 | INSUFFICIENT SPACE FOR USER LABELS | |
| 108 | DEFECTIVE FILE LABEL ON DISC | |
| 110 | ATTEMPT TO SAVE PERMANENT FILE AS TEMPORARY | |
-----------------------------------------------------------------------------------------------
Table A-1. File System Error Codes (continued)
-----------------------------------------------------------------------------------------------
| CODE | MEANING | ACTION |
-----------------------------------------------------------------------------------------------
| 111 | USER LACKS SAVE FILE CAPABILITY | |
-----------------------------------------------------------------------------------------------
| 112 | | |
| : | RESERVED FOR FUTURE USE | |
| 169 | | |
-----------------------------------------------------------------------------------------------
| 170 | THE RECORD IS MARKED DELETED. FPOINT POSITIONED | |
| | POINTER TO A RECORD THAT WAS MARKED FOR DELETION. | |
| 171 | DUPLICATE KEY VALUE WHEN DUPLICATES NOT ALLOWED. | |
| 172 | KEY NOT FOUND; NO SUCH KEY VALUE. | |
| 173 | tcount PARAMETER LARGER THAN RECORD SIZE. | |
| 174 | CANNOT GET EXTRA DATA SEGMENT FOR THIS FILE. | |
| 175 | KSAM INTERNAL ERROR. A KEY VALUE (NOT SEARCH KEY) | |
| | FOR A RECORD TO BE DELETED IS NOT IN KEY FILE; | |
| | RECORD CANNOT BE DELETED. | |
| 176 | ILLEGAL EXTRA DATA SEGMENT LENGTH. | |
| 177 | TOO MANY EXTRA DATA SEGMENTS FOR THIS PROCESS | |
| 178 | NOT ENOUGH VIRTUAL MEMORY FOR EXTRA DATA SEGMENT | INCREASE THE SIZE |
| | | OF VIRTUAL MEMORY |
| 179 | THE FILE MUST BE LOCKED BEFORE THIS INTRINSIC | USE FLOCK TO LOCK |
| | ISSUED | FILE OR OPEN FILE FOR |
| | | EXCLUSIVE ACCESS. |
| 180 | THE KSAM FILE MUST BE REBUILT BECAUSE THIS VERSION | USE FCOPY TO |
| | OF KSAM DOES NOT HANDLE THE FILE BUILT BY PREVIOUS | REBUILD FILE: |
| | VERSION. | >FROM=oldksamfile |
| | | ;TO=(dfile,kfile) |
| 181 | INVALID KEY STARTING POSITION. | |
| 182 | FILE IS EMPTY. | |
| 183 | RECORD DOES NOT CONTAIN ALL THE KEYS. | |
| 184 | INVALID RECORD NUMBER. RECORD NUMBER IS NEGATIVE, | RECORD NUMBER MUST |
| | OUT OF RANGE, OR DELETED. | BE POSITIVE INTEGER. |
| 185 | SEQUENCE ERROR IN PRIMARY KEY; ATTEMPT TO WRITE | |
| | RECORD WITH PRIMARY KEY LESS THAN PREVIOUS KEY WHEN | |
| | ASCENDING SEQUENCE EXPECTED. | |
| 186 | INVALID KEY LENGTH. | |
| 187 | INVALID KEY SPECIFICATION; KEYS ILLEGAL. | |
| 188 | INVALID DEVICE SPECIFICATION. | |
| 189 | INVALID RECORD FORMAT. | |
-----------------------------------------------------------------------------------------------
Table A-1. File System Error Codes (continued)
-----------------------------------------------------------------------------------------------
| CODE | MEANING | ACTION |
-----------------------------------------------------------------------------------------------
| 190 | INVALID KEY BLOCKING FACTOR VALUE. | |
| 191 | RECORD DOES NOT CONTAIN SEARCH KEY FOR DELETION. | |
| | SPECIFIED KEY VALUE POINTS TO RECORD WHICH DOES NOT | |
| | CONTAIN THAT VALUE. | |
| 192 | SYSTEM FAILURE OCCURRED WHILE KSAM FILE WAS OPENED | RUN KEY INFO OF |
| | | KSAMUTIL TO |
| | | RESET FLAG. |
| 193 | $STDIN/$STDINX CANNOT BE REDIRECTED TO KSAM FILES. | |
| 194 | KSAM FILES NOT ALLOWED FOR GLOBAL AFT'S. | |
| 195 | GLOBAL FILES CANNOT BE REMOTE FILES. | |
| 196 | LANGUAGE NOT SUPPORTED. | |
| 197 | NATIVE LANGUAGE INTERNAL ERROR. | |
| 198 | INVALID VERSION NUMBER IN KSAM FILE. | |
-----------------------------------------------------------------------------------------------
| 193 | | |
| : | RESERVED FOR KSAM | |
| 200 | | |
-----------------------------------------------------------------------------------------------
| 201 | | |
| : | RESERVED FOR FUTURE USE | |
| 255 | | |
-----------------------------------------------------------------------------------------------
Table A-2. COBOL Status Parameter Return Values
-----------------------------------------------------------------------------------------------
| | | |
| STATUS | MEANING | ACTION |
| VALUE | | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "00" | SUCCESSFUL COMPLETION--I/O operation was | None. |
| | completed successfully. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "02" | SUCCESSFUL COMPLETION, DUPLICATE KEY--Read | None required, returned for |
| | or Readbykey read a record whose key value | information only. |
| | was the same as the equivalent key in the | |
| | next sequential record; this is not an | |
| | error since duplicate alternate keys are | |
| | allowed. Write or rewrite operation was | |
| | successful; a duplicate key was written | |
| | for a key that is allowed duplicates. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "10" | AT END--End-of-file or beginning-of-file | Usually none. This result is a |
| | reached during sequential or random read. | signal to close the file or |
| | There is no next logical record in | perform another end-of-file |
| | ascending key order. | action. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "21" | INVALID KEY, SEQUENCE ERROR--Attempt was | Check the primary key value in |
| | made to write a record with a primary key | the record being written. If you |
| | that is out of sequence when the file was | don't want sequence checking, |
| | opened for sequential access. | re-open the file for random or |
| | | dynamic access. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "22" | INVALID KEY, DUPLICATE KEY--Attempt was | Check the key values. If |
| | made to write or rewrite a record with a | possible change them to avoid the |
| | key value that duplicates a key value in | duplication. If duplicate keys |
| | an existing record, and duplicates are not | must be written, create the file |
| | allowed. | again allowing duplicates for the |
| | | key and then copy the old file to |
| | | the new file with FCOPY. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "23" | INVALID KEY, NO RECORD FOUND--Attempt to | Check the keyvalue, keylength, an |
| | access record identified by a key with | keylocation parameters in the |
| | CKSTART or CKR EADBY KEY, but no record is | call, Correct if necessary. If |
| | found with the specified key value at the | record that cannot be found |
| | specified key location. | should be in the file, you may |
| | | want to list the data file with |
| | | FCOPY. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "24" | INVALID KEY, BOUNDARY VIOLATION--An | |
| | attempt was made to write beyond the | |
| | externally defined end of file. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "30" | LOCK DENIED--File was locked by another | Wait until process locking file |
| | process. | unlocks it--try again or lock |
| | | file with lockcond = 1. |
| | | |
-----------------------------------------------------------------------------------------------
Table A-2. COBOL Status Parameter Return Values (continued)
-----------------------------------------------------------------------------------------------
| | | |
| STATUS | MEANING | ACTION |
| VALUE | | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "31" | UNLOCK DENIED--File was not locked by | Before calling CKUN LOCK to |
| | calling process. | unlock a shared file it must have |
| | | been locked by a call to CK LOCK. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "9n" | FILE SYSTEM ERROR--Where n is a binary | Within your program you can call |
| | number between 0 and 255 corresponding to | CKERROR to convert the number to |
| | a File System Error code (Refer to Table | a displayable value and then |
| | A-1). | display it. Look up the value in |
| | | Table A-1 and perform any |
| | | suggested action. |
| | | |
-----------------------------------------------------------------------------------------------
Note that COBOL error messages 752 and 753 are issued for errors
processing KSAM files. (Refer to Table C-2 in the COBOL manual.)
Table A-3. BASIC Status Parameter Return Values
-----------------------------------------------------------------------------------------------
| | | |
| STATUS | MEANING | ACTION |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "00" | SUCCESSFUL COMPLETION--The current I/O | None. |
| | operation was completed successfully. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "02" | SUCCESSFUL COMPLETION, DUPLICATE KEY--In a | None required. Returned for |
| | call to BKREAD or BKREADBYKEY, the current | information only. |
| | key has the same value as the equivalent | |
| | key in the next sequential record; | |
| | duplicate keys are allowed. Or in a call | |
| | to BKWRITE or BKREWRITE, the record just | |
| | written created a duplicate key value for | |
| | at least one key for which duplicates are | |
| | allowed. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "10" | AT END--A sequential read was attempted | Usually none. This result is a |
| | with BKREAD, but there was no next logical | signal to close the file or |
| | record in ascending sequence by key value, | perform some other end-of-file |
| | or random read attempted to position to | function. |
| | record with key value less than lowest | |
| | value or greater than greatest value. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "21" | INVALID KEY, SEOUENCE ERROR--BKWRITE | Check the primary key value in |
| | attempted; record being written has | the record; if you don't want |
| | primary key that is not in sequential | sequence checking, reopen the |
| | order but file was opened for sequence | file with sequence = 0. Check |
| | checking. BK REWRITE attempted, but the | the primary key value. Either |
| | primary key value was changed since the | change it back to the original |
| | record being rewritten was read. | value or read the record again |
| | | before calling BKREWRITE. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "22" | INVALID KEY, DUPLICATE KEY ERROR--BKWRITE | Check the key value. If possible |
| | or BKREWRITE attempted to write record | change it to a unique value. If |
| | that contains a duplicate value for a key | duplicate keys must be written, |
| | that is not allowed duplicate values. | create the file again allowing |
| | | duplicate values for the key and |
| | | then copy the old file to the new |
| | | file. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "23" | INVALID KEY, NO RECORD FOUND--BKSTART or | Check the key value, and key |
| | BKR EADBYKEY attempted to locate a record | location parameters. Correct if |
| | by a key value that could not be found. | necessary. If record that cannot |
| | | be found should be in file, you |
| | | may want to list data file with |
| | | FCOPY. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "24" | INVALID KEY, BOUNDARY VIOLATION--BKWRITE | Re-enter command. |
| | attempted to write beyond the externally | |
| | defined boundaries of the file. | |
| | | |
-----------------------------------------------------------------------------------------------
Table A-3. BASIC Status Parameter Return Values (continued)
-----------------------------------------------------------------------------------------------
| | | |
| STATUS | MEANING | ACTION |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "71" | REQUEST DENIED, FILE ALREADY LOCKED--BK | Perform some action that does not |
| | LOCK was called with conditional locking | require exclusive access and then |
| | and the file was already locked by another | try BK LOCK again. As soon as |
| | user. | the other user unlocks the file |
| | | BKLOCK will work. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "81" | INVALID CALL, WRONG NUMBER OF | Check the call syntax and |
| | PARAMETERS--A procedure call had too many | correct; if not sure of error, |
| | or too few parameters. | consult manual. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "82" | INVALID CALL, INVALID PARAMETER--Specified | Check the parameter and compare |
| | parameter is not the correct type. For | it to the rules specified in this |
| | example, a string variable was specified | manual for the parameter format. |
| | where only numeric variables or constants | |
| | are allowed. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "83" | INVALID CALL, INSUFFICIENT INTERNAL BUFFER | You can ask the system manager to |
| | SPACE--The data to be written to the file | reconfigure the system, or you |
| | is too long for the configured internal | may be able to reduce the amount |
| | buffer space. | of data being written from |
| | | parameterlist |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| "9xxx" | FILE SYSTEM ERROR--An MPE file system | Within your program you can call |
| | error occurred for which the value xxx | BKER ROR to display a message |
| | specifies a 3-digit code between "0" and | with the meaning of the code; you |
| | "255". | can consult Table A-1 for the |
| | | code meaning. |
| | | |
-----------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1000 | COMMAND FILE READ ERROR. | | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1001 | COMMAND FILE END OF FILE. | | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1002 | UNKNOWN COMMAND. TYPE | Command name not | Type the correct name |
| | HELP. | recognized. | if you know it; else |
| | | | type HELP. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1003 | TOO MANY PARAMETERS FOR | More parameters specified | Check the command |
| | THIS COMMAND. | than are allowed. | syntax and reenter |
| | | | correctly. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1004 | COMMAND FILE DATA | | |
| | TRANSMISSION ERROR. | | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1005 | COMMAND TOO LONG. | | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1006 | FILE NAME TOO LONG OR | File name in BUILD command | Enter file name of 8 |
| | ABSENT. | incorrect. | or fewer alphanumeric |
| | | | characters starting |
| | | | with a letter. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1007 | 'REC' PARAMETER LIST | Too many parameters | Check syntax and |
| | EXHAUSTED. | specified after REC= in | reenter with correct |
| | | BUILD command. | number of parameters. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1008 | 'REC' RECORD SIZE VALUE | Record size in BUILD | Check syntax and |
| | INVALID. | command is not valid. | reenter with correct |
| | | | value for record size. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1009 | 'REC' BLOCKING FACTOR | Block factor in BUILD | Check syntax and |
| | VALUE INVALID. | command is not valid. | reenter with correct |
| | | | value for blocking |
| | | | factor. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1010 | 'REC' RECORD FORMAT VALUE | Record format in BUILD | Enter V for variable |
| | INVALID. | command is not F or V. | length records, F for |
| | | | fixed length, or omit |
| | | | for fixed length. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1011 | 'REC' RECORD TYPE VALUE | Record code in BUILD | Enter ASCII for |
| | INVALID. | command is not ASCII or | ASCIIcode records; |
| | | BINARY. | BINARY or omit for |
| | | | binary-coded records. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1012 | 'DEV' DEVICE VALUE ABSENT. | No device specification | Enter legal device |
| | | after DEV= in BUILD | name or omit if device |
| | | command. | class is DISC. |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1013 | 'DEV' DEVICE VALUE | Device specification in | Enter legal device |
| | INVALID. | BUILD command is not | class name or legal |
| | | valid. | logical device number. |
| | | | Refer to System |
| | | | Manager/System |
| | | | Supervisor Manual. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1014 | 'DEV' DEVICE VALUE TOO | DEV= missing device | Enter device name that |
| | LONG OR ABSENT. | specification or one that | is 1 to 8 alphanumeric |
| | | is too long. | characters, begins |
| | | | with a letter, |
| | | | terminates with |
| | | | nonalphanumeric |
| | | | character; or omit |
| | | | DEV= for DISC; or |
| | | | enter logical device |
| | | | number. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1015 | 'KEY' SPECIFICATIONS | Too many KEY= | Reduce number of keys |
| | EXCEED LIMIT. | specifications in BUILD. | to a total of 16. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1016 | 'KEY' CONTAINS TOO MANY | More than 5 parameters | Parameters are: |
| | PARAMETERS. | follow KEY= in BUILD. | keytype, keylocation, |
| | | | keysize, and |
| | | | optionally, |
| | | | keyblocking, and DUP |
| | | | or DUPLICATE. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1017 | 'KEY' TYPE VALUE INVALID. | Invalid key type specified | Key types may be: B, |
| | | after KEY= in BUILD. | I, D R, L, N, P,*. |
| | | | Enter one of correct |
| | | | types. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1018 | 'KEY' POSITION VALUE | The key location is | Enter required |
| | ABSENT. | missing from KEY= in BUILD | keylocation parameter |
| | | command. | following keytype type |
| | | | in KEY= specification. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1019 | 'KEY' POSITION VALUE | Invalid keylocation | Key location is |
| | INVALID. | parameter specified after | specified as integer |
| | | KEY= in BUILD. | between 1 and number |
| | | | of bytes in record. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1020 | 'KEY' SIZE VALUE REQUIRED | The key size is missing | Enter required keysize |
| | AND ABSENT. | from KEY= in BUILD | parameter after |
| | | command. | keylocation in KEY= |
| | | | specification. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1021 | 'KEY' SIZE VALUE INVALID. | Invalid keysize parameter | Key size is specified |
| | | specified after KEY= in | as the number of bytes |
| | | BUILD. | in the key; refer to |
| | | | table 02-02 for legal |
| | | | sizes for each key |
| | | | type. |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1022 | 'KEY' BLOCKING FACTOR | Invalid key blocking | Specify keyblocking as |
| | VALUE INVALID. | parameter specified after | an even number equal |
| | | KEY= in BUILD. | to or greater than 4; |
| | | | or omit for key blocks |
| | | | with four keys per |
| | | | block. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1023 | CONFLICTING OPTIONS | | Check command syntax |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1024 | MISSING CLOSING QUOTE | | Check command syntax |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1025 | 'KEY' 'DUPLICATE' | Key word DUP or DUPLICATE | Enter DUP or DUPLICATE |
| | EXPECTED. | expected in KEY= | or remove terminating |
| | | specification. | commas. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1026 | 'DISC' MUST BE FOLLOWED BY | Key word DISC in BUILD | Reenter DISC= followed |
| | '='. | command was specified | by up to 3 parameters |
| | | without =. | describing disc file, |
| | | | or omit for defaults. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1027 | 'DISC' NUMBER OF RECORDS | Value of numrecs parameter | Enter maximum number |
| | VALUE INVALID. | to DISC= not a positive | of records as file |
| | | integer. | size, or omit for |
| | | | default value of 1023 |
| | | | records. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1028 | 'DISC' NUMBER OF EXTENTS | Value of numextents not in | Enter integer between |
| | VALUE INVALID. | range 1-32. | 1 and 32, or omit for |
| | | | default value of 8 |
| | | | extents. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1029 | 'DISC' INITIAL ALLOCATION | Value of initalloc not in | Enter integer between |
| | VALUE INVALID. | range 1-32. | 1 and 32, or omit for |
| | | | default value of 1 |
| | | | extent allocated when |
| | | | file is opened. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1030 | 'LABELS' NOT FOLLOWED BY | Key word LABELS in BUILD | Reenter LABELS= |
| | '=' OR BY TOO MANY | command was specified | followed by one |
| | PARAMETERS. | without = or had more than | parameter to specify |
| | | 1 parameter. | number of user labels, |
| | | | or omit for default of |
| | | | 0. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1031 | 'LABELS' NUMBER OF LABELS | | |
| | VALUE INVALID. | | |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (Continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1032 | 'FIRSTREC' NOT FOLLOWED BY | Key word FIRSTREC in BUILD | Reenter |
| | '=' OR BY TOO MANY | command was specified | FIRSTREC=followed by |
| | PARAMETERS. | without = or had more than | starting record |
| | | 1 parameter. | number, or omit to |
| | | | start numbering |
| | | | records with zero. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1033 | 'FIRSTREC'STARTING RECORD | Value other than 0 or 1 | Enter correct value or |
| | NUMBER MUST BE 0 OR 1. | entered for first record | omit for default of 0. |
| | | number. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1034 | 'CODE' NOT FOLLOWED BY '=' | Key word CODE in BUILD | Reenter CODE = |
| | OR BY TOO MANY PARAMETERS. | command was specified | followed by filecode, |
| | | without = or had more than | or omit for file code |
| | | one parameter. | of zero. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1035 | 'CODE' FILE NUMBER VALUE | Value not in range 0 | Enter positive integer |
| | INVALID. | through 1023 entered for | between 0 and 1023, or |
| | | file code. | omit for default of 0. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1036 | 'KEYDEV' FOLLOWED BY TOO | Key word KEYDEV= in BUILD | Reenter with one |
| | MANY PARAMETERS. | command was specified with | parameter to specify |
| | | more than 1 parameter. | device class or |
| | | | logical device number |
| | | | of key file, or omit |
| | | | for DISC. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1037 | 'KEYDEV' MUST BE FOLLOWED | Key word KEYDEV= not | Reenter KEYDEV=, or |
| | BY'='. | followed by =. | omit for default |
| | | | device class DISC. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1038 | 'KEYDEV' DEVICE PARAMETER | Key word KEYDEV= must be | Reenter with device |
| | VALUE TOO LONG OR ABSENT. | followed by valid device | class specified as 1 |
| | | parameter. | to 8 alphanumeric |
| | | | characters beginning |
| | | | with letter, |
| | | | terminated by |
| | | | non-alphanumeric |
| | | | character, or reenter |
| | | | with logical device |
| | | | number, or omit for |
| | | | default DISC. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1039 | 'KEYFILE' NOT FOLLOWED BY | Key word KEYFILE in BUILD | Reenter KEYENTITY = |
| | '=' OR BY TOO MANY | command was specified | followed by actual |
| | PARAMETERS. | without = or had more than | file designator of key |
| | | 1 parameter. | file. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1040 | KEY FILE NAME TOO LONG OR | File name specified as | Reenter KEYENTITY = |
| | ABSENT. | KEYENTITY = parameter is | with correct file name |
| | | more than 8 characters or | format. (Refer to |
| | | was omitted. | BUILD description in |
| | | | manual.) |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (Continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1041 | 'KEYENTRIES' NOT FOLLOWED | Keyword KEYENTR IES in | Reenter KEYENTRIES= |
| | BY '=' OR BY TOO MANY | BUILD command was | followed by the |
| | PARAMETERS. | specified without =, or | maximum number of |
| | | had more than 1 parameter. | primary key entries |
| | | | expected in the key |
| | | | file, or omit for |
| | | | default of numrecs |
| | | | value from |
| | | | REC=parameter. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1042 | 'KEYENTRIES' NUMBER OF | | ENTRIES VALUE INVALID. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1043 | KEYWORD SPECIFICATION IN | A key word specified as a | Check command syntax |
| | THIS COMMAND IS INVALID. | KSAMUTIL command parameter | for correct key word |
| | | is misspelled or not in | and/or spelling; |
| | | syntax. | reenter correctly. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1044 | DELIMITER AT THE END OF A | A delimiter follows | Remove delimiter or |
| | SPECIFICATION IS INVALID. | command specification in | follow with rest of |
| | | KSAMUTIL command. | command. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1045 | THE NUMBER OF PARAMETERS | Too many or too few | Check command syntax |
| | IN THIS COMMAND IS | parameters specified in a | and reenter with the |
| | INVALID. | KSAMUTIL command. | correct number of |
| | | | parameters. |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (Continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1046 | A PARAMETER VALUE IS | The key word TEMP was | Check command syntax, |
| | INVALID. 'TEMP'WAS | expected as a parameter in | reenter with correct |
| | EXPECTED. | PURGE or RENAME commands. | parameter value. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1047 | LOCKWORD NOT ALLOWED IN | | Check command syntax; |
| | KEY FILE | | remove lockword from |
| | | | key file |
| | | | specification. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1048 | GROUP AND/OR ACCOUNT NOT | | Check command syntax |
| | ALLOWED FOR KEYENTITY = | | of BUILD command. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1049 | BACK REFERENCE NOT ALLOWED | | |
| | ON formal- designator | | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1050 | SEQ=SEQUENCE NUMBER IS | Non-numeric sequence | Check command syntax |
| | INVALID | number specified for SEQ= | of KEYSEQ or KEYDUMP |
| | | parameter. | commands. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1051 | SUBSET= VALUE INVALID | Either the starting | Check command syntax |
| | | position or the number of | of KEYDUMP command |
| | | key values to be dumped is | |
| | | invalid. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1052 | SEQ= SYNTAX ERROR | | Check command syntax |
| | | | of KEYSEQ or KEYINFO |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1053 | SEQ= PARAMETER LIST | Not enough information in | Enter parameter value |
| | EXHAUSTED | parameter list; key number | for SEQ= in KEYSEQ or |
| | | missing. | KEYDUMP commands. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1054 | ENTITY = PARAMETER LIST | Not enough information in | Enter file name after |
| | EXHAUSTED | parameter list; file name | ENTITY = in KEYDUMP |
| | | missing. | command. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1055 | ENTITY = SYNTAX ERROR | | Check command syntax |
| | | | of KEYDUMP command. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1056 | SUBSET= PARAMETER LIST | Not enough information in | Check command syntax |
| | EXHAUSTED | parameter list. | of KEYDUMP; enter |
| | | | correct number of |
| | | | parameters. |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (Continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1057 | SUBSET= SYNTAX ERROR | | Check command syntax |
| | | | of KEYDUMP command. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1058 | INVALID KEY SEQUENCE | Key number specified in | Key number is 1 for |
| | SPECIFICATION | SEQ= parameter is greater | primary key, 2 for |
| | | than the number of keys in | first alternate key, |
| | | file. | etc. Use VERIFY |
| | | | command to check |
| | | | number of keys in |
| | | | file. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1059 | FILE SPECIFIED IN FILE- | File name specified in | Enter name of |
| | ALREADY EXISTS | ENTITY = parameter is an | non-existent file, or |
| | | existing permanent file; | rename permanent file. |
| | | KEYDUMP always creates a | |
| | | new file. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1060 | B-TREE HAS MORE THAN 20 | KEYDUMP cannot dump more | |
| | LEVELS | than 20 levels of the key | |
| | | file structure. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1061 | INVALID DECIMAL DIGIT OR | Packed decimal digit is | |
| | DIGIT COUNT >28 | not 0-9, or there are more | |
| | | than 28 digits. Cannot | |
| | | convert to ASCII for | |
| | | KEYDUMP. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1062 | THE REFERENCED FILE IS NOT | File reference in the | Check file name and |
| | A KSAM FILE | command is not a KSAM | correct it. |
| | | file. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1063 | RECORD SIZE OF THE | Record size of the file | Check KEYDUMP syntax; |
| | SPECIFIED FILE HAS BEEN | specified in ENTITY = | change : FILE command |
| | CHANGED | parameter of KEYDUMP has | so that record size is |
| | | been changed by a : FILE | not specified. |
| | | command. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1064 | GENERIC OR APPROXIMATE | Generic or approximate | Use full key value in |
| | SEARCH NOT ALLOWED FOR KEY | keys can be specified in | SUBSET= or do not use |
| | TYPE | SUBSET= parameter of | SUBSET= parameter. |
| | | KEYDUMP only if key type | |
| | | is BYTE, INTEGER, or | |
| | | DOUBLE. | |
| | | | |
-------------------------------------------------------------------------------------------------
Table A-4. KSAMUTIL Error Codes and Messages (Continued)
-------------------------------------------------------------------------------------------------
| | | | |
| CODE | MESSAGE | MEANING | ACTION |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1065 | ILLEGAL OR TOO MANY | Position value of | Change position value, |
| | CHARACTERS | SUBSETparameter in KEYDUMP | or use quoted string |
| | | contains non-numeric | for SUBSET= parameter. |
| | | characters, or is >9 | |
| | | digits. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1066 | REMOTE FILE ACCESS NOT | A :FILE command specified | Change : FILE command |
| | SUPPORTED | a remote file, but this | to specify local file. |
| | | command does not support | |
| | | remote access. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1067 | SORT ON RECORD POINTERS | Sort of keydump by record | Check the reasons for |
| | FAILS | pointers (SORT option of | failure in SORT error |
| | | KEYDUMP) failed during | message. |
| | | sort by SORT/3000 program. | |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1068 | SYSTEM FAILURE OCCURRED | KSAM file was open when a | Run KEYINFO command to |
| | WHILE THE KSAM FILE WAS | system failure occurred, | recover file and reset |
| | OPEN | and file may be damaged. | flag so file can be |
| | | | opened, or run VERIFY |
| | | | with NOCHECK to |
| | | | examine file. |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| 1069 | UNEXPECTED CHARACTER IN | The only nonmeric | Check the file name |
| | FILE NAME; EXPECTED . or / | characters allowed in a | and correct it. |
| | | file name are "." or "/". | |
| | | | |
-------------------------------------------------------------------------------------------------