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:

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:

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 ]