COOL diagnostic messages have the form
LSCL[num] [severity]: [message text]On UNIX, they have the form
cool: [severity] [num]: [message text]
where num is the message number severity NOTE, WARNING, or ERROR message text is an description of an action (NOTE),possible problem (WARNING), or condition that will prevent further processing (ERROR).Messages are written to
stdout
if the term(-t)
option is in effect;
they are written to the listing if a listing is created. If a WARNING message
is generated, the final return code from COOL will be no less than 4. If
an ERROR message is generated, COOL will terminate immediately with a
return code of 8.
Messages 1972 - 1979 describe errors generated by the COOL
driver program, COOLB. These messages are
always written to stderr
even if NOTERM
is specified.
They are not written to the listing.
Note:
The COOL message prefix LSCL has been omitted from the descriptions
below.
LSCL Messages
1000
ERROR: There is not enough storage to continue.
Explanation
COOL attempted to allocate more storage but the allocation failed.
Action
If you are running COOL in MVS-batch, increase the size of the region using
the REGION= parameter on the JOB or EXEC statement in your JCL. If you
are running COOL in TSO, increase your TSO region size. If you are
running in CMS, increase the size of your virtual machine.
Normally, COOL keeps all its data in storage until it has processed all the input
files. If you are processing very large groups of object files in a
370-mode virtual machine, COOL may need more storage than is available. Use the ???
option so that COOL will use work files instead of keeping all data in
storage. Note, this will increase the length of time require to
process the object files. If you are running COOL in MVS-batch, you
will probably need to increase the amount of time allocated to the job.
1001
WARNING: The option "[option]" is undefined.
Explanation
The option specified by [option] is not defined by COOL.
Action
The option may
be misspelled. Refer to the
SAS/C Compiler and Library User's Guide, Fourth Edition
for a list of COOL options. Re-run COOL with the corrected option.
1002
ERROR: Can't [open | close | write to] the [input | included | output | listing] file "[name]."
[The reason given was "reason"]
Explanation
An error occurred while processing the input, output, or listing file
identified by [name]. In MVS, TSO, and CMS, this message will be
accompanied by a run-time library diagnostic message containing more detail about
the condition. In UNIX, [reason] is the strerror
information associated
with the error.
Action
Correct the condition and re-run COOL.
1003
ERROR: The output file name is required but was not specified.
Explanation
UNIX only: Use the -o
option to specify the name of the output file.
1004
ERROR: There were no input files specified.
Explanation
No input object files were specified on the command line.
Action
Re-run COOL, including at least one object file name
on the command line.
1005
ERROR: Record [num] in the input object file "[name]" has an unsupported format. A data display follows:
Explanation
COOL encountered a record that is not a valid object record. [name] is
the file in which the record occurs, and [num] is the record number.
This occurs when a file
that is not an object file is specified as input or, rarely,
when an object file contains non-standard records.
Action
Make sure that all the input
files are object files. If the file is an object file but contains
non-standard records, refer to the documentation for the program that
produced the file for information about how to use the file. If the
file is an object file produced by the compiler or C++ translator,
report this message to SAS/C Technical Support.
Since object records are in
binary format, COOL displays the contents of the record in a formatted
text display that looks like this:
.TXT ... .. ...00.. MAIN(FFIND) .......................,.....0...J........
0EEE4000440344004FF214444DCCD4CCCDC5440300010000000000009ED0155EC04FE01D00000000
23730000000800017008100004195D66954D000200180000000000000A0C8F800470008100000000
1006
ERROR: No control section is defined for ESD item [item] in record [num] in input object file "[name]." A data display follows:
Explanation
COOL encountered a malformed object record in the file identified as
[name] at record number [num]. The object file may have been corrupted by an
editor or have been partially overwritten by another program.
Action
Re-compile the source file and re-run COOL. If the problem persists,
contact SAS/C Technical Support. Refer to message 1005 for
a description of the data display.
1007
ERROR: Text record [num] in the input object file "[name]" refers to a non-existent ESDID item. A data display follows:
Explanation
Refer to the explanation in message 1006.
1008
ERROR: The RLD item at data offset [num] in record [num] in the input object file "[name]" refers to a non-existent [position | relocation]
ESDID item.
Explanation
Refer to the explanation in message 1006.
1009
ERROR: The section name "[sname]" occurs in both the "[name1]" and "[name2]" input object files.
Explanation
Both of the named object files were assigned the section name [sname] by
the compiler. Since the compiler uses the section name to create some
external symbols, this can cause problems when linking. This problem
can occur when the name of the first external
function becomes the default section name, and both
have the same initial seven characters.
Action
Re-compile the source files using the compiler's sname
option to assign a unique section name to each file and re-run COOL. In
the extremely rare case where more than one object file must have the
same section name, use the DUPSNAME option to suppress this message.
1010
NOTE: Pre-linking completed with return code = [num]
Explanation
COOL completed processing the input files. The final return code was
[num].
1011
ERROR: An invalid [INCLUDE | INSERT | ARLIBRARY | control | continuation of control] statement was detected. A data display follows:
Explanation
A control statement of the specified type was found in an input file.
Action
Refer to the explanation of
message 1005 for a description of the data display.
Correct the statmeent and re-run COOL.
1012
ERROR: Unexpected end-of-file, or the file "[name]" is not a valid ar370 archive.
Explanation
This message is issued when COOL tries to read information from the
named ar370 archive but the archive is too small. This is usually
caused by a
corrupted archive.
Action
Re-build the archive and re-run COOL.
1013
ERROR: There is a duplicated definition of "[symbol]" in input object files "[name1]" and "[name2]."
Explanation
Both of the named input object files contain a definition of the
external symbol [symbol]. This is usually caused by defining an external
symbol in more than one compilation in a non- reentrant program. Only
one compilation in a program should define an external symbol.
Action
Correct the problem and re-run COOL.
1014
WARNING: The input object file "[name]" contains duplicate initialization data for symbol "[symbol]"
Explanation
The named input object file contains initialization data for the
external symbol [symbol], but COOL has already processed initialization
data for this symbol in a previous input file. This is usually caused
by defining an external symbol in more than one compilation in a
reentrant program. COOL discards the second (and subsequent) initial
values, but assigns the strongest alignment and longest length of all
the initial values. Only one compilation in a program should define an
external symbol.
Action
Correct the problem and re-run COOL.
1015
NOTE: The reference to "[symbol]" was resolved from "[name]"
Explanation
During autocall processing, COOL found the definition of the named
symbol when it included file [name]. This message is for information only,
and is emitted only when the VERBOSE option is used.
1016
WARNING: The file "[name]" was included but did not define "[symbol]"
Explanation
During autocall processing, COOL tried to resolve external symbols by
reading a file whose name was the same as the symbol name. COOL
attempted to resolve the external reference symbol by including file
[name]. However, file [name] did not contain a definition for symbol. If
[name] is supposed to contain the definition for [symbol], check the source
file to determine why [symbol] is not defined.
1017
WARNING: The reference to "[symbol]" in "[name]" is unresolved.
Explanation
COOL completed autocall processing but did not find a definition for the
external reference symbol found in file name. This does not necessarily
indicate a problem if the definition will be supplied during subsequent
linking, or if the reference is never used when the program executes.
Otherwise, the reference may be misspelled, or the object file that
contains the definition was omitted from the COOL input files.
When running under UNIX, this message is a NOTE if the LET
or
-m
option is specified.
1018
WARNING: In the "[csect]" CSECT in input object file "[name]" the "[symbol]" pseudoregister displacement at offset [num] has been truncated.
Explanation
The PREM
option is in effect. As COOL removed psuedoregisters from the
output object file, it determined that object file [name] defined a Q-type
address constant for [symbol] having a length too small to contain the
pseudoregister offset. For example, the offset is greater than 255 but
the address constant is defined as QL1. This can only occur in object
files created from assembler language source files. [num] is the offset
from the start of the CSECT at which the address constant occurs.
Action
Increase the size of the address constant, re-assemble the source file,
and re-run COOL.
1019
ERROR: "[name]" is not the name of a CMS file.
Explanation
CMS only: The string [name] was used as the name of a input file, output
file, or listing file, but the string cannot be used to form the name of
a CMS minidisk or Shared File System file.
Action
Consult SAS/C Library Reference, Volume I,
for an explanation of how these fileids are formed.
1020
NOTE: No pseudoregisters were found in the input files.
Explanation
The PREM
option was specified but no pseudoregisters were found in the
input files. This message is for information only.
1021
WARNING: The ar370 archive "[name]" contains data inconsistent with the actual file. This file will be ignored.
Explanation
This message is issued when COOL detects a pointer in the header of the
named ar370 archive that is outside the bounds of the archive itself.
This is caused by a corrupted archive.
Action
Re-build the archive and re-run COOL.
1022
WARNING: Only ar370 archives preceding this one will be used.
Explanation
MVS/TSO only: This message is only issued in conjunction with
messages 1012 and 1021 when the CONTINUE
option is used. The corrupted
ar370 archive is a member of a concatenation, following at least one
uncorrupted archive. COOL will continue processing using the
uncorrupted archives in the concatenation, but will ignore the data in
the corrupted archive and any archives that may follow it in the
concatenation.
1023
ERROR: Some text data is missing in the extended names CSECT "[csect]" in file "[name]."
Explanation
COOL encountered a malformed object record in the extended names CSECT
[csect] in the file identified as [name]. The object file may have been
corrupted by an editor or have been partially overwritten by another
program.
Action
Re-compile the source file and re-run COOL. If the problem
persists, contact SAS/C Technical Support.
1024
NOTE: The "[type]" control statement was not processed, and was copied to the output file.
Explanation
COOL encountered a linkage editor control statement (such as IDENTIFY
or CHANGE
) in one of the input files. COOL simply copies the statement to
the output file. This message is for information only.
1025
NOTE: [Beginning | End of] "[name]" processing.
Explanation
This message is only issued when the VERBOSE
option is specified
and COOL has started or finished processing an input file.
1026
WARNING: The specified DDname prefix contains invalid characters: "[prefix]"
Explanation
MVS/TSO only: The DDname prefix [prefix] specified by the
FILES
option is
not a valid DDname prefix. The prefix must be 1 to 3 characters, and
the first character must be alphanumeric or $, @, or #. The remaining
characters must be alphanumeric.
1027
WARNING: The value specified for the "[-p | -zf]" option is not in the range of acceptable values.
Explanation
Either the pagesize
(-p
) or maxfiles
(-zf
) option specified a value that
was out of range for that option. The value of the pagesize
option must
be an integer greater than or equal to 5 or -1 to suppress pagination.
The maxfiles
option must be a positive integer.
1028
WARNING: The file "[name]" could not be opened for autocall.
Explanation
During autocall processing, COOL tried to open the file [name] to resolve
an external symbol but could not. If another input file defined the
symbol that COOL was trying to resolve, this is not a
problem. However, if this file is required to resolve the symbol,
ensure that the file contains the symbol definition and is available to
COOL as either primary or secondary input.
1029
ERROR: A BSAM error occurred while processing the file "[name]." The following message(s) were passed to the error analysis routine: [message1] [message2]
Explanation
MVS only: COOL handled a BSAM error while opening or reading the named
input file. BSAM called the error analysis routine with the information
displayed as [message1]. If the input file is a member in a PDSE,
additional information about the error is displayed as [message2].
This message may indicate a hardware failure, or it may indicate that
the named file is not concatenated correctly.
Action
If the named file is a concatenation, verify that the concatednated
files all have the same DCB characteristics. If the problem is not an
invalid concatenation, report the problem to your site's System
Programming staff for assistance.
1030
ERROR: An unexpected end-of-file was encountered after record [num] in the input object file "[name]"
Explanation
COOL processed a control statement that had a non-blank character
in column 72, indicating that the control statement was continued in the
next record. However, the input file ended after the current record.
Action
There may be a spurious non-blank character in column 72 of the control
statement. Remove it and re-run COOL.
1031
ERROR: The continuation of the "[keyword]" control statement at record [num] in the input object file "[name]" is not a valid control statement.
A data display follows:
Explanation
COOL processed a control statement that had a non-blank character
in column 72, indicating that the control statement was continued in the
next record. However, the next record in the input file was not a
control statement.
Action
There may be a spurious non-blank character in
column 72 of the control statement. Remove it and re-run COOL. Refer
the explanation of message 1005 for a description of the data display.
1032
ERROR: The "[keyword]" control statement at record [num] in the input object file "[name]" is not in the correct format.
Explanation
The specified control statement has a syntax error.
Action
Correct the error and re-run COOL.
1033
ERROR: In the continuation of the "[keyword]" control statement at record [num] in the input object file "[name]", columns 1 through 15 must be blank.
Explanation
The second and subsequent record parts of a continued control statement
must begin in column 16 or after of the continuation record.
Action
Correct the error and re-run COOL.
1034
WARNING: An INCLUDE statement was found at record [num] in the included object file "[name]." Data following this record are not processed.
Explanation
COOL has encountered an INCLUDE
statement in the included file name. This
message is a reminder that no data following the INCLUDE
statement will
be processed.
By default, COOL handles INCLUDE
statements in included files the same
way the IBM linkage editor handles them. That is, when an included file
contains an INCLUDE statement
, the specified module(s) are also
included, but any data following the INCLUDE
statement is ignored.
Action
This behavior can be overridden by specifying the
noinceof
option (in MVS/TSO or CMS) or the -zi
option in UNIX.
1035
ERROR: The input object file "[name]" can't be reopened. The maxfiles limit has been reached and no files can be quiesced.
Explanation
The specified file was temporarily closed (quiesced) but cannot be
reopened. COOL uses the value of the maxfiles
option to determine how
many input files to have open simultaneously. This number has been
reached, so COOL temporarily closed one of its input files. However,
this file can not be reopened.
Action
Re-run COOL, specifying a larger value
for maxfiles
. If the problem persists, contact SAS/C Technical Support.
1036
ERROR: An unknown error occurred while reopening "[name]."
Explanation
The specified file was temporarily closed (quiesced) but an error
occurred when COOL tried to reopen it. The file may have been erased by
another program.
Action
Look for operating system messages or run-time library
diagnostics that may help explain the problem. If the problem persists,
contact SAS/C Technical Support.
1037
WARNING: The "[prefix1]" GATHER prefix is longer than 6 characters. It will be truncated to "[prefix2]"
Explanation
GATHER
prefixes may be no longer than 6 characters.
COOL will truncate
[prefix1] to the value shown as [prefix2].
1038
WARNING: A symbol matching the GATHER table name "[symbol]" is defined in input file "[name]"
Explanation
An external symbol having the same name as a GATHER
table is defined in
the input file name. This is likely to cause the program to fail
when it is executed.
Action
Change the symbol name so that the GATHER
table name is unique to the input files.
1039
WARNING: The duplicated "[prefix]" GATHER prefix will be ignored.
Explanation
The prefix was specified more than once in the input files. The second
and subsequent specifications are ignored.
1040
WARNING: The inserted symbol "[symbol1]" is longer than 8 characters and will be truncated to "[symbol2]"
Explanation
Symbols in INSERT
control statements must be no more than eight
characters long. The symbol [symbol1] will be truncated on the right to
the symbol shown as [symbol2].
Action
If this is not correct, change the INSERT
control statement and re-run COOL.
1042
WARNING: SMP identifiers distribution library and element id are not matched.
Explanation
SAS/C SMP Supporting Libraries are incorrect.
Action
Call SAS/C Technical Support.
COOLB Diagnostic Messages
The following messages are produced by the COOL driver program, COOLB.
They are
always written to
(MVS/TSO Only)stderr
even if NOTERM
is specified; they
are not written to the listing.
1972
WARNING: Option "[option]" begins with a parenthesis.
Explanation
No COOL option can begin with a parenthesis. This error is probably
caused by inserting a blank between an option and its parenthesized
argument list.
Action
Remove the intervening blank(s) and re-run COOL.
1973
WARNING: For option [option], [text1] was expected but [text2] was found.
Explanation
COOLB detected a syntax error in the specification of [option].
Action
Refer to The SAS/C Compiler and Library User's Guide, Fourth Edition
for the syntax of COOL options.
Correct the error and re-run COOL.
1974
WARNING: Option [option] does not take arguments.
Explanation
[option] was followed by a parenthesized argument list, but this
option does
not accept any arguments.
Action
Remove the argument list and re-run COOL.
Refer to
The SAS/C Compiler and Library User's Guide, Fourth Edition
for a list of COOL options.
1975
WARNING: Option [option] expects arguments.
Explanation
[option] requires a parenthesized argument list. For example, the
pagesize
option must be specified as pagesize(nn)
, where nn
is the number of lines to be printed on a listing page.
Action
Add the necessary argument and re-run COOL.
Refer to The SAS/C Compiler and Library User's Guide, Fourth Edition for a
list of COOL options.
1976
WARNING: Option [option] cannot be negated.
Explanation
Option is prefixed with "no
," but option cannot be negated. For
example, it is not possible to specify nopagesize
as an option.
Action
Remove the NO
prefix and re-run
COOL. Refer to The SAS/C Compiler and Library User's Guide, Fourth Edition
for a list of COOL options.
1977
WARNING: Option [option] is not recognized.
Explanation
[ption] is not a COOL option.
Action
Remove the word from the parameter list and re-run COOL.
Refer to The SAS/C Compiler and Library User's Guide, Fourth Edition
for a list of COOL options.
1978
WARNING: Option abbreviation is ambiguous ([option1] vs [option2]).
Explanation
COOL options may be abbreviated to the fewest unambiguous characters,
but abbreviation is too short to clearly indicate which COOL option is
intended. The abbreviation could mean either [option1] or [option2].
Action
Extend the abbreviation enough to indicate which option is intended and re-run
COOL.
1979
WARNING: Linking was suppressed. [1 error was | [num] errors were] encountered.
Explanation
This message is issued when at least one error is diagnosed in the
options list. COOLB does not invoke COOL or the system linker.
Action
Refer to
The SAS/C Compiler and Library User's Guide, Fourth Edition
,for a list of COOL options. Correct the error and re-run COOL.