Cisco WS-C6506 - Page 1430

55-48
Catalyst 6500 Series Switch Software Configuration Guide—Release 8.7
OL-8978-04
Chapter 55 Configuring a VoIP Network
Using SmartPorts
• Clearing (deleting) a macro—You can clear a macro when it is no longer needed. When you clear a
macro, only the macro and its definition are cleared from the system; the configuration on the ports
that the macro was applied to is not cleared. To clear a macro, enter the clear macro name
command.
• Types of macros—The two types of macros are the global macros and the port-based macros.
Using the CLI to Configure User-Definable SmartPorts Macros
These sections describe how to use the CLI to configure user-definable SmartPorts macros:
• Creating User-Defined Macros, page 55-48
• Modifying Existing User-Defined Macros, page 55-49
• Defining Variables, page 55-49
• Using Special Variables, page 55-50
• Applying a User-Defined Macro, page 55-50
• Displaying Macros, page 55-52
• Displaying Macro Variables, page 55-52
• Clearing Macros and Macro Variables, page 55-53
• Displaying Macro Port Mappings, page 55-54
• Displaying the User-Definable SmartPorts Macro Configuration, page 55-55
• Configuring a Macro within a Macro, page 55-55
Creating User-Defined Macros
To create (define) a macro, use the set macro name name command to enter a list of commands (one
command per line). To end the macro and exit from the macro mode, type the @ break character and
then press Enter. An example is as follows:
Console> (enable) set macro name videophone
Enter macro commands one per line. End with character ‘@’.
set port enable #MODPORT
set vlan $DATAVLAN #MODPORT
set port auxiliaryvlan #MODPORT $AUXVLAN
set qos autoqos
@
Console> (enable)
Follow these guidelines and restrictions when creating user-defined macros:
• The maximum length of a macro name is 16 characters. The maximum number of command lines in
a macro is 64. A macro cannot have the same name as a static macro (such as ciscoswitch or
ciscorouter).
• You can have a macro inside a macro in user-defined and static macros.
• Syntax checking is not done when you create or modify a macro. If you enter incorrect commands
when creating the macro, the incorrect commands fail when the macro is applied to a port.
• In the above example, #MODPORT is a variable that specifies the port to which the macro is
applied. If the macro is applied on port 3/2, then #MODPORT is replaced by 3/2 when the macro is
applied to a port.