Accessing the macros

Edit online
To use these macros:
  • Ensure the macro library provided as part of the Toolkit Feature is included; for z/OS®, in the SYSLIB concatenation; for CMS, in the GLOBAL MACLIB command; or for z/VSE®, in the LIBDEF SOURCE search chain.

    For z/OS, the default SMP/E target library is hlq.SASMMAC2.

    For z/VSE, the default sublibrary is PRD2.PROD.

    For CMS, the default location is userid P696234H disk 29E macro library ASMSMAC MACLIB.

  • Add the following statement to the program: 
    COPY  ASMMSP

    Add this statement prior to any line containing a macro. You can add this statement either directly by updating the actual file or by using the PROFILE facility of HLASM. This COPY statement must be inserted before any use is made of these macros.

    All the ‘visible’ macro names are set up by SETC statements in member ASMMNAME, which is copied and used by ASMMSP. If there is a collision, or you like to use different names for any of the macros, change the statements in ASMMNAME.

The following restrictions apply when using these macros:
  • The macros generate labels of the following format: 
    #@LBn DC 0H
    where n is a sequence number starting at 1.

    Do not use these names for any labels within the user's program.

  • Many macros accept a numeric or mnemonic value representing a condition code mask, either as a positional operand or as the CC= keyword operand. The values supplied for numeric operands are not condition code settings (0, 1, 2, or 3) but are the condition code mask values used in conditional branch instructions (values 1 to 14).
  • The macros use a set of global macro variables for processing. The definitions for these variables are in ASMMGBLV (this is a member in the supplied library). These macro variable names must not be used in any other macros.
  • The following words are reserved keywords and must not be used for operands or instructions: AND, OR, ANDIF, ORIF.
  • It is strongly suggested that you do not use the mnemonic keywords in Table 1 as labels or operands.