VAX-11 MACRO User’'s Guide

This document, the "VAX-11 MACRO User's Guide" (Order No. AA-D033C-TE, March 1980), is a practical manual for assembly language programmers using the VAX-11 MACRO assembler on VAX/VMS Version V02.

It provides information necessary to assemble VAX-11 MACRO programs and use the assembly language efficiently. The guide covers:

• An overview of the assembly process, including assembling, linking, and debugging VAX-11 MACRO programs.
• Detailed instructions on using the MACRO command, its file specifications, and various qualifiers to control assembly options (e.g., listing, object file creation, cross-referencing).
• The structure and content of the VAX-11 MACRO listing file, explaining its different parts like the table of contents, source statements, hexadecimal code, audit trail, symbol table, and cross-reference listing.
• The essential elements and structural units required for VAX-11 MACRO programs, such as entry and end statements, conditional assembly blocks, macros, and repeat blocks.
• Advanced features for modular programming, including the use of modules, program sections, user-defined symbols, and macros to enhance program readability, maintainability, and error protection.
• Specific guidance on writing code for shareable images, focusing on position-independent code and managing address data.
• A comprehensive appendix listing and explaining VAX-11 MACRO diagnostic (error) messages.