Data Definition Language (DDL) Reference Manual

DDL Language Elements
Data Definition Language (DDL) Reference Manual—529431-004
2-15
Compiler Listing Comments
Compiler Listing Comments
The DDL compiler puts compiler listing comments only in its compiler listing, not in the
dictionary or in host-language source code files. Like dictionary comments, DDL has
two types of listing comments:
•
User-Defined Compiler Listing Comments on page 2-15
•
Production Comments on page 2-15
User-Defined Compiler Listing Comments
The DDL compiler always puts user-defined compiler listing comments in its compiler
listing. You cannot suppress these comments as you can suppress dictionary
comments.
A user-defined compiler listing comment begins with an exclamation point (!) and ends
at the next exclamation point or at the end of the input line. You can include a listing
comment on the same line as a DDL statement. You cannot include a listing comment
on the same line as a command.
A listing comment can be on a line by itself or between clauses in a statement.
In Example 2-8 on page 2-15:
•
The first comment is “!employee #!”.
•
The second comment is “! used by EMPLOYEE“.
Production Comments
The DDL compiler always puts production comments in the compiler listing. Production
comments follow the name of each compiled element to describe the compiler actions.
Production comments include error and warning messages.
Like user-defined listing comments, production comments occur only in the compiler
listing. You cannot suppress any production comments except warning messages,
which you can suppress by issuing a NOWARN command.
Example 2-7. User-Defined Compiler Listing Comment on Line by Itself
!Suppress the listing of dictionary comments
?NOCLISTIN
Example 2-8. User-Defined Compiler Listing Comments Between Clauses
DEFINITION empnum !employee #! PIC 9(4). ! used by EMPLOYEE