9.2.7 Action Summary

Statements that are translated or modified by KAP are identified by abbreviations in the Action Summary listing field. The notations tell which class(es) of messages were issued for each line or statement. The following list explains each of these classes. KAP lists the abbreviated explanation of its actions at the bottom of the listing. For the DIR class, the class itself usually serves as the message; no detailed message follows. All other class abbreviations indicate a message follows in this class.

The abbreviations and meanings of these classes are as follows:

• DD (Data Dependence) - This message indicates that a data dependence involving this statement prevented optimization.

• DIR (Directive) - This class is used in conjunction with the footnotes, and concerns compiler directives. If you coded a compiler directive and that line does not have the DIR abbreviation in the listing, KAP did not recognize the directive. Check the setting of the /directives switch and the syntax of the directive.

• E (Syntax Error) - These messages indicate syntax errors. These may refer to missing or extra characters, illegal keywords, or text placed in the wrong column. Optimization of such program units is inhibited; the Fortran 90 output file contains a copy of this program unit unmodified by KAP.

• EX (Extension) - These messages show where a construct in the original program is not allowed in the language dialect KAP produces. In some cases an operation or type is allowed in the input language, but not in the output language.

• I (Inserted) - These messages indicate a statement was added by KAP. In several of the scalar transformations, and in output generation, statements must be inserted into the transformed code.

• INF (Informational) - These messages provide noncritical information to the user.

• INL (Inlined Subprogram) - These messages mark lines where a subroutine or function was inlined or interprocedural analyzed. The text of the inlined routine, with appropriate substitutions, appears in the transformed code.

• LR (Loop Reordering) - These messages inform you that a Fortran statement has been modified in the process of interchanging loops. If during optimization KAP ascertains that an outer loop would be more efficient if innermost, and if it is legal to reorder the loops, KAP places the outer loop inside. In the process of doing this, KAP may have to change loop bounds (for triangular loops) or distribute loops or float IF assignments. Only the statements modified to do the exchange are marked where they occurred. Not all statements in the exchanged loops are marked.

• MIS (Miscellaneous) - These messages inform you that some KAP diagnostic information has been lost. This does not mean the program has been transformed improperly, but that some messages generated in the process have been lost.

• NO (Program Too Large) - These messages tell you that the program unit being processed is too large for KAP to optimize due to KAP data structure size limitations. KAP stops optimization and passes the original program unit to the transformed code file unchanged. You must split the program into smaller sections for KAP to process. This class of message rarely appears.

• OT (Output Translation) - These messages indicate KAP changed the name of a modification to avoid a conflict with an intrinsic function name.

• OTF (Output Translation Fails) - These messages mark statements that have constructs that exist in the input language but are not representable in the output language.

• OW (Option Error) - The marked line appears to have a directive or assertion, but either KAP does not recognize it, or it has a syntax error.

• Q (Question) - These messages inform you that KAP attempted to optimize a loop nest, but discovered a data dependence that it could not break at compilation time without further information. The information may be available to you and you can answer the question with an appropriate assertion.

• STD (Standardized) - These messages mark where a program has been changed to a more standard form to improve the chance of finding optimizable code. The dusty-deck transformations KAP performs (for example, converting an IF/GOTO into a block IF) use this notation.

• TE (Translator Error) - These messages inform you of an internal KAP error. A traceback is written to the listing file. The traceback and the code that caused it should be sent to your software vendor so a correction can be made. If the error can be reproduced in a small program unit, that small program unit will be easier to work from and may speed isolating the problem.

• W (Warning) - These messages contain syntax warnings.