This section of the listing shows the names of macros and copy code members and the statements
where the macro or copy code member was called. You can use the assembler option MXREF(XREF) or
MXREF(FULL) to generate this section of the listing. Figure 1. Macro and
copy code cross-reference
Shows the value that represents the input source concatenation, as listed in the Macro and Copy
Code Source Summary (refer to Figure 1) and under the subheading
Datasets Allocated for this Assembly in the Diagnostic Cross Reference and Assembler Summary
(refer to Figure 1).
3
Shows either the name of the macro that calls this macro or copy code member, or the words
PRIMARY INPUT indicating the macro or copy code member was called directly from the primary
input source. If you use the COPY instruction to copy a macro definition, then references to the
macro are shown as called by “PRIMARY INPUT”.
4
One of these:
The statement number for macros defined in the primary input file,
A dash (-) indicating the macro or copy code member was retrieved from a library.
5
The statement number that contains the macro call or COPY instruction.
Lookahead
Processing: If a COPY instruction is encountered during lookahead, this
is the number of the statement that causes lookahead processing to commence.
PCONTROL(MCALL) Assembler Option: If you specify the PCONTROL(MCALL) assembler option, and
you copy a macro definition from an inner macro, the number that is shown against the copied member
is one less than the statement number containing the inner macro call instruction. See Effects of LIBMAC and PCONTROL(MCALL) options for examples of assemblies that use different combinations of the LIBMAC and
PCONTROL(MCALL) options.
6
Statement numbers have a suffix of C when the reference is to a member named on a COPY
instruction.
Figure 2 shows the format of the Macro and Copy Code Cross Reference when
you specify the assembler option, LIBMAC.
Figure 2. Macro and copy code cross-reference—with
LIBMAC option
The X flag indicates that the macro was read from a macro library and embedded in the
input source program immediately preceding the invocation of that macro. For example, in Figure 2, you can see that MACSAMP was called by
the PRIMARY INPUT stream from LIBRARY L1, at statement number
345, after being embedded in the input stream at statement number
333. See Effects of LIBMAC and PCONTROL(MCALL) options for examples of assemblies that use
different combinations of the LIBMAC and PCONTROL(MCALL) options.
You can suppress this section of the listing by specifying the
NOMXREF assembler option.