|
|||
| Products Download Events Support Videos | |||
Technical Support
On-Line Manuals
A251 User's Guide
A251 Introduction
Assembling Programs
Environment Settings
Command Prompt
ERRORLEVEL
Output Files
Listing (LST) File
Object (OBJ) File
Conditional Assembly
Directives
Reference
CASE
COND
DATE
DEBUG
DEFINE
EJECT
ELSE
ELSEIF
ENDIF
ERRORPRINT
FIXDRK
GEN
GENONLY
IF
INCDIR
INCLUDE
INTR2
LIST
MACRO
MODSRC
MPL
NOAMAKE
NOCASE
NOCOND
NODEBUG
NOERRORPRINT
NOGEN
NOLINES
NOLIST
NOMACRO
NOMPL
NOOBJECT
NOPRINT
NOREGISTERBANK
NOSYMBOLS
NOSYMLIST
NOXREF
OBJECT
PAGELENGTH
PAGEWIDTH
PRINT
REGISTERBANK
REGUSE
RESET
RESTORE
SAVE
SET
SYMBOLS
SYMLIST
TITLE
XREF
Writing Assembly Programs
Control Statements
Macro Processor
Error Messages
Appendix
Directives
The A251 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:
A251 SAMPLE.A51 SYMBOLS DEBUG
or
$SYMBOLS DEBUG
or
$SYMBOLS $DEBUG
The source file to assemble is SAMPLE.A51 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 A251 Assembler.
| Directive | Group | Description |
|---|---|---|
| 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. |
| FIXDRK | Primary | Replaces INC DRk instructions with ADD DRk. |
| GEN | General | Includes all macro expansions in the listing file. |
| INCDIR | Primary | Sets additional include file paths. |
| INCLUDE2 | General | Includes the contents of another file. |
| INTR2 | General | Specifies 2-byte interrupt frames. |
| LIST | General | Includes the assembly source text in the listing file. |
| MACRO | Primary | Enables preprocessor expansion of standard macros. |
| MODSRC | Primary | Enables 251 source mode. |
| MPL | Primary | Enables preprocessor expansion of MPL macros. |
| 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. |
| NOMPL | Primary | Disables preprocessor expansion of MPL macros. |
| NOOBJECT | Primary | Disables object file generation. |
| NOPRINT | Primary | Disables listing file generation. |
| NOREGISTERBANK | Primary | Disables memory space reservation for register banks. |
| NOSYMBOLS | Primary | Excludes the symbol table from the listing file. |
| NOSYMLIST | General | Excludes subsequently defined symbols from the symbol table. |
| 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. |
| Primary | Specifies the name for the listing file. | |
| REGISTERBANK | Primary | Reserves memory space for register banks. |
| 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. |
| SYMBOLS | Primary | Includes the symbol table in the listing file. |
| SYMLIST | General | Includes subsequently defined symbols in the symbol table. |
| TITLE | Primary | Specifies the page header title in the listing 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.
ProductsDevelopment Tools |
Hardware & Collateral |
Downloads |
Support |
Contact |
|
 |
|||
