| ||||
| Home Products Download Events Support | ||||
Technical Support
On-Line Manuals
A166 User's Guide
A166 Introduction 
Assembling Programs 
Environment Settings Command Prompt ERRORLEVEL Output Files Listing (LST) File Object (OBJ) File Conditional Assembly Directives Reference ABSOLUTE CASE COND DATE DEBUG EJECT ELSE ELSEIF ENDIF ERRORPRINT EXPDECNUM EXTMAC GEN GENONLY IF INCDIR INCLUDE LIST MACRO MOD166 MOD167 MODINF MODV2 MPL NOABSOLUTE NOAMAKE NOCASE NOCOND NODEBUG NOERRORPRINT NOGEN NOLINES NOLIST NOMACRO NOMOD166 NOMPL NONSEGMENTED NOOBJECT NOPAGING NOPRINT NOSYMBOLS NOSYMLIST NOTYPE NOXREF OBJECT PAGELENGTH PAGEWIDTH PAGING PRINT REGUSE RESET RESTORE SAVE SEGMENTED SET SYMBOLS SYMLIST TABS TITLE TYPE USEDEXTONLY XREF Operands and Expressions Operators Control Statements Macro Processor Error Messages AppendixDirectives
The A166 Assembler provides a number of directives you may use to control source file assembly. Directives are composed of one or more letters or digits and, unless otherwise specified, may be specified after the filename on the command line or within the source file when preceded by a dollar sign ('$'). For example:
A166 SAMPLE.A66 SYMBOLS DEBUG
or
$SYMBOLS DEBUG
or
$SYMBOLS $DEBUG
The source file to assemble is SAMPLE.A66 and SYMBOLS and DEBUG are the directives.
Assembler directives may be divided into two groups:
- Primary directives are specified on the assembler command line or in first few lines of the assembly source file. These directives control how the assembler behaves for the entire module. If conflicting primary directives are specified on the command line and in the source file, the command line directive takes precedence.
- General directives may be specified on the command line or anywhere in the source file. These directives control the immediate behaviour of the assembler and may be changed during assembly.
Note
- Syntax is the same for directives specified on the command line and those specified in the source file.
- Some directives may not be specified on the command line. If one of these directives is specified on the command line, the assembler generates a fatal error and aborts.
The following table is an alphabetical list of the control directives available in the A166 Assembler.
| Directive | Group | Description |
|---|---|---|
| ABSOLUTE | Primary | Enables absolute object module verification. |
| CASE | Primary | Enables case-sensitive symbol names. |
| COND | General | Includes (in the listing file) conditional source lines skipped by the preprocessor. |
| DATE | Primary | Specifies the date to use in the listing file header. |
| DEBUG | Primary | Includes debugging information in the object file. |
| EJECT1 | General | Inserts a form feed character into the listing file. |
| ERRORPRINT | Primary | Specifies the file name for error messages. |
| EXPDECNUM | Primary | Sets the output format to decimal (for the %eval macro function). |
| EXTMAC | Primary | Enables use of the ST10 MAC instruction set. |
| GEN | General | Includes all macro expansions in the listing file. |
| GENONLY | General | Includes first level macro expansions in the listing file. |
| INCDIR | Primary | Sets additional include file paths. |
| INCLUDE2 | General | Includes the contents of another file. |
| LIST | General | Includes the assembly source text in the listing file. |
| MACRO | Primary | Enables preprocessor expansion of standard macros. |
| MOD166 | Primary | Pre-defines 80C166 system names. |
| MOD167 | Primary | Enables use of the enhanced C167 instruction set. |
| MODV2 | Primary | Enables use of the extended Super-10/XC16X instruction set. |
| MPL | Primary | Enables preprocessor expansion of MPL macros. |
| NOABSOLUTE | Primary | Disables absolute object module verification. |
| NOAMAKE | Primary | Excludes build information from the object file. |
| NOCASE | Primary | Disables case-sensitive symbol names. All symbols are converted to uppercase. |
| NOCOND | Primary | Excludes (from the listing file) conditional source lines skipped by the preprocessor. |
| NODEBUG | Primary | Excludes debugging information from the object file. |
| NOERRORPRINT | Primary | Disables error messages output to the screen. |
| NOGEN | General | Excludes macro expansions from the listing file. |
| NOLINES | Primary | Excludes line number information from the generated object module. |
| NOLIST | General | Excludes the assembly source text from the listing file. |
| NOMACRO | Primary | Disables preprocessor expansion of standard and MPL macros. |
| NOMOD166 | Primary | Suppresses the definition of 80C166 system names. |
| NOMPL | Primary | Disables preprocessor expansion of MPL macros. |
| NONSEGMENTED | Primary | Assembles files for the non-segmented CPU mode. |
| NOOBJECT | Primary | Disables object file generation. |
| NOPAGING | Primary | Excludes form feeds and page headers from the listing file. |
| NOPRINT | Primary | Disables listing file generation. |
| NOSYMBOLS | Primary | Excludes the symbol table from the listing file. |
| NOSYMLIST | General | Excludes subsequently defined symbols from the symbol table. |
| NOTYPE | Primary | Excludes symbol type information from the object file. |
| NOXREF | Primary | Excludes the cross-reference table from the listing file. |
| OBJECT | Primary | Specifies the name for the object file. |
| PAGELENGTH | Primary | Specifies the number of lines on a page in the listing file. |
| PAGEWIDTH | Primary | Specifies the number of characters on a line in the listing file. |
| PAGING | Primary | Includes form feeds and page headers in the listing file. |
| Primary | Specifies the name for the listing file. | |
| REGUSE | General | Specifies registers modified by the specified function. |
| RESTORE1 | General | Restores settings for the LIST and GEN directives. |
| SAVE1 | General | Saves settings for the LIST and GEN directives. |
| SEGMENTED | Primary | Assembles files for the segmented CPU mode. |
| SYMBOLS | Primary | Includes the symbol table in the listing file. |
| SYMLIST | General | Includes subsequently defined symbols in the symbol table. |
| TABS | Primary | Specifies the number of blanks required for tab characters in the listing file. |
| TITLE | Primary | Specifies the page header title in the listing file. |
| TYPE | Primary | Includes symbol type information in the object file. |
| USEDEXTONLY | Primary | Excludes unused external definitions from the object file. |
| XREF | Primary | Includes the cross-reference table in the listing file. |
Note
- These directives may not be specified on the command line. They may only be specified in the source file.
- Primary directives may not be specified after an INCLUDE directive.
| Contact Site Map Press Privacy | Copyright © 2012 ARM Ltd and ARM Germany GmbH. All rights reserved. |
