Getting listings
Get the information that you need for debugging by requesting the appropriate compiler listing with the use of compiler options.
About this task
Attention: The listings produced by the compiler are not a programming interface and are subject to change.
Use | Listing | Contents | Compiler option |
---|---|---|---|
To check a list of the options in
effect for the program, statistics about the content of the program,
and diagnostic messages about the compilation To check the locale in effect during compilation |
Short listing |
Locale line that shows the locale in effect |
NOSOURCE , NOXREF , NOVBREF , NOMAP , NOLIST |
To aid in testing and debugging your program; to have a record after the program has been debugged | Source listing | Copy of your source | SOURCE |
To find certain data items; to see the final storage allocation after reentrancy or optimization has been accounted for; to see where programs are defined and check their attributes | Map
of DATA DIVISION items |
All DATA
DIVISION items and all
implicitly declared items Embedded map summary (in the right margin
of the listing for lines in the Nested program map (if the program contains nested programs) |
MAP2 |
To find where a name is defined, referenced,
or
modified; to determine the context (such as whether a statement was
used in a PERFORM block) in which a procedure is
referenced; to determine the file from which a copybook was obtained |
Sorted cross-reference listing of names; sorted cross-reference listing
of COPY/BASIS statements
and copybook files |
Data-names, procedure-names, and program-names;
references to these names
Embedded modified cross-reference provides line numbers where data-names and procedure-names were defined |
XREF2,3 |
To find the failing statement in a program or the address in storage of a data item that is moved while the program is running | PROCEDURE DIVISION code
and assembler
code produced by the compiler3 |
Generated code | LIST2,4 |
To find an instance of a certain statement | Alphabetic listing of statements | Each statement used, number of times each statement was used, line numbers where each statement was used | VBREF |
|
Example: short listing
Example: SOURCE and NUMBER output
Example: MAP output
Example: embedded map summary
Example: nested program map
Example: XREF output: data-name cross-references
Example: XREF output: program-name cross-references
Example: XREF output: COPY/BASIS cross-references
Example: XREF output: embedded cross-reference
Example: VBREF compiler output
Example: SOURCE and NUMBER output
Example: MAP output
Example: embedded map summary
Example: nested program map
Example: XREF output: data-name cross-references
Example: XREF output: program-name cross-references
Example: XREF output: COPY/BASIS cross-references
Example: XREF output: embedded cross-reference
Example: VBREF compiler output