Macro Global - Cisco Catalyst 2950 Command Reference Manual

Chapter 2 Catalyst 2950 and 2955 Cisco IOS Commands

macro global

Use the macro global global configuration command to apply a macro to a switch or to apply and trace
a macro configuration on a switch.
Syntax Description apply
trace
macro-name
parameter value (Optional) Specify unique parameter values that are specific to the switch. You can
Defaults
This command has no default setting.
Command Modes
Global configuration
Command History Release
12.1(20)EA2
Usage Guidelines
You can use the macro trace macro-name global configuration command to apply and to show the
macros running on a switch or to debug the macro to find any syntax or configuration errors.
If a command fails because of a syntax error or a configuration error when you apply a macro, the macro
continues to apply the remaining commands to the switch.
When creating a macro that requires the assignment of unique values, use the parameter value keywords
to designate values specific to the switch.
Keyword matching is case sensitive. All matching occurrences of the keyword are replaced with the
corresponding value. Any full match of a keyword, even if it is part of a larger string, is considered a
match and is replaced by the corresponding value.
Some macros might contain keywords that require a parameter value. You can use the macro global
apply macro-name ? command to display a list of any required values in the macro. If you apply a macro
without entering the keyword values, the commands are invalid and are not applied.
There are Cisco-default Smartports macros embedded in the switch software. You can display these
macros and the commands they contain by using the show parser macro user EXEC command.
Follow these guidelines when you apply a Cisco-default Smartports macro on a switch:
•
OL-10102-01
macro global {apply | trace} macro-name [parameter {value}] [parameter {value}]
[parameter {value}]
Apply a macro to the switch.
Use the trace keyword to apply a macro to a switch and to debug the macro.
Specify the name of the macro.
enter up to three keyword-value pairs. Parameter keyword matching is case
sensitive. All matching occurrences of the keyword are replaced with the
corresponding value.
Modification
This command was introduced.
Display all macros on the switch by using the show parser macro user EXEC command. Display
the contents of a specific macro by using the show parser macro name macro-name user EXEC
command.
Catalyst 2950 and Catalyst 2955 Switch Command Reference
macro global
2-201