5.2.3 Assembler Directives

These directives do not generate data corresponding to themselves but controls generation of machine code for instructions. They do not modify addresses.

 

.EQU

This directive defines a symbol for a 32-bit signed integer value (–2147483648 to 2147483647).

[Format]

<name>Δ.EQUΔ<numeric value>

[Description]

This directive defines a symbol for a 32-bit signed integer value (–2147483648 to 2147483647).

The symbolic debugging function can be used after symbol definition through this directive.

[Examples]

symbol .EQU 1

symbol1 .EQU symbol+symbol

symbol2 .EQU 2

[Remarks]

The value assigned for a symbol should be determined at assembly.

Be sure to insert a space character or a tab between this directive and the operand.

A symbol can be specified as the operand of symbol definition. Note that forward-reference symbol names must not be specified.

An expression can be specified in the operand.

Symbols can be declared as global.

When this directive and the .DEFINE directive declare the same symbol name, the directive to make the declaration first is given priority.

 

.END

This directive declares the end of an assembly-language file.

[Format]

.END

[Description]

This directive declares the end of an assembly-language file.

The source file contents after the line where this directive is written are only output to the source list file; the code corresponding to them is not generated.

[Examples]

.END

[Remarks]

One .END directive should be written in each assembly-language file.

 

.INCLUDE

This directive inserts the contents of the specified include file to the line where this directive is written in the assembly-language file.

[Format]

.INCLUDEΔ<include file name>

[Description]

This directive inserts the contents of the specified include file to the line where this directive is written in the assembly-language file.

The include file contents are processed together with the contents of the assembly-language file as a single assembly-language file.

File inclusion can be nested up to 30 levels.

When an absolute path is specified as an include file name, the include file is searched for in the specified directory.

If a file is not found, an error will be output.

When the specified include file name is not an absolute path, the file is searched for in the following order.

(1) When no directory information is included in the assembly-language file name specified in the command line at assembler startup, the include file is searched for with the name specified in the .INCLUDE directive. When directory information is included in the assembly-language file name, the include file is searched for with the specified directory name added to the file name specified in the .INCLUDE directive.

(2) The directory specified through the -include assembler option is searched.

(3) The directory specified in the INC_RXA environment variable is searched.

[Examples]

.INCLUDE initial.src

.INCLUDE [email protected]

[Remarks]

Be sure to insert a space character or a tab between this directive and the operand.

Be sure to add a file extension to the include file name in the operand.

The ..FILE directive and a string including @ can be specified as the operand.

A space character can be included in a file name, except for at the beginning of a file name.

Do not enclose a file name within double-quotes (").

The assembly-language file containing this directive cannot be specified as the include file.