System Debug Reference Manual (32650-90888)

Chapter 6 225
System Debug Command Specifications M-X
MACTRACE
Limitations, Restrictions
The macro reference count is incremental at macro entry, after parameter type checking,
but before actual execution of the macro body. The actual macro execution may result in
errors and be terminated. Reference counts, therefore, indicate the number of times the
macro has been called (not the number of times that the macro has been successfully
executed to completion).
MACTRACE
Controls the "tracing" of macro execution.
Syntax
MACTRACE pattern [ level ]
It is possible to enable/disable the observation of entry/exit of macros, along with input
parameter values and functional return values.
Parameters
pattern The name(s) of the macro(s) that are to be traced.
This parameter can be specified with wildcards or with a full regular
expression. Refer to appendix A for additional information about pattern
matching and regular expressions.
The following wildcards are supported:
@ Matches any character(s).
? Matches any alphabetic character.
# Matches any numeric character.
The following are valid name pattern specifications:
@ Matches everything; all names.
pib@ Matches all names that start with "pib".
log2##4 Matches "log2004", "log2754", and so on.
The following regular expressions are equivalent to the patterns with
wildcards that are listed above:
`.*`
`pib.*`
`log2[0-9][0-9]4`
level The level of macro "tracing" detail.
Four increasing levels are supported: