Assembler Directives

Assembler directives, or pseudo-ops, are used in a similar way to instruction mnemonics. With the exception of PAGESEL and BANKSEL, these directives do not generate instructions. The DB, DW and DDW directives place data bytes into the current psect. The directives are listed in Table 1 and are detailed in the following sections.

Table 1. Assembler Directives
Directive	Purpose
`ALIGN`	Aligns output to the specified boundary.
`ASMOPT`	Controls whether subsequent code is optimized by the assembler.
`BANKSEL`	Generates code to select bank of operand.
`CALLSTACK`	Indicates the call stack depth remaining.
`[NO]COND`	Controls inclusion of conditional code in the listing file.
`CONFIG`	Specifies configuration bits.
`DB`	Defines constant byte(s).
`DW`	Defines constant word(s).
`DS`	Reserves storage.
`DABS`	Defines absolute storage.
`DDW`	Defines double-width constant word(s).
`ELSE`	Alternates conditional assembly.
`ELSIF`	Alternates conditional assembly.
`ENDIF`	Ends conditional assembly.
`END`	Ends assembly.
`ENDM`	Ends macro definition.
`EQU`	Defines symbol value.
`ERROR`	Generates a user-defined error.
`[NO]EXPAND`	Controls expansion of assembler macros in the listing file.
`EXTRN`	Links with global symbols defined in other modules.
`GLOBAL`	Makes symbols accessible to other modules or allow reference to other global symbols defined in other modules.
`IF`	Conditional assembly.
`INCLUDE`	Textually includes the content of the specified file.
`IRP`	Repeats a block of code with a list.
`IRPC`	Repeats a block of code with a character list.
`[NO]LIST`	Defines options for listing file.
`LOCAL`	Defines local tabs.
`MACRO`	Macro definition.
`MESSG`	Generates a user-defined advisory message.
`ORG`	Sets location counter within current psect.
`PAGELEN`	Specifies the length of the listing file page.
`PAGESEL`	Generates set/clear instruction to set PCLATH bits for this page.
`PAGEWIDTH`	Specifies the width of the listing file page.
`PROCESSOR`	Defines the particular chip for which this file is to be assembled.
`PSECT`	Declares or resumes program section.
`RADIX`	Specifies radix for numerical constants.
`REPT`	Repeats a block of code n times.
`SET`	Defines or re-defines symbol value.
`SIGNAT`	Defines function signature.
`SUBTITLE`	Specifies the subtitle of the program for the listing file.
`TITLE`	Specifies the title of the program for the listing file.