HP 3000 Manuals HP 3000 Manuals
Warning Messages
Depending on the operation you select, some command line options are
unnecessary. In these cases, the incorrect usage is indicated, but the
option is ignored and processing continues.
The option may be correct, but omission of other information sometimes
causes Rebuild to select the wrong process. If this is the case, correct
the command line and rerun. Below are the warning messages you may
receive if you specify incorrect information on the command line:
Option ignored - /k option not needed for a reorganization
* A key definition option has been used when an indexed file
reorganization operation has been requested. The option is
ignored.
Option ignored - /k option not needed with /n
* A key definition option has been used when an indexed file
reorganization operation has been requested. The option is
ignored.
Option ignored - /k option not needed for ms2 conversion.
* A key definition option has been used when you have requested a
Microsoft COBOL V2.2 conversion. This is not required since the
key information is held in the data file of a Microsoft V2.2
indexed file.
Option ignored - /r option not needed for a reorganization
* A record structure for a reorganization has been used when only
the n (information only) option was specified.
Option ignored - /x option not needed for index rebuild
* A key of reference option has been used when an action other than
indexed file reorganization has been selected. The option is
ignored.
Option ignored - /x option not needed for ms2 conversion.
* A key of reference option has been used when you have requested a
Microsoft COBOL V2.2 conversion. This is not required since the
key information is held in the data file of a Microsoft V2.2
indexed file.
Error Messages
When an error is encountered, the command line is displayed, followed by
an error message. For command line errors, a caret (^) is displayed
under the point in the command line where the error is detected. The
program sets the return code to a value other than zero to indicate the
type of error that has occurred; 9 indicates that you have made an error
when entering information on the command line; 2 indicates that an error
has been detected on an output file; 1 indicates that an error has been
detected on an input file. This code can be tested in a batch stream
using the IF ERRORLEVEL command (see your Operating System documentation
for further details of this command).
The most likely cause of an error is that you have specified parameters
to Rebuild that do not correctly represent the input file. In most cases
it is difficult for Rebuild to determine that such a mistake has been
made, since most data files carry insufficient information to make them
easy to identify. Consequently, the error presented by Rebuild may not
obviously identify the cause.
Command Line Errors
***Invalid parameter combination
* The parameters specified on the command line are not compatible
with each other. The return code is set to 9. Although this
message results from an error you made on the command line, the
error is not detected by this COBOL system until run time.
* Specify valid parameters for the options you want to use.
/k option is required for conversion to indexed file
* No key definition was given for the index of the file being
generated from a sequential or relative file.
* Specify a key definition.
Data compression out of range
* The integer you specified for data compression is not within the
allowable range.
* Data compression requires an integer in the range 0 to 255.
Data compression specified more than once
* You have specified the option for data compression more than once;
that is, /c:[dn][dn]
* The correct format is /c:[dn][in]
Input file same as output file
* You have given the output file the same name as the input file.
* The output file-name must be different from the input file-name.
Index compression out of range
* The integer you specified for index compression is not within the
allowed range.
* Index compression requires an integer in the range 0 to 7.
Index compression specified more than once
* You have specified the option for index compression more than
once; that is, /c[in][in].
* The correct format is /c:[dn][in].
Invalid command - /n not allowed with Microsoft format file
* You have specified the /n option for a Microsoft format file which
you cannot do unless the Microsoft format file has been converted
into the indexed file format used by this system.
* You must either reenter the command line without the /n option, or
convert the Microsoft format file to the indexed file format used
by this system and enter the command line again.
Invalid command - must specify output file for conversion
* You have omitted an output file-name for a conversion.
* You must specify an output file-name when you want to convert a
file to a different format.
Invalid command line
* The command line contains an error other than those described
above.
* Check carefully the syntax, spelling, and spacing in the command
line you are trying to enter.
Invalid compression choice - must be 'd' or 'i'
* The specification of data or index compression was not correct.
* When you want to specify data or index compression, you must
specify the d or Iparameters.
Invalid format
* The integer you specified for index file format is not within the
allowable range.
* Index file formats require an integer in the range 0 to 4.
Invalid key length - cannot be zero
* One of the keys you defined has a zero length, which is illegal.
(This may be due to incorrect use of separator characters.)
* Make sure that any keys you define have a valid start character.
See the section The /k Option for details of separator characters.
Invalid key specification - key not contained in record
* One of the keys, as defined, is not wholly contained in the
record. This is illegal.
* For variable length records, the key must be wholly contained in
the minimum length record. This error will occur only if you
specify the record length on a /r option.
Invalid key start - cannot be zero
* One of the keys defined has a start character position of zero,
which is illegal. (This may be due to incorrect use of separator
characters.)
* Make sure that any keys you define have a valid start character.
See the section The /k Option for details of separator characters.
Invalid key structure - '+' expected
* A key part parameter of the /koption is incorrect.
* It must be start character position and length separated by a plus
(+) or an L.
Invalid option
* You have specified an invalid option.
* The options you can specify are listed in the chapter Invoking
Rebuild earlier in this manual.
Invalid organization
* The syntax of the /o option is incorrect.
* The only valid organizations you can specify with the /o option
are s (sequential), r (relative), or i (indexed). See the section
The /o Option earlier in this chapter for details.
Invalid organization - 'i' or nothing expected
* The syntax of the /o option is incorrect.
* The only valid characters after the i, s or r are the letter i
(when converting to an indexed file) or a '/' (when another option
is specified).
Invalid organization - must be indexed for index rebuild
* You have tried to rebuild the index or a file whose organization
is sequential or relative.
* Make sure that the file-name you enter for rebuilding is that of
an indexed file. If it is not, the rebuild will fail. See the
section The /o Option earlier in this chapter for further
information.
Invalid organization - must be indexed for reorganization
* You have tried to reorganize a file index for a file whose
organization is sequential or relative.
* Make sure that the file-name you enter for reorganization is that
of an indexed file. If it is not, reorganization will fail. See
the section The /o Option earlier in this chapter for further
information.
Invalid record length - cannot be zero
* You have specified that the length of a record is zero. This is
invalid.
* When specifying record lengths, you must specify a length greater
than zero which falls within the limits for record lengths for
this COBOL system.
Invalid record lengths - maximum must not be less than minimum
* The integers you have used to specify the maximum and minimum
lengths of a record indicate that the maximum length is less than
the minimum length. This is illegal.
* Enter the maximum or minimum record length again, ensuring that
the maximum length is greater than the minimum length.
Invalid record parameter - '-' expected
* When specifying the record structure of a variable length file,
you have not separated the minimum record length and the maximum
record length with a '-'.
* The correct format is /r:Vminreclen-maxreclen
Invalid record type - 'F' or 'V' expected
* You have entered a record type other than fixed or variable. This
is invalid.
* Enter the record type again using either f (fixed) or v
(variable).
Invalid source format
* The format of the </s option is incorrect.
* See the section The /s Option earlier in this chapter for details
of the valid format parameter to specify with this option.
MS2X specified for non-indexed file
* You have specified that you want to convert a Microsoft COBOL
indexed file when that file is not indexed.
* Make sure that you are using the /s option and the correct
parameter. See the section The /s Option earlier in this chapter
for details.
Must have key definition (/k option) with MS2X
* The Microsoft key file is not present.
* You must specify the /k option to enable Rebuild to set up the
keys for this file.
No output file specified for /t to refer to
* You did not specify a name for the output file which was referred
to with the /t option.
* Specify the name of an output file for this option.
No output file specified for data compression
* You did not specify an output file-name for data compression.
* Specify a valid output file-name.
Number expected
* You have specified another character where a number was expected.
* Specify a numeric value for this parameter.
Output file was not specified for indexed output
* No name was given for the output file in conversion to an indexed
file.
* Specify an output file-name.
Parameter file not found
* The parameter file specified on the command line cannot be found.
* Check the file exists, and that the specification used on the
command line is correct.
Information Messages
The following information messages are output when Rebuild is processing
a file:
Converting file
* The file you specified is being converted from one format to
another.
Rebuild aborted -
* You will receive this error followed by one of the errors given in
the section Command Line Errors .
Rebuild successful
* The file you specified has been successfully rebuilt.
Rebuilding file
* The file you specified is being rebuilt.
Rebuilding index
* The index of the file you specified is being rebuilt.
Records processed -
* The indicated number of records were processed when the file was
converted, rebuilt or reorganized.
Reorganization successful
* The file you specified has been successfully reorganized.
Reorganizing file
* The file you specified is being reorganized.
- records processed -
* This message is output as a counter of the records that have been
processed.
Conversion Errors
***Error on input file - attempt to read past eof
When reading the next record, the end-of-file was encountered
prematurely. Ensure that you have selected the correct format for the /s
option, and that the input file is not corrupt.
NOTE This error is likely to occur if you try to convert a Microsoft
COBOL Version 1 sequential or relative file with a /s:ms2 option.
The output file is closed, and should be useable, if not complete.
***Error on input file - bad file structure
* The structure of the input file is not an indexed file in the
format used by this system. The return code is set to 1.
* Ensure that the parameters are correct and that the file is not
corrupt.
***Error on input file - Communications failure
* This error occurs if you have an FHREDIR configuration which tells
Rebuild to access files through Fileshare Version 2 (an add-on
product).
* Remove this configuration.
***Error on input file - Disk input output error
* This indicates a hardware fault. You should contact your system
administrator if you receive this error.
***Error on input file - disk space exhausted
* File processing cannot continue because there is insufficient disk
space to do so.
* Ensure that the input file is not corrupt. The output file is
closed and should be useable, if not complete.
***Error on input file - duplicate key - record not written:
* The duplicate key was not written to the output file as this would
have created an invalid duplicate.
***Error on input file - file is not a BTRIEVE indexed file
* The file specified by /s:btrv was not recognized as a Btrieve
indexed file. The return code is set to 1.
* Make sure that the file you specify is a Btrieve indexed file.
***Error on input file - file is not a C-ISAM indexed file
* The file specified by /s:c-isam was not recognized as a C-ISAM
indexed file. The return code is set to 1.
* Make sure that the file you specify is a C-ISAM indexed file.
***Error on input file - file is not a LII indexed file
* The file specified by /s:lii was not recognized as a LEVEL II V2.5
COBOL indexed file. The return code is set to 1.
* Make sure that the file you specify is a LEVEL II V2.5 COBOL
indexed file.
***Error on input file - file is not a MF indexed file
* The file specified by /s:mf was not recognized as an mf indexed
file. The return code is set to 1.
* Make sure that the file you specify is a mf indexed file.
***Error on input file - file is not a MF4 indexed file
* The file specified by /s:mf4 was not recognized as an mf4 indexed
file. The return code is set to 1.
* Make sure that the file you specify is a mf4 indexed file.
***Error on input file - file is not a variable relative file
* The file specified by /o:r is not recognized as a variable
relative file. The return code is set to 1.
* Specify a variable relative file.
***Error on input file - file is not a variable sequential file
* The file specified by /o:s was not recognized as a variable
sequential file. The return code is set to 1.
* Specify a variable sequential file.
***Error on input file - File locked
* The file you specified as your input file is locked by another
process.
* Try again when the file is free to be accessed.
***Error on input file - file must be indexed for rebuild
* You have chosen to rebuild the index of an indexed file that is in
the format used by this COBOL system. The file is in the correct
format but it is not an indexed file. The return code is set to
1.
* Check that you have the correct file and have selected the correct
action.
***Error on input file - file must be indexed for reorganization
* The input file is not an indexed file in the format used by this
system. The return code is set to 1. You will receive this error
only if you have omitted the /s option.
* Check that you have the correct file, and that you mean to do a
reorganization.
***Error on input file - file not found
* The input file cannot be found. The return code is set to 1.
* Check that the file-name you entered is correct, and the file does
actually exist. For reorganization or index rebuild ensure that
the index file (.IDX) exists for the given indexed data file.
***Error on input file - illegal filename specified
* A file-name contains an illegal character. This could be any
character that is not part of the permitted character set or it
could be the system-dependent delimiter, which, on most systems,
is the space.
* Try the file operation again using the correct file-name.
***Error on input file - invalid /x: key-of- reference
* The number specified in the key-of-reference option (/x) exceeds
the number of keys for the given file. The return code is set to
1.
* Check the key required, and try again.
***Error on input file - no record size information
* You have specified the /r option without specifying record
lengths.
* Make sure that you specify record lengths when you specify the /r
option. See the section The /r Option earlier in this chapter for
details.
***Error on input file - not MF indexed or variable format
* The input file is not an indexed file, or a variable format file
in the format used by this system. The return code is set to 1.
You will receive this error only if you have omitted the /s
option.
* Make sure that the file you specify is either an indexed file, or
a variable file whose format is recognized by this COBOL system.
***Error on input file - record size >> specified
* The record sizes specified in the /r option do not match those in
the file.
* Correct the /r option and try the operation again.
***Error on input file - status xx ***Error on input file - status 9/yyy
* An error, other than one of the above input file errors, has
occurred while processing the input file. Possible causes are:
- the file does not exist - a hardware error has occurred opening
or reading the file - the file is corrupt
The status xx is an ANSI'85 file status. If the first byte is a 9, the
status yyy is a COBOL run-time error number. The output file is closed,
and should be usable, if not complete. The return code is set to 1.
* See your Error Messages for more details of run-time errors.
***Error on output file - record length << min or >> max
* The record length of the output file is less than the minimum or
greater than the maximum length you specified.
* Change the record lengths specified in the /r option.
***Error on output file - status xx ***Error on output file - status
9/yyy
* An error has occurred processing the output file. Either the file
cannot be created, or a hardware error has been encountered on
opening or writing the file, or the parameters specified are
incorrect.
The status xx is an ANSI'85 file status. If the first byte is a
9, the status yyy is a COBOL run time error number. The return
code is set to 2.
* See your Error Messages for more details of run-time errors.