This chapter describes diagnostic messages generated by the CICS Preprocessor. Once any preprocessor errors have been corrected, your program should be ready to compile and link-edit.
CICS diagnostic messages have the form
LSCL[num] [severity]: [message text]
where [severity] can be any of the following: NOTE provides information about expected behavior. The return code is not changed. WARNING provides information about conditions that will not prevent translation from completing successfully. The return code is set to 4. ERROR provides information about conditions that will prevent translation from continuing. If an error occurs before translation begins (such as a file I/O error), the preprocessor will terminate immediately. If an error occurs after translation has begun, the preprocessor will stop translating, but will check all the remaining commands in the input file for correct syntax. The return code is set to 8. SEVERE provides information about conditions that will cause [ERROR] immediate termination. The return code is set to 12. Diagnostic messages usually change the return code set by the preprocessor. no level message text the same for both an error and a warning.
Note:
The LSCP prefix has been omitted in the message descriptions below.
LSCP Messages
000
SEVERE: Not enough storage to continue.
Explanation
An attempt to allocate storage failed.
Action
Increase the virtual machine or region size.
001
WARNING: Unknown option [option] ignored.
Explanation
The specified option was not a preprocessor option.
Action
The option may have been misspelled.
002
WARNING: Keyword parameter expected for option [option]. Option ignored.
Explanation
A required parameter was not given for the specified
option.
003
WARNING: [option] is not a keyword option. Option ignored.
Explanation
A parameter was used on an option that does not require
one.
004
WARNING: [option] may not be negated. Option ignored.
Explanation
An option, such as pagesize
, was incorrectly preceded by
no
, but the option may not be negated.
005
SEVERE: Unable to open the [file] file.
Explanation
The specified required file could not be opened.
Action
MVS and CMS only: refer to the run-time library messages
on stderr
for more information about why the file could not be opened.
006
SEVERE: Error occurred while reading from the [file] file.
Explanation
The specified required file could not be used for
input any longer.
Action
MVS and CMS only: refer to run-time library messages
on stderr
for
more information about the error.
007
SEVERE: Error occurred while writing to the [file] file.
Explanation
The specified required file could not be used for
output any longer.
Action
MVS and CMS only: refer to run-time messages on stderr
for
more information about the error.
008
WARNING: Invalid DDname prefix [prefix] specified by FILES option. DDname prefix set to default value.
Explanation
MVS only: The specified prefix is longer than
three characters or contains a character that may not appear in a DDname.
Action
Correct the prefix. The prefix may be no more than three characters in
length. The first character must be alphabetic or @, #, or $. The
second and third characters must be alphanumeric or @, #, or $.
009
WARNING: Value of
pagesize
option, [value] is not numeric or is less than 7. Page size is unchanged.Explanation
The pagesize
option requires a integer parameter
greater or equal to 7.
Action
pagesize
(7) will cause
the source listing to be printed with only one line per page.
010
WARNING: No value given for option [option]. Option ignored.
Explanation
A required parameter was not given for the specified
option.
011
SEVERE: Cannot access character translation table.
Explanation
The custom character translation table could not be loaded.
Action
This is possibly due to an out-of-storage condition.
MVS and CMS only: Refer to run-time messages on stderr
for
more information about the error. Tell your
SAS Software Representative for C Compiler Products about the error.
012
WARNING: Invalid [option] specification [value]. Option ignored.
Explanation
The parameter for the specified option was
incorrect or out of range.
013
SEVERE: Unexpected end of file on input file.
Explanation
An end-of-file condition occurred while a comment,
string literal, character literal, CICS, or DL/I command was being
processed.
014
WARNING: Input line length exceeds output line length.
Explanation
A line in the input file was longer than may be
contained in a single line in the output file.
Action
On MVS, increase the output file LRECL. On CMS or UNIX, split the line
in the input file into several shorter lines.
015
SEVERE: Error occurred while closing the [file] file.
Explanation
The specified file could not be closed.
If the file is the output file, it may not be usable.
Action
MVS and CMS only: refer to run-time messages for
more information about the error.
016
SEVERE: Cannot access translation data for [command-set] commands.
Explanation
command-set
is either CICS or DL/I. An
error occurred when the preprocessor attempted to dynamically load the
translation data load module.
Action
MVS and CMS only: This is usually caused by not having enough storage available to load
the data. If the run-time messages on stderr
indicate that the problem was due to
a lack of available storage, increase the virtual machine or region size
and re-execute the preprocessor. Otherwise, refer the problem to your SAS Software
Representative for C Compiler Products.
017
WARNING: Right parenthesis assumed.
Explanation
A command option argument contains a semicolon. The preprocessor assumes that
the command has ended and inserts a right parenthesis
immediately before the semicolon.
The command may not be translated correctly. The compiler may
issue error messages for the output source file.
Action
Ensure that all option arguments are properly enclosed in parentheses.
018
WARNING: Semicolon assumed.
Explanation
A command contains a token that is not an option or an argument.
Action
This warning is usually caused either by a missing semicolon or by
a misspelled command option, such as an option that contains
lowercase characters. Correct the command by inserting a semicolon
at the end of the command or by correcting the misspelled option.
019
ERROR: No command function specified.
Explanation
A CICS command was terminated by a semicolon before the command
function was specified.
Action
This error usually occurs in conjunction with message
018 if the function contains characters that are not
allowed in CICS commands.
Correct the command before reinvoking the preprocessor.
020
ERROR: Unknown [command-set] function.
Explanation
command-set
is either CICS or DL/I.
The named function was not a valid function.
Action
The function name may have
been misspelled. Correct the command before reinvoking the preprocessor.
021
ERROR: Argument is not associated with an option.
Explanation
Two successive parenthesized arguments
were found. Each argument must be preceded by an option.
Action
Correct the command before reinvoking the preprocessor.
022
ERROR: Expected [option] argument not specified.
Explanation
The named option requires an argument, but the argument was not
found.
Action
Correct the command before reinvoking the preprocessor.
023
ERROR: Unexpected argument after [word].
Explanation
A parenthesized argument was found where it was not expected.
Action
Correct the command before reinvoking the preprocessor.
024
ERROR: [option] required but not specified.
Explanation
A required option was not found in this command.
Action
Correct the command before reinvoking the preprocessor.
025
WARNING: [option] argument ignored. [option] assumed.
Explanation
A parenthesized argument was found following an option that
does not accept an argument. The option is accepted as if no argument
were used.
Action
Correct the command before reinvoking the preprocessor.
026
ERROR: [option] argument missing.
Explanation
The named option requires an argument, but one was not specified.
Action
Correct the command before reinvoking the preprocessor.
027
ERROR: [option-a] is valid only if [option-b] is also specified.
Explanation
The first named option may be used only in conjunction with the
second named option.
Action
Correct the command before reinvoking the preprocessor.
028
WARNING: [option] is superflous or unknown. Ignored.
Explanation
The named option was either used elsewhere in this command
or was not a valid option for this command.
Action
Correct the command before reinvoking the preprocessor.
Note that if the option has been specified more than once,
the identified instance may not necessarily be the first occurrence.
029
NOTE: No commands translated.
Explanation
No CICS or DL/I commands were translated. This can occur if the
nocics
or nodli
options were specified but CICS or DL/I commands
were used. If this occurs, message 034 will be issued for
each command in the file.
Action
Determine if
the nocics
or nodli
options have been incorrectly specified either
when the preprocessor is invoked or in a #pragma options
statement.
030
WARNING: More than 16 options specified. [option] ignored.
Explanation
No more than 16
options can be specified in a single occurrence
of this command. Subsequent options are ignored.
This message is issued for each option after 16.
Action
Divide the command into two or more commands.
031
NOTE: "nohandle" assumed for GDS command.
Explanation
All EXEC CICS GDS commands execute as if the nohandle
option is
in effect.
032
ERROR: [option-a] is required when [option-b] is used.
Explanation
The use of one option is dependent upon use of another.
Action
Correct the command before reinvoking the preprocessor.
033
ERROR: One of [option-list] must be specified.
Explanation
One or more of the options named is required in this command.
Action
Correct the command before reinvoking the preprocessor.
Note that this message may not list all of the possible choices.
034
WARNING: EXEC [command-set] found but [NO-command-set] was specified.
Explanation
A CICS or DL/I command was found in the input file, but
the nocics
or nodli
option is currently in effect.
Action
Determine if the nocics
or nodli
option was incorrectly
specified when the preprocessor was invoked or in a #pragma options
statement.
035
NOTE: Default [option] supplied.
Explanation
The preprocessor created a default value for the named option using the
sizeof
operator. This message occurs when the
DESTIDLENG, FROMLENGTH, KEYLENGTH, LENGTH, PFXLENG, TOLENGTH,
or VOLUMELENG options are not coded explicitly in the command.
The default value created by the preprocessor may be incorrect, depending
on the type of the value used as the operand to sizeof
.
Action
If the default value is correct, no change is needed. Otherwise,
specify the correct length explicitly in the command.
036
ERROR: String or character literal at line [line,] column [col] not terminated.
Explanation
End of file occurred before
the string or character literal beginning in column [col]
of line [line] in the input file was terminated.
Action
Correct the input file before reinvoking the preprocessor.
037
ERROR: Comment at line [line,] column [col] not closed.
Explanation
End of file occurred before
the comment beginning in column [col]
of line [line] in the input file was terminated.
Action
Correct the input file before reinvoking the preprocessor.
038
WARNING: Unknown option ignored.
Explanation
The indicated option was not valid for this command.
Action
Correct the command before reinvoking the preprocessor.
039
ERROR: [Execute] keyword found. Probable missing semicolon.
Explanation
Either the EXEC or EXECUTE keyword was found when a
command option was expected.
Action
This is usually caused by a missing semicolon between two
commands. Correct the input file before reinvoking the preprocessor.
040
ERROR: [option-a] may not be used when [option-b] is used.
Explanation
[option-a] and [option-b] are mutually
exclusive options for this command.
Action
Correct the input file before reinvoking the preprocessor.
041
ERROR: Unable to supply default [option].
Explanation
This message is issued when the FROM option is
omitted in a SEND MAP command, or when the INTO option is omitted
in a RECEIVE MAP command. the preprocessor will create a default value for
these options if the argument to the MAP option is a string literal.
If the argument is not a string literal, this message is issued.
Action
Change the MAP argument to a string literal, or
add the INTO or FROM option to the command.
042
ERROR: Missing or invalid [option] argument.
Explanation
The argument to DFHRESP or DFHVALUE is not one of
the defined arguments.
Action
The argument may have been misspelled. Refer to the CICS
documentation at your site
for a list of defined DFHRESP and DFHVALUE arguments.
043
ERROR: [option-a] may not be used when [option-b] is used.
Explanation
The named options were incompatible in this command.
Action
Correct the command before reinvoking the preprocessor.
044
ERROR: This command may have undiagnosed syntax errors.
Explanation
The preprocessor has diagnosed a previous error for this command that prevents
the command from being completely analyzed.
Action
Correct the command syntax and reinvoke the preprocessor. Inspect the diagnostic
messages to determine if there were any other syntax errors.
045
WARNING: Expecting parenthesized option(s).
Explanation
A #pragma options xopts
statement
was found but no parenthesized list of options follows.
Action
Correct the #pragma options xopts
options before
reinvoking the preprocessor.
046
WARNING: Unknown option [option] ignored.
Explanation
A #pragma options xopts
statement contains
the named option, which is not an the preprocessor option.
Action
The option may have been misspelled.
047
WARNING: Keyword parameter expected for option [option]. Option ignored.
Explanation
The named option, appearing in a
#pragma options xopts
statement, requires a parameter, but
one was not given.
Action
Add the parameter to the option.
048
WARNING: [option] may not be negated. Option ignored.
Explanation
The named option, appearing in a
#pragma options xopts
statement, may not be negated by
adding the no
prefix.
Action
Remove the no
prefix.
049
WARNING: No value given for option [option]. Option ignored.
Explanation
The named option, appearing in a
#pragma options xopts
statement, requires a parameter, but
one was not given.
050
WARNING: [option] is not a keyword option. Option ignored.
Explanation
A parameter was used on the named option in a
#pragma options xopts
statement, but the option does not
accept a parameter.
051
WARNING: [option] may not be specified via #pragma options. Option ignored.
Explanation
The named option may be used only when invoking the preprocessor.
Action
Specify the option on the the preprocessor command line or JCL PARM
string (on MVS).
052
WARNING: Invalid [option] specification [value]. Option ignored.
Explanation
In a #pragma options xopts
statement,
the value specified for the named option
was incorrect or out of range.
053
WARNING: Value of
pagesize
option, [value], is not numeric or is less than 7. [value] is
lines per page.Explanation
In a #pragma options xopts
statement,
the value specified for the pagesize
option
is incorrect or out of range.
The preprocessor will retain the previously defined pagesize
value.
Action
Correct the option value.
The pagesize
option requires a numeric parameter that is at least 7.
054
ERROR: Invalid qualification statement. Expected [value/operator] not found.
Explanation
In a WHERE option, one of the following was expected but not found:
ERROR: More than 12 qualification statements specified.
ERROR: More than 12 values specified in FIELDLENGTH.
WARNING: Field name truncated to [text].
WARNING: Field name [name] does not begin with alphabetic character
WARNING: [option] name is longer than [num] characters and will be truncated.
WARNING: USING assumed.
WARNING: [option] name is longer than [num] characters and will be truncated.
ERROR: More than 14 parent segments specified. Segment [name] ignored
WARNING: No options currently stacked. Options are not changed
.
#pragma options pop xopts
statement was found, but no
options have been pushed.
#pragma options push xopts
and
#pragma options pop xopts
statements in the program to determine
if the pop
statement is superfluous or a push
statment
is missing.
ERROR: The FORCE option is obsolete. Use FORCEPURGE instead of PURGE FORCE.
NOTE: The @ operator was emitted in certain function calls. Please use the AT option at compile time.
ERROR: The EXIT option cannot be used with any of the task-related user exit arguments.
ERROR: The default value of the option [option] may be incorrect.
ERROR: The output filename matches the input filename.
ERROR: The output filename matches the listing filename.
ERROR: The listing filename matches the input filename.