System Debug Reference Manual (32650-90888)

222 Chapter6
System Debug Command Specifications M-X
MACREF
• Command %11 sets the environment variable term_loud to FALSE. This prevents
subsequent System Debug output from being displayed on the terminal. We capture the
output in the list file (macros), but we do not want to watch all of the output on the
terminal.
• Command %12 contains the MACLIST command. All attributes of all currently defined
macros are displayed. The PAGE option causes each macro to start on a new page. The
list file contains CCTL (carriage control) information for the paging.
• Command %13 closes (and saves) the current list file (macros).
• Command %14 uses the SET DEFAULT command to effectively reset the environment
variable term_loud back to TRUE. System Debug output is once again displayed on
the terminal.
Limitations, Restrictions
Macros listed into a file are not currently formatted in a style that allows the macro to be
redefined by reading the file back in as a USE file.
The macro pretty printer attempts to format the macro body in a reasonable manner.
Occasionally, the formatting includes extra blank lines, usually as a result of unnecessary
semicolons within the original macro body.
When macros are defined, all comments are removed, and the macro body is stored in
compressed form. The MACLIST command does not display the original form of the macro
body.
MACREF
Resets the reference count to zero for the specified macro(s).
Syntax
MACREF pattern
Reference counts are maintained for macros. Each time a macro is invoked, the reference
count for the macro is incremented.
Current reference counts can be displayed with the MACLIST command.
This MACREF command is used to reset macro reference counts.
Parameters
pattern The name(s) of the macro(s) for which the reference counts are to be reset
to zero.
This parameter can be specified with wildcards or with a full regular
expression. Refer to appendix A for additional information about pattern