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

Read syntax diagramSkip visual syntax diagram NOSHOWMSHOWM(,ALLNOPREPRE)

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.