LSCP CICS Preprocessor Messages
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 [Error]
- provides information about conditions that will
cause 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.
SEVERE: Not enough storage to continue.
An attempt to allocate storage failed.
Increase the virtual machine or region size.
WARNING: Unknown option [option] ignored.
The specified option was not a preprocessor option.
The option may have been misspelled.
WARNING: Keyword parameter expected for option [option]. Option ignored.
A required parameter was not given for the specified
option.
WARNING: [option] is not a keyword option. Option ignored.
A parameter was used on an option that does not require
one.
WARNING: [option] may not be negated. Option ignored.
An option, such as pagesize, was incorrectly preceded by
no, but the option may not be negated.
SEVERE: Unable to open the [file] file.
The specified required file could not be opened.
MVS and CMS only: refer to the run-time library messages
on stderr for more information about why the file could not be opened.
SEVERE: Error occurred while reading from the [file] file.
The specified required file could not be used for
input any longer.
MVS and CMS only: refer to run-time library messages
on stderr for
more information about the error.
SEVERE: Error occurred while writing to the [file] file.
The specified required file could not be used for
output any longer.
MVS and CMS only: refer to run-time messages on stderr for
more information about the error.
WARNING: Invalid DDname prefix [prefix] specified by FILES option. DDname prefix set to default value.
MVS only: The specified prefix is longer than
three characters or contains a character that may not appear in a DDname.
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 $.
WARNING: Value of pagesize option, [value] is not numeric or is less than 7. Page size is unchanged.
The pagesize option requires an integer parameter
greater or equal to 7.
pagesize(7) will cause
the source listing to be printed with only one line per page.
WARNING: No value given for option [option]. Option ignored.
A required parameter was not given for the specified
option.
SEVERE: Cannot access character translation table.
The custom character translation table could not be loaded.
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.
WARNING: Invalid [option] specification [value]. Option ignored.
The parameter for the specified option was
incorrect or out of range.
SEVERE: Unexpected end of file on input file.
An end-of-file condition occurred while a comment,
string literal, character literal, CICS, or DL/I command was being
processed.
WARNING: Input line length exceeds output line length.
A line in the input file was longer than may be
contained in a single line in the output file.
On MVS, increase the output file LRECL. On CMS or UNIX, split the line
in the input file into several shorter lines.
SEVERE: Error occurred while closing the [file] file.
The specified file could not be closed.
If the file is the output file, it may not be usable.
MVS and CMS only: refer to run-time messages for
more information about the error.
SEVERE: Cannot access translation data for [command-set] commands.
command-set is either CICS or DL/I. An
error occurred when the preprocessor attempted to dynamically load the
translation data load module.
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.
WARNING: Right parenthesis assumed.
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.
Ensure that all option arguments are properly enclosed in parentheses.
WARNING: Semicolon assumed.
A command contains a token that is not an option or an argument.
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.
ERROR: No command function specified.
A CICS command was terminated by a semicolon before the command
function was specified.
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.
ERROR: Unknown [command-set] function.
command-set is either CICS or DL/I.
The named function was not a valid function.
The function name may have
been misspelled. Correct the command before reinvoking the preprocessor.
ERROR: Argument is not associated with an option.
Two successive parenthesized arguments
were found. Each argument must be preceded by an option.
Correct the command before reinvoking the preprocessor.
ERROR: Expected [option] argument not specified.
The named option requires an argument, but the argument was not
found.
Correct the command before reinvoking the preprocessor.
ERROR: Unexpected argument after [word].
A parenthesized argument was found where it was not expected.
Correct the command before reinvoking the preprocessor.
ERROR: [option] required but not specified.
A required option was not found in this command.
Correct the command before reinvoking the preprocessor.
WARNING: [option] argument ignored. [option] assumed.
A parenthesized argument was found following an option that
does not accept an argument. The option is accepted as if no argument
were used.
Correct the command before reinvoking the preprocessor.
ERROR: [option] argument missing.
The named option requires an argument, but one was not specified.
Correct the command before reinvoking the preprocessor.
ERROR: [option-a] is valid only if [option-b] is also specified.
The first named option may be used only in conjunction with the
second named option.
Correct the command before reinvoking the preprocessor.
WARNING: [option] is superfluous or unknown. Ignored.
The named option was either used elsewhere in this command
or was not a valid option for this command.
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.
NOTE: No commands translated.
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.
Determine if
the nocics or nodli options have been incorrectly specified either
when the preprocessor is invoked or in a #pragma options statement.
WARNING: More than 16 options specified. [option] ignored.
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.
Divide the command into two or more commands.
NOTE: "nohandle" assumed for GDS command.
All EXEC CICS GDS commands execute as if the nohandle option is
in effect.
ERROR: [option-a] is required when [option-b] is used.
The use of one option is dependent upon use of another.
Correct the command before reinvoking the preprocessor.
ERROR: One of [option-list] must be specified.
One or more of the options named is required in this command.
Correct the command before reinvoking the preprocessor.
Note that this message may not list all of the possible choices.
WARNING: EXEC [command-set] found but [NO-command-set] was specified.
A CICS or DL/I command was found in the input file, but
the nocics or nodli option is currently in effect.
Determine if the nocics or nodli option was incorrectly
specified when the preprocessor was invoked or in a #pragma options
statement.
NOTE: Default [option] supplied.
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.
If the default value is correct, no change is needed. Otherwise,
specify the correct length explicitly in the command.
ERROR: String or character literal at line [line,] column [col] not terminated.
End of file occurred before
the string or character literal beginning in column [col]
of line [line] in the input file was terminated.
Correct the input file before reinvoking the preprocessor.
ERROR: Comment at line [line,] column [col] not closed.
End of file occurred before
the comment beginning in column [col]
of line [line] in the input file was terminated.
Correct the input file before reinvoking the preprocessor.
WARNING: Unknown option ignored.
The indicated option was not valid for this command.
Correct the command before reinvoking the preprocessor.
ERROR: [Execute] keyword found. Probable missing semicolon.
Either the EXEC or EXECUTE keyword was found when a
command option was expected.
This is usually caused by a missing semicolon between two
commands. Correct the input file before reinvoking the preprocessor.
ERROR: [option-a] may not be used when [option-b] is used.
[option-a] and [option-b] are mutually
exclusive options for this command.
Correct the input file before reinvoking the preprocessor.
ERROR: Unable to supply default [option].
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.
Change the MAP argument to a string literal, or
add the INTO or FROM option to the command.
ERROR: Missing or invalid [option] argument.
The argument to DFHRESP or DFHVALUE is not one of
the defined arguments.
The argument may have been misspelled. Refer to the CICS
documentation at your site
for a list of defined DFHRESP and DFHVALUE arguments.
ERROR: [option-a] may not be used when [option-b] is used.
The named options were incompatible in this command.
Correct the command before reinvoking the preprocessor.
ERROR: This command may have undiagnosed syntax errors.
The preprocessor has diagnosed a previous error for this command that prevents
the command from being completely analyzed.
Correct the command syntax and reinvoke the preprocessor. Inspect the diagnostic
messages to determine if there were any other syntax errors.
WARNING: Expecting parenthesized option(s).
A #pragma options xopts statement
was found but no parenthesized list of options follows.
Correct the #pragma options xopts options before
reinvoking the preprocessor.
WARNING: Unknown option [option] ignored.
A #pragma options xopts statement contains
the named option, which is not an the preprocessor option.
The option may have been misspelled.
WARNING: Keyword parameter expected for option [option]. Option ignored.
The named option, appearing in a
#pragma options xopts statement, requires a parameter, but
one was not given.
Add the parameter to the option.
WARNING: [option] may not be negated. Option ignored.
The named option, appearing in a
#pragma options xopts statement, may not be negated by
adding the no prefix.
Remove the no prefix.
WARNING: No value given for option [option]. Option ignored.
The named option, appearing in a
#pragma options xopts statement, requires a parameter, but
one was not given.
WARNING: [option] is not a keyword option. Option ignored.
A parameter was used on the named option in a
#pragma options xopts statement, but the option does not
accept a parameter.
WARNING: [option] may not be specified via #pragma options. Option ignored.
The named option may be used only when invoking the preprocessor.
Specify the option on the the preprocessor command line or JCL PARM
string (on MVS).
WARNING: Invalid [option] specification [value]. Option ignored.
In a #pragma options xopts statement,
the value specified for the named option
was incorrect or out of range.
WARNING: Value of pagesize option, [value], is not numeric or is less than 7. [value] is
lines per page.
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.
Correct the option value.
The pagesize option requires a numeric parameter that is at least 7.
ERROR: Invalid qualification statement. Expected [value/operator] not found.
In a WHERE option, one of the following was expected but not found:
-
a field name
-
a field value
-
a relational operator, such as =, >=, ^=, and so on
-
a boolean operator, either AND or OR.
ERROR: More than 12 qualification statements specified.
In a WHERE option, more than 12 qualification statements connected
by AND or OR were found. No more than 12 qualification statements
may be used in a single WHERE option argument.
ERROR: More than 12 values specified in FIELDLENGTH.
In a FIELDLENGTH option,
more than 12 field length values were found.
No more than 12 field length values
may be used in a single FIELDLENGTH option argument.
WARNING: Field name truncated to [text].
A WHERE option argument contained
a field name longer than eight characters. The
field name will be truncated to the specified text.
Ensure that the truncated form of the field name is correct.
WARNING: Field name [name] does not begin with alphabetic character.
A field name must begin with an alphabetic character, but the
specified field name does not.
WARNING: [option] name is longer than [num] characters and will be truncated.
[option] is either PSB, ID, or SEGMENT. The name, specified
as a string literal, was longer than the maximum length permitted by
the option. The name will be truncated on the right
to the number of characters
shown in the message.
WARNING: USING assumed.
The word USING was not specified before the PCB option. It is
assumed.
Change the command to specify USING PCB.
WARNING: [option] name is longer than [num] characters and will be truncated.
[option] is either PSB, ID, or SEGMENT. The name, specified
as a string literal, was longer than the maximum length permitted by
the option. The name will be truncated on the right
to the number of characters
shown in the message.
ERROR: More than 14 parent segments specified. Segment [name] ignored.
No more than 15 segment names, including the name of the object
segment, may be specified in the command.
WARNING: No options currently stacked. Options are not changed.
A #pragma options pop xopts statement was found, but no
options have been pushed.
Review the sequence of #pragma options push xopts and
#pragma options pop xopts
statements in the program to determine
if the pop statement is superfluous or a push statement
is missing.
ERROR: The FORCE option is obsolete. Use FORCEPURGE instead of PURGE FORCE.
The FORCE option of the SET TERMINAL command is now obsolete.
Re-code the command and replace the PURGE FORCE option with the FORCEPURGE
option.
NOTE: The @ operator was emitted in certain function calls. Please use the AT option at compile time.
The preprocessor may translate certain uses of the MAPSET option of the
SEND MAP and RECEIVE MAP commands using the non-standard "@" operator.
Use the AT compiler option when the preprocessed source code is
compiled.
ERROR: The EXIT option cannot be used with any of the task-related user exit arguments.
The EXIT option may not be specified in the ENABLE PROGRAM command when
any of the FORMATEDF, LINKEDITMODE, SHUTDOWN, TALENGTH, or TASKSTART
options is used.
Recode the command without using the EXIT option.
ERROR: The default value of the option [option] may be incorrect.
The preprocessor generated a default value for the named option.
Check the generated C program to ensure that the value is correct. If the
preprocessor did not choose a correct default value, re-code the command
and specify an explicit value for the option.
SEVERE: The output filename matches the input filename.
UNIX only: The same filename was specified for both the input and
output file. The preprocessor cannot create an output file that would
destroy the input file.
Re-run the preprocessor using a different name
for the output file.
SEVERE: The output filename matches the listing filename.
UNIX only: The same filename was specified for both the output and
listing file. The preprocessor can not create both an output file and a
listing file with the same name.
Re-run the preprocessor using a
different name for one of the files.
SEVERE: The listing filename matches the input filename.
UNIX only: The same filename was specified for both the input and
listing file. The preprocessor will not create a listing file that
would destroy the input file.
Re-run the preprocessor using a different
name for the listing file.
ERROR: The argument [value] for [option] should not be a string.
A string constant is being passed as an argument to an
option that requires a data area (e.g., a 1-value).
Correct the command by replacing the string literal with a 1-value.
WARNING: [option] is not valid with the EXCI option, will be ignored.
The named option cannot be used with the EXCI option.
Correct the command before re-invoking the preprocessor.
WARNING: [option] is valid only with the EXCI option, will be ignored.
The named option can be used only in conjunction with the EXCI option.
Correct the command before re-invoking the preprocessor.
Copyright (c) 1998 SAS Institute Inc. Cary, NC, USA. All rights reserved.