KAP can generate a listing file. As the default, this file
contains the original program with notes concerning what KAP
did with the program. Other information can be selected with the
-listoptions
command switch. See Chapter 9 for examples of the available information.
Source and transformed code listings include an Actions section noting what KAP did do, or could not do, with each loop. The notations indicate that class of message was issued for the marked statement. The following section explains these classes.
The list of error and diagnostic messages that appears later in this appendix is organized by class, and within each class is sorted alphabetically.
-listoptions=o or =t
). In addition, syntax error and warning messages are written only
as part of the original (-listoptions=o
) code listing.
If syntax errors or warnings are found, a brief note stating that
syntax errors or warnings were found will be written to the error
file.
The Loop Table requested with -listoptions=l
has
a status column with a short description of what KAP did with
the loop, or why it could not optimize it. Section 9.1.4 contains the possible messages that can appear
there, with a longer explanation of each.
In addition to the messages written to the listing file, there is
a small number of messages that can appear in the error file. Most
of these are issued for conditions like command switch errors or
missing files, which prevent KAP from running at all. These messages
are brief and self-explanatory.