This document is the VAX-11 MACRO User's Guide (Order No. AA-D033B-TE), published February 1979. It serves as a comprehensive resource for assembly language programmers to efficiently use the capabilities of the VAX-11 MACRO assembly language.
Specifically documenting VAX-11 MACRO Version 2.0, the guide details technical changes from Version 1.0, including:
- New qualifiers (
/CROSS, /NOCROSS, /ENABLE, /DISABLE) for controlling cross-reference listings and symbol table suppression.
- Revised order for specifying macro library files in the MACRO command.
- Updated formats for listing files and diagnostic messages.
- The assembler's internal transition to native mode operation.
The guide provides information on:
- Developing VAX-11 MACRO Programs: Introduction to assembly language programming, the function of the VAX-11 MACRO assembler, user-defined symbols, macros, program sections, linking MACRO programs, and debugging.
- Using the MACRO Command: Detailed explanation of file specifications, command and file qualifiers (e.g., for listing, object output, showing specific information), and diagnostic messages.
- Writing Position-Independent Code: A dedicated section for experienced programmers on how to create code that can be linked anywhere in virtual memory, essential for shareable images.
- Diagnostic Messages: An appendix listing and explaining all VAX-11 MACRO error and warning messages.