Primary Controls

III.8.1 Primary Controls

$DATE (string) Inserts a date string into the list file page header. If $DATE() is specified, the actual date is inserted. Date strings will be truncated to a maximum length of 11 characters.
Default is: no date string.
The control has no effect, when the $NOPAGING control has been specified.

$DEBUG Includes debug information into the OMF-51 module. When generating Intel-HEX file output, $DEBUG has no effect.

$NODEBUG Don't include debug information. (Default!)

$MACRO (n) Save macro definitions and expand macro calls. (Default!)
Optionally reserve n % of free memory for macro definitions.
(0 <= n <= 100)
Default is n=50.
The control has been implemented for compatibility purposes only. In ASEM-51 it has no effect except that it cancels the $NOMACRO control.

$NOMACRO Don't save macro definitions and don't expand macro calls.
Reserve all free memory for the symbol table.
The control has been implemented for compatibility purposes only. In ASEM-51, it only suppresses the macro expansion.

$MOD51 Switches on the built-in 8051 special function register and interrupt symbol definitions. (Default!)

$NOMOD51 Switches off the built-in 8051 special function register and interrupt symbol definitions. The predefined symbols ??ASEM_51 and ??VERSION cannot be switched off!

$PAGING Switches on the page formatting in the list file. (Default!)

$NOPAGING Switches off the page formatting in the list file.

$PAGELENGTH (n) Sets the list file page length to n lines.
(12 <= n <= 65535)
Default is n=64.
The control has no effect, when the $NOPAGING control has been specified.

$PAGEWIDTH (n) Sets the list file page width to n columns.
(72 <= n <= 255)
Default is n=132.

$PHILIPS Switches on the Philips 83C75x family support option. This disables the LJMP, LCALL, and MOVX instructions as well as the XDATA and XSEG pseudo instructions. Generic jumps and calls will always assemble to absolute addressing.

$SYMBOLS Generates the symbol table at the end of the list file. (Default!)
When the $XREF control is active, $SYMBOLS has no effect!

$NOSYMBOLS Suppresses the symbol table at the end of the list file.
When the $XREF control is active, $NOSYMBOLS has no effect!

$NOBUILTIN Suppresses the predefined (built-in) symbols in the symbol table or cross-reference listing for a better survey. Only the user-defined symbols are listed.

$NOTABS Expands all tab characters in the list file output to blanks.

$XREF Generates a cross-reference listing instead of a symbol table. Note that this slightly slows down assembly, and consumes about 67 % more memory space!

$NOXREF Generates a symbol table instead of a cross-reference listing. (Default!)

Examples:

      $NOMOD51             ;switch off 8051 SFR symbol definitions
      $PAGELENGTH(60)      ;set page length to 60 lines per page
      $PW(80)              ;set page width to 80 characters per line
      $NOSYMBOLS           ;no symbol table required
      $NOTABS              ;printer doesn't support tab characters
      $DATE(2. 8. 95)      ;date of latest version
      $XREF                ;generate a cross-reference listing
      $ DEBUG NOPAGING     ;include debugging information into OMF-51
                           ;modules, and suppress page formatting