16-15
Software Configuration Guide—Release 15.0(2)SG
OL-23818-01
Chapter 16 Configuring SmartPort Macros Configuring Static SmartPort Macros
Static SmartPort Configuration Guidelines
When a macro is applied globally to a switch or to a switch interface, all existing configuration on
the interface is retained. it is helpful when applying an incremental configuration.
If a command fails because of a syntax or a configuration error, the macro continues to apply the
remaining commands. Use the macro global trace macro-name global configuration command or
the macro trace macro-name interface configuration command to apply and debug a macro to find
any syntax or configuration errors.
Some CLI commands are specific to certain interface types. If you apply a macro to an interface that
does not accept the configuration, the macro fails the syntax or the configuration check, and the
switch returns an error message.
Applying a macro to an interface range is the same as applying a macro to a single interface. When
you use an interface range, the macro is applied sequentially to each interface within the range. If a
macro command fails on one interface, it is still applied to the remaining interfaces.
When you apply a macro to a switch or a switch interface, the macro name is automatically added
to the switch or interface. You can display the applied commands and macro names by using the
show running-config user EXEC command.
Applying Static SmartPort Macros
To apply a static SmartPort macro, perform these steps, beginning in privileged EXEC mode:
Command Purpose
Step 1 show parser macro Displays the Cisco-default static SmartPort macros embedded in the
switch software.
Step 2 show parser macro name macro-name Displays the specific macro that you want to apply.
Step 3 configure terminal Enters global configuration mode.
Step 4 macro global {apply | trace}
macro-name [parameter {value}]
[parameter {value}] [parameter
{value}]
Applies each individual command defined in the macro to the switch by
entering macro global apply macro-name. Specify macr o global trace
macro-name to apply and to debug a macro to find any syntax or
configuration errors.
Append the macro with the required values by using the parameter
value keywords. Keywords that begin with $ require a unique parameter
value.
Use the macro global apply macro-name ? command to display a list
of any required values for the macro. If you apply a macro without
entering the keyword values, the commands are invalid and are not
applied.
(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. The corresponding value replaces
all matching occurrences of the keyword.
Step 5 interface interface-id (Optional) Enters interface configuration mode, and specify the
interface on which to apply the macro.
Step 6 default interface interface-id (Optional) Clears all configuration from the specified interface.