Using the assembler listing
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 on 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 should be 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.
[ Top of Page | Previous Page | Next Page | Contents | Index ]