INCLUDE INCLUDE
MAINMOD
"MACR.ASM" ; DEFINE STANDARD MACROS.
"/SYS/COM.ASM" ; DEFINE COMMON BLOCK.
In this example, the statements in file MACR.ASM in the current directory (lUSR) and file COM.ASM in the system directory are assembled at the beginning of module MAINMOD.
MACR.ASM contains macro definition blocks; COM .ASM defines a common section.
REV ,A, FEB 1981
LIST
Assembler Directives-8500 MDL A Series Assembler Users
Turns on listing options
SYNTAX Label Operation Operand
[symbol] LIST
listing-option
[\isting-option[, listing-option] ... ]
PARAMETERS One of the following listing options:
eND-Lists statements that are not assembled because of unsatisfied IF or REPEAT conditions. Defaults to OFF: only those statements that are actually assembled are listed.
CON-Lists assembly enors on the system terminal as well as in the source listing. Defaults to ON.
DBG-Causes the linker listing to include an internal symbols list for this module at link time. Defaults to OFF.
ME-Sets the ME/MEG option to the ME setting: lists all macro expansion statements that are assembled. The ME/MEG option defaults to MEG.
MEG-Sets the ME/MEG option to its default setting, MEG: lists only those macro expansion statements that generate object code.
SYM-Lists the symbol table. Defaults to ON.
TRM-Trims the assembier iisting to 72 characters. The iisting width defaults to 72 characters wide if the listing device is CONO; otherwise the width defaults to 132 characters.
If no option is specified, the source listing is turned ON.
EXPLANATION
The LIST directive turns on the listing option(s) named in the operand field. If no option is named, the master option (which controls the source listing) is turned on. The NOLIST directive may be used to turn any of these options off.
Each option controls a different listing feature and may be turned on or off anywhere in the source module. if an option is changed during a macro expansion, iTs previous setting is restored when the expansion ends.
LIST
Assembler Oirectives-8500 MOL A Series Assembler Users determine which lines of code appear in the source listing, and are discussed in the following paragraphs. The SYM option controls display of the symbol table, and is discussed with the CON, DBG, and TRM options under the heading Other Options.Source Listing
Master Option. The master option is normally ON. The directive NOLIST (without operands) turns the master option OFF, suppressing display of all statements except erroneous ones.
When the master option is OFF, PAGE and SPACE directives are suppressed and the CND and ME/MEG options are overridden. The directive LIST (without operands) turns the master option back ON.
CND. Normally the CND option is OFF, and any statement that is not assembled because of an unsatisfied IF or REPEAT condition is not listed. When the CND option is ON, even unassembled statements are listed.
ME/MEG. The ME/MEG option controls the display of statements in macro expansions. It has three settings: ME, MEG, and OFF. At the default setting, MEG, only those statements that generate object code (assembly language instructions and ASCII, BLOCK, BYTE, and WORD directives) are listed. Note that other directives that directly affect the object module (COMMON, EOU, GLOBAL, NAME, ORG, RESERVE, RESUME, SECTION) are not listed. display of statements outside macro expansions.
Option Settings
LIST
Assembler Oirectives-8500 MOL A Series Assembler Users
Turns on listing options
The following table shows how the master option, ME/MEG option, and CND option control the display of statements in a macro expansion.
Option Settings
Master
ME/MEG eND
Type of Statements ListedOFF a a errors
ON OFF a errors
ON MEG a statements that generate object code (default)
ON ME OFF assembled statements
ON ME ON all statements
adon't care
Other Options
CON. Normally the CON option is ON, and every erroneous statement and its accompanying error message are displayed on the system terminal (CONO) as well as in the source listing.
When the CON option is OFF, erroneous statements and their error messages appear only in the source listing.
DBG. If the DBG option is left at its default setting (OFF), the linker listing will contain no internal symbols list for the current module when the module is linked. If the DBG option is ON when assembly ends, an internal symbols list will be created, and it will list all symbols in the module. The internal symbols list is described in the Linker section of this manual.
SYM.
If the SYM option is left at its default setting (ON), the assembler listing will contain the symbol table as well as the source listing. If the SYM option is OFF when assembly ends, no symbol table is listed. The symbol table is described in the Assembler Introduction section.TRM. Normally, the TRM option is OFF, and the assembler listing contains lines of up to 132 characters. When the TRM option is ON, all lines are truncated to 72 characters. (Source lines that contain more than about 50 characters are truncated, since the source listing displays 20 to 25 characters of information-depending on your microprocessor-to the left of each source line.) If TRM is ON when assembly ends, the symbol table is rearranged to fit a 72-character format
V'Jhe;l the !:sting devise :s the system tarmina! (CONO), the TRM option ;s automaticall'y turned ON before assembly starts. The directive NOLIST TRM restores the 132-character format.