1 /ALIGNMENT=option
The full command-line option is /[NO]ALIGNMENT=option.
Controls the alignment of code and data. Valid options are:
Option Function
CODE Alignment of certain branch target labels.
DATA Natural alignment of data items.
If you omit the qualifier from the command line, the default
options are /NOALIGNMENT=(CODE, DATA). If more than one option
is specified, the options must be enclosed in parentheses and
separated by a comma.
2 /ARCHITECTURE=option
Determines which instructions are legal.
Option Function
GENERIC All instructions are allowed; equivalent to EV4.
HOST Instruction set is that of the host processor.
EV4 Instruction set is that of the EV4 base design processors
(21064, 20164A, 21066, and 21068 chips).
EV5 Instruction set is that of the EV5 processor
(some 21164 chips).
EV56 Instruction set is that of the EV56 processors
(some 21164 chips). Includes BWX extensions.
PCA56 Instruction set is that of the PCA56 processor
(21164PC chips). Includes BWX and MAX extensions.
EV6 Instruction set is that of the EV6 processor
(21264 chips). Includes BWX and MAX extensions and
SQRT instructions.
3 /DEBUG[=(options)]
The full command-line option is /[NO]DEBUG[=(options)].
Specifies DEBUG support. Valid options are:
Option Function
SYMBOL Generates debug symbol information.
TRACEBACKGenerates traceback information.
ALL Generates all previous debug information.
NONE Generates no debug information.
The default qualifier is /NODEBUG. When you specify /DEBUG with
no options, the default option is /DEBUG=ALL.
4 /DEFINE=(symbol_[=[=]value],...)
The full command-line option is /[NO]DEFINE=(symbol [=
[=]value],...).
Performs the same function as direct symbol assignment in your
source program. That is, the /DEFINE qualifier defines a numeric
symbol.
The Digital Command Language (DCL) converts all input to
uppercase unless you enclose it within quotation marks.
Use a single equal sign between the symbol and the value to
define a local symbol. Use two equal signs between the symbol and
the value to define a global symbol. The final value of a global
symbol is output to the object module and is available during
the linking process. A local symbol is only available during the
assembly process.
You cannot define a lexical string symbol with /DEFINE. The value
you specify for a symbol must be an integer literal. You can
specify this value using a binary, octal, decimal, or hexadecimal
radix. The default radix is decimal. If you specify an alternate
radix, you must use MACRO-64 radix syntax, not DCL radix syntax.
If you do not specify a value for the symbol, it defaults to 1.
The simplest form of a /DEFINE definition is as follows:
/DEFINE=TRUE
This definition is equivalent to the following definition:
TRUE=1
You can also specify more than one symbol definition as with the
following command:
/DEFINE=(CHIP==21064,UNROLL=4)
This definition is equivalent to the following definitions:
CHIP==21064
UNROLL=4
When more than one /DEFINE qualifier is present on the MACRO
command line or in a single assembly unit, the assembler uses
only the last one.
The default qualifier is /NODEFINE.
5 /DIAGNOSTIC[=file-spec]
The full command-line option is /[NO]DIAGNOSTIC[=file-spec].
Controls whether diagnostics are created and stored in the
specified optional file. If a file specification is not supplied,
the assembler creates a diagnostic file using the same name
as the source file. For example, if you use a source file
named XXX.M64, the assembler creates a diagnostic file named
XXX.DIA. You can use the diagnostic file with other Digital
layered products including, but not limited to, the DEC Language-
Sensitive Editor (LSE).
The default qualifier is /NODIAGNOSTIC.
6 /ENVIRONMENT=[NO]FLOAT
The full command-line option is /ENVIRONMENT=[NO]FLOAT.
Controls whether the assembler generates floating-point
instructions when optimizing code and performing code-label
alignment.
Currently, the only floating-point instruction generated by
the assembler during optimization and alignment processing
is FNOP, the floating-point no-operation instruction. If you
specify /ENVIRONMENT=NOFLOAT, the assembler does not generate any
floating-point instructions as part of optimization and alignment
processing. Floating-point instructions that you specify in your
source program are unaffected.
7 /LIBRARY
The full command-line option is /LIBRARY[=file-spec].
Searches macro libraries in the following order:
1. The library designated by the /LIBRARY qualifier.
2. The .LIBRARY directives.
3. The MACRO64.MLB library. The assembler searches for the
MACRO64.MLB macro library in the following locations:
MACRO64$LIBRARY, ALPHA$LIBRARY, and finally SYS$LIBRARY.
4. The STARLET.MLB library. The assembler searches for the
STARLET.MLB macro library in the following locations:
MACRO64$LIBRARY, ALPHA$LIBRARY, and finally SYS$LIBRARY.
In addition, you can place the macro library definitions in the
listing file by using the command-line qualifier /SHOW=LIBRARY.
8 /LIST[=file-spec]
The full command-line option is /[NO]LIST[=file-spec].
Controls whether a listing is created and optionally provides
an output file specification for the listing file. Do not use
wildcard characters in this file specification.
If you enter the MACRO/ALPHA command interactively, the
default qualifier is /NOLIST. The assembler sends output to
the current output device rather than to a listing file. If you
execute the MACRO/ALPHA command in a batch job, the default
qualifier is /LIST.
If you do not specify a file specification, the assembler creates
a listing file using the same name as the source file. For
example, if you use a source file named XXX.M64, the assembler
creates a listing file named XXX.LIS.
9 /MACHINE_CODE
The full command-line option is /[NO]MACHINE_CODE.
Produces a binary machine code listing after the source text if a
listing file is requested. The default qualifier is /NOMACHINE_
CODE.
10 /NAMES=case_option
The full command-line option is /NAMES=case_option.
Specifies the alphabetic casing of identifiers in source code
statements. Valid options are:
Option Function
UPPER_ Converts all identifiers to upper alphabetic case.
CASE
LOWER_ Converts all identifiers to lower alphabetic case.
CASE
AS_IS Causes all identifiers to remain in the case used in
source statements.
If you use the /NAMES qualifier in a command line, you must
supply a case_option. If you omit the qualifier from the command
line, the default option is /NAMES=UPPER_CASE.
11 /OBJECT[=file-spec]
The full command-line option is /[NO]OBJECT[=file-spec].
Controls whether an object file is created and optionally
provides a file specification. Do not use wildcard characters
in this file specification.
If you do not specify a file specification, the assembler creates
an object file using the same name as the source file. For
example, if you use a source file named XXX.M64, the assembler
creates an object file named XXX.OBJ.
The default qualifier is /OBJECT.
12 /OPTIMIZE[=(option-list)]
The full command-line option is /[NO]OPTIMIZE[=(option-list)].
Specifies optional assembler optimizations. Valid items in the
option-list are:
Option Function
SCHEDULE Specifies instruction scheduling.
PEEPHOLE Specifies peepholing.
Specifying /OPTIMIZE with no options is the same as specifying
/OPTIMIZE=(PEEPHOLE,SCHEDULE).
The default qualifier is /NOOPTIMIZE.
13 /PREPROCESSOR_ONLY_[=filespec]
\BK_ADDED_27)
The full command-line option is /PREPROCESSOR_ONLY [=filespec]).
Causes the assembler to output a source file that is the result
of the input source file after preprocessing. Suppresses
diagnostic messages and does not produce diagnostic (.ANA) or
object (.OBJ) files.
The default option, /NOPREPROCESSOR_ONLY-MACRO-64, assembles your
source files normally.
If you specify /PREPROCESSOR_ONLY without a file specification
argument, the output file name defaults to the name of the
primary source input file. The output file type defaults to .ASM.
The following MACRO-64 directives are executed by the
preprocessor and screened from the preprocessor output file:
.DISABLE PREPROCESSOR_OUTPUT
.ENABLE PREPROCESSOR_OUTPUT
.IF
.ELSE
.ENDC
.IIF
.IF_FALSE
.IF_TRUE
.IF_TRUE_FALSE
.INCLUDE
.LIBRARY
.IRP
.IRPC
.REPEAT
.ENDR
.MACRO
.ENDM
.MCALL
.MDELETE
.MEXIT
.NARG
.NCHR
Include files are inserted in place of the .INCLUDE directive
into the preprocessor output file.
Macro definitions and repeat block definitions are screened from
the preprocessor output file.
Macro expansion lines and repeat block expansion lines are
inserted in place of the macro invocation line or repeat block,
respectively, into the preprocessor output file.
Lexical string-symbol assignment statements are screened from the
preprocessor output file.
Lines containing lexical operators are replaced with their
equivalents after lexical operator processing.
Lexical line continuations are processed into a single,
uncontinued line.
All other language elements, including directives not previously
listed, label definitions, direct numeric-symbol assignments, and
so forth are passed through unchanged to the preprocessor output
file.
14 /SHOW=(item,...)
The full command-line option is /[NO]SHOW=(item,...).
Modifies the output listing file. This qualifier is meaningful
only when /LIST is specified. Valid items are:
Option Function
BINARY Lists macro expansions that generate binary code.
BINARY is a subset of EXPANSIONS.
CONDITIONALS Shows sections of code conditionally skipped.
EXPANSIONS Shows macro expansions.
INCLUDE Shows all .INCLUDE files.
LIBRARY Shows macro library modules.
The default option is /SHOW=CONDITIONALS.
15 /WARNINGS=(option-list)
The full command-line option is /[NO]WARNINGS=(option-list).
Controls the severity level of messages and diagnostics. Valid
options are:
Option Function
WARNINGS Display/suppress warnings.
INFORMATIONALS Display/suppress informationals.
ALL Display/suppress warnings and informationals.
NONE Display/suppress nothing.
The default options are /WARNINGS=(WARNINGS,INFORMATIONALS). If
more than one option is specified, options must be enclosed in
parentheses separated by a comma.