12-4
Cisco ME 3800X and 3600X Switch Software Configuration Guide
OL-23400-01
Chapter 12 Configuring Command Macros
Configuring Command Macros
Applying Command Macros
Beginning in privileged EXEC mode, follow these steps to apply a command macro:
Command
Purpose
Step 1
configure terminal
Enter global configuration mode.
Step 2
macro global {apply | trace}
macro-name [parameter {value}]
[parameter {value}] [parameter
{value}]
Apply each individual command defined in the macro to the switch by
entering macro global apply macro-name. Specify macro global trace
macro-name to apply and debug a macro to find any syntax or
configuration errors.
(Optional) Specify unique parameter values that are specific to the
switch. You can 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.
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.
Step 3
macro global description text
(Optional) Enter a description about the macro that is applied to the
switch.
Step 4
interface interface-id
(Optional) Enter interface configuration mode, and specify the interface
on which to apply the macro.
Step 5
no shutdown
Enable the port, if necessary. By default, UNIs and enhanced network
interfaces (ENIs) are disabled, and network node interfaces (NNIs) are
enabled.
Step 6
default interface interface-id
(Optional) Clear all configuration from the specified interface.
Step 7
macro {apply | trace} macro-name
[parameter {value}] [parameter
{value}] [parameter {value}]
Apply each individual command defined in the macro to the interface by
entering macro apply macro-name. Specify macro trace macro-name
to apply and debug a macro to find any syntax or configuration errors.
(Optional) Specify unique parameter values that are specific to the
interface. You can 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.
Some macros might contain keywords that require a parameter value.
You can use the macro 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.
Step 8
macro description text
(Optional) Enter a description about the macro that is applied to the
interface.
Step 9
end
Return to privileged EXEC mode.
Step 10
show parser macro description
[interface interface-id]
Verify that the macro is applied to the interface.
Step 11
copy running-config startup-config
(Optional) Save your entries in the configuration file.