Cisco Systems ME3400G2CSA Configuring Command Macros

10-2

Cisco ME 3400 EthernetAccess Switch SoftwareConfiguration Guide

78-17058-01

Chapter10 Configuring Command Macros

Configuring Command Macros

Configuring Command Macros

You can create a new command macro or use an existing macro as a template to create a new macro that

is specific to your application. After you create the macro, you can apply it globally to a switch, t o a

switch interface, or to a range of interfaces.

These sections contain this configuration information:

•Default Command Macro Configuration, page 10-2

•Command Macro Configuration Guidelines, page 10-2

•Creating Command Macros, page 10-3

•Applying Command Macros, page 10-4

•Displaying Command Macros, page 10-5

There are no command macros enabled.

Follow these guidelines when configuring macros on your switch:

•When creating a macro, do not use the exit or end commands or change the command mode by usin g

interface interface-id. This could cause commands that follow exit, end, or interface interface-id

to execute in a different command mode.

•When creating a macro, all CLI commands should be in the same configuration mode.

•When creating a macro that requires the assignment of unique values, use the parameter value

keywords to designate values specific to the interface. Keyword matching is case sensitive. All

matching occurrences of the keyword are replaced with the correspon ding 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.

•Macro names are case sensitive. For example, the commands macro name Sample-Macro and

macro name sample-macro will result in two separate macros.

•Some macros might contain keywords that require a parameter value. You can use the macro global

apply macro-name ? global configuration command or the macro apply macro-name ? interface

configuration command to display a list of any required value s in t he m a cr o. If yo u ap ply a macr o

without entering the keyword values, the commands are invalid and are not applied.

•When a macro is applied globally to a switch or to a switch interface, all existing configuration on

the interface is retained. This is helpful when applying an incremental configuration.

•If you modify a macro definition by adding or deleting commands, the change s are not reflected on

the interface where the original macro was applied. You need to reapply the updat e d mac r o o n th e

interface to apply the new or changed commands.

•You can 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. If a command fails because of a syntax error or a configuration error, the macro

continues to apply the remaining commands.