HLASM Language Reference

MHELP Instruction
Chapter 10. MHELP Instruction
The MHELP instruction controls a set of trace and dump facilities. MHELP
statements can occur anywhere in open code or in macro definitions. MHELP
options remain in effect until superseded by another MHELP statement.
MHELP Options
Options are selected by an absolute expression in the MHELP operand field.
►►──┬─────────────────┬──MHELP──options────────────────────────────►◄
└─sequence_symbol─┘
sequence_symbol
is a sequence symbol.
options
is the sum of the binary or decimal options described below.
MHELP B'1' or MHELP 1, Macro Call Trace: This option provides a one-line
trace listing for each macro call, giving the name of the called macro, its nested
depth, and its &SYSNDX value. The trace is provided only upon entry into the
macro. No trace is provided if error conditions prevent entry into the macro.
MHELP B'10' or MHELP 2, Macro Branch Trace: This option provides a
one-line trace-listing for each AGO and AIF conditional assembly branch within a
macro. It gives the model statement numbers of the “branched from” and the
“branched to” statements, and the name of the macro in which the branch occurs.
This trace option is suppressed for library macros.
MHELP B'100' or MHELP 4, Macro AIF Dump: This option dumps
undimensioned SET symbol values from the macro dictionary immediately before
each AIF statement that is encountered.
MHELP B'1000' or MHELP 8, Macro Exit Dump: This option dumps
undimensioned SET symbols from the macro dictionary whenever an MEND or
MEXIT statement is encountered.
MHELP B'10000' or MHELP 16, Macro Entry Dump: This option dumps
parameter values from the macro dictionary immediately after a macro call is
processed.
MHELP B'100000' or MHELP 32, Global Suppression: This option suppresses
global SET symbols in two preceding options, MHELP 4 and MHELP 8.
MHELP B'1000000' or MHELP 64, Macro Hex Dump: This option, when used
with the Macro AIF dump, the Macro Exit dump, or the Macro Entry dump, dumps
the parameter and SETC symbol values in EBCDIC and hexadecimal formats.
Only positional and keyword parameters are dumped in hexadecimal; system
parameters are dumped in EBCDIC. The full value of SETC variables or
parameters is dumped in hexadecimal.
© Copyright IBM Corp. 1982, 2004 397