View source for MACRO

'''MACRO''' is a [[DCL]] [[command]] that invokes the [[MACRO Compiler|MACRO compiler]].

You have two major syntax options, '''MACRO/MIGRATION''' and '''MACRO/ALPHA'''. MACRO/MIGRATION invokes the MACRO-32 compiler, MACRO/ALPHA invokes the MACRO-64 compiler.

=Qualifiers=
* /DEBUG=option includes or excludes local symbols in the symbol table or traceback information in the object module. Options include:
** ALL: makes local symbols and traceback information in the object module available to the debugger (equivalent to /ENABLE=(DEBUG,TRACEBACK))
** NONE: Makes local symbols and traceback information in the object module unavailable to the debugger (equivalent to /DISABLE=(DEBUG,TRACEBACK))
** SYMBOLS: makes all local symbols in the object module available and all traceback information unavailable to the debugger. This qualifier is equivalent to /ENABLE=SYMBOLS.
** TRACEBACK: makes traceback information in the object module available and local symbols unavailable to the debugger. This qualifier is equivalent to /ENABLE=TRACEBACK.
* /FLAG=option specifies which classes of informational messages the compiler reports. The options include:
**ALIGNMENT reports unaligned stack and memory references.
** ALL enables all options.
** ARGLIST reports that the argument list has been homed. (See Section 2.4.1.)
** BAD_FIELD_USAGE reports BBC/BBS instructions that attempt to use bits beyond 31.
** CODEGEN reports run-time code generation, such as self-modifying code. (See Section 3.2.2.)
** COMPILER_VERSION (OpenVMS I64 only) prints compiler version to SYS$ERROR.
** DIRECTIVES reports unsupported directives.
** HINTS reports input/output/auto-preserved register hints.
** INDIRECT_CALLS reports CALLS/CALLG instructions that have an indirect target and are not preceded by a .USE_LINKAGE directive.
** INDIRECT_JSB reports JSB instructions that have an indirect target and are not preceded by a .USE_LINKAGE directive.
** INSTRUCTIONS reports instructions that use absolute addresses that might compile correctly, but should be examined anyway, because the desired absolute address might be different on the system.
** JUMPS reports branches between routines.
** LINKAGE reports linkage information provided to the OpenVMS linker.
** NONE disables all options.
** STACK reports all messages caused by user stack manipulation.
* /DIAGNOSTICS=filespec creates a file containing assembler messages and diagnostic information.
* /MACHINE
* /ENABLE= option and /DISABLE=option provide initial settings for the compiler functions that can be controlled by the .DISABLE and .ENABLE macro directives. The options include:
** DEBUG excludes local symbol table information in the object file for use with the debugger. If the /DEBUG qualifier is also specified, it overrides /DISABLE=(DEBUG,TRACEBACK) or /ENABLE=(DEBUG,TRACEBACK), regardless of their order on the command line.
** FLAGGING deactivates compiler flagging.
** GLOBAL disables the assumption that undefined symbols are external symbols.
** OVERFLOW deactivates production of overflow trap code for the following opcodes: ADDx, ADWC, INCx, ADAWI, SUBx, SBWC, DECx, MNEGx, MULx, CVTxy,(where x is greater than y, for example CVTLB), AOBxx, ACBL, and SOBxx.
** QUADWORD disables support for quadword literal and address expressions.
** SUPPRESSION prevents the listing of unreferenced symbols in the symbol table.
** TRACEBACK disables the provision of traceback information to the debugger. If the /DEBUG qualifier is also specified, it overrides /DISABLE=(DEBUG,TRACEBACK) or /ENABLE=(DEBUG,TRACEBACK), regardless of their order on the command line.

By default, at compiler activation, FLAGGING, GLOBAL, TRACEBACK, and SUPPRESSION are enabled, and DEBUG, OVERFLOW, and QUADWORD are disabled.

* /OPTIMIZE

* /PRESERVE
* /LIBRARY
* /RETRY_COUNT
* /LIST
* /SYMBOLS
* /OBJECT
* /TIE
* /SHOW
* /UNALIGNED
* /WARN