SHOWMACROS | NOSHOWMACROS
Category
Compiler output
Pragma equivalent
None.
Purpose
Displays macro definitions to preprocessed output.
Displaying macros to preprocessed output can help to determine the available functionality in the compiler. The macro listing may prove useful in debugging complex macro expansions.
Syntax
Defaults
NOSHOWMACROS
The SHOWMACROS option replaces the preprocessed output with the macro define directives.
Parameters
- ALL
- Emits all macro definitions to preprocessed output. This is the same as specifying SHOWMACROS.
- PRE
- Emits only predefined macro definitions to preprocessed output. This suboption has no impact on user macros.
- NOPRE
- Suppresses appending predefined macro definitions to preprocessed output.
Usage
Specifying SHOWMACROS with no suboptions is equivalent to SHOWMACROS(ALL).
Specify SHOWMACROS(ALL,NOPRE) to emit only the user defined macros.
Note the following information
when using this option:
- This option has no effect unless preprocessed output is generated; for example, using the -qpponly option in the xlc utility, or using the PPONLY option through JCL and TSO.
- If a macro is defined and subsequently undefined before compilation ends, this macro will not be included in the preprocessed output.
- Only macros defined internally by the preprocessor are considered predefined; all other macros are considered as user-defined.
Predefined macros
None.