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. Here is a description of these options:

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.

MHELP B'10000000' or MHELP 128, MHELP Suppression:

This option suppresses all currently active MHELP options.

MHELP Control on &SYSNDX:

The maximum value of the &SYSNDX system variable can be controlled by the MHELP instruction. The limit is set by specifying a number in the operand of the MHELP instruction that is not one of the MHELP codes defined above, and is in the following number ranges:

256 to 65535
Most numbers in the range 65792 to 9999999. Refer to MHELP operand mapping for details.

When the &SYSNDX limit is reached, message ASMA013S ACTR counter exceeded is issued, and the assembler in effect ignores all further macro calls.