This chapter tells you how to interpret the printed listing produced
by the assembler. The listing is obtained only if the option LIST
is in effect. Parts of the listing can be suppressed by using other
options; for information about the listing options, refer to Controlling your assembly with options.
The High Level Assembler listing consists of up to twelve sections,
ordered as follows:
- High Level Assembler Option Summary
- External Symbol Dictionary (ESD)
- Source and Object
- Relocation Dictionary (RLD)
- Ordinary Symbol and Literal Cross Reference
- Unreferenced Symbols Defined in CSECTs
- Macro and Copy Code Source Summary
- Macro and Copy Code Cross Reference
- DSECT Cross Reference
- USING Map
- General Purpose Register Cross Reference
- Diagnostic Cross Reference and Assembler Summary
The following assembler options are used to control the format,
and which sections to produce, of the assembler
listing:
- ASA
- (z/OS and CMS) Allows you to use American National Standard
printer control characters, instead of machine printer control characters.
- DXREF
- Produces the DSECT Cross Reference section.
- ESD
- Produces the External Symbol Dictionary section.
- EXIT(PRTEXIT(mod3))
- Allows you to supply a listing exit to replace or complement
the assembler's listing output processing.
- LANGUAGE
- Produces error diagnostic messages in the following languages:
- English mixed case (EN)
- English uppercase (UE)
- German (DE)
- Japanese (JP)
- Spanish (ES)
When you select either of the English
languages, the assembler listing headings are produced in the same
case as the diagnostic messages.
When you select either the
German language or the Spanish language, the assembler listing headings
are produced in mixed case English.
When you select the Japanese
language, the assembler listing headings are produced in uppercase
English.
The assembler uses the installation default language
for messages produced in CMS by the ASMAHL command.
- LINECOUNT
- Allows you to specify how many lines are printed on each page.
- LIST
- Controls the format of the Source and Object section of the
listing. NOLIST suppresses the entire listing.
- MXREF
- Produces one, or both, of the Macro and Copy Code Source Summary
and Macro and Copy Code Cross Reference sections.
- PCONTROL
- Controls which statements are printed in the listing, and overrides
some PRINT instructions.
- RLD
- Produces the Relocation Dictionary section.
- RXREF
- Produces the General Purpose Register Cross Reference section.
- USING(MAP)
- Produces the Using Map section.
- XREF
- Produces one, or both, of the Ordinary Symbol and Literal Cross
Reference and the Unreferenced Symbols Defined in CSECTs sections.
The following additional options can be specified when you run
the assembler on CMS:
- LINECOUN
- An abbreviation of the LINECOUNT option.
- PRINT
- The assembler listing is written to the virtual printer instead
of to a disk file.
The sections in the listing are described on the following pages.