route-map

Configures a route-map instance that dictates the packet forwarding behavior based on the match and set actions for ingress ACLs.

Syntax

route-map name sequence_number

no route-map { name sequence_number } | all

Parameters

name: Specifies the name of the route-map to be used for packet forwarding as part of this ingress group. Range is 1-64.; The name identifier must start with an alphabetic character or an underscore followed by an arbitrary sequence of alphabetic or numeric characters, underscores, hyphens, or dots.
sequence_number: Assigns sequence number to the route-map instance. This defines the order of route-map instances within a route-map. Range is 1-65535.
all: Specifies all route-maps when using the no form of this command.

Modes

Config mode

Usage Guidelines

Two route-map instances cannot have the same sequence-number.

Any attempts to remove an unconfigured route-map are ignored.

The no route-map name command deletes a route-map and no route-map [name] [sequence-number] command deletes the route-map with the specified sequence number.

Table 1. Error messages
Message	Reason
`Error: route-map name identifier must be an arbitrary sequence of alphabets, numerals, underscores, hyphens or dots`	Name begins with non-alphabetic character, contains invalid characters, or does not begin with an underscore.
`Error: route-map name identifier must start with an alphabetic character or an underscore`	Name begins with non-alphabetic character or does not begin with an underscore.
`Error: route-map name identifier cannot exceed 64 characters`	Name is longer than 64 characters.
`Error: route-map name identifier must not be reserved keyword`	Name includes the reserved word indicated.

The following examples show how to configure a route-map named rmap1 with the sequence number 10.

device# configure terminal
device(config)# route-map rmap1 10
device(config-route-map)# match mac access-list mac_acl1 
device(config-route-map)# match ip access-list ipv4_acl1 
device(config-route-map)# match ipv6 access-list ipv6_acl1
device(config-route-map)# set egress-group eg200 
 
device# show route-map all 
route-map rm1 1 
forward-action permit 
match ip access-list acl4 (active) 
match mac access-list acl2 (pending) 
egress-group eg1 
Policy matches: 0 packets, 0 bytes, 0 Packet/sed, 0 Bits/sec

The following examples delete a route map and a route map with a sequence number.

device# configure terminal
device(config)# no route-map rm1

device(config)# no route-map rmap1 10

The following examples show error messages for the route-map command.

device# configure terminal
device(config)# route-map ab#c1 100 
Error: keypath:/routemaps/routemap[name=ab#c1]/name contains one or more unsupported character ('@', '$', '#', '[', ']') for key:name 

device(config)# route-map ^abc1 100  
Error: route-map name identifier must be an arbitrary sequence of alphabets, numerals, underscores, hyphens or dots. 

device(config)# route-map abcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabcabc 100
Error: route-map name identifier cannot exceed 64 characters  

device(config-listener-policy)# route-map egress 10  
Error:  route-map name identifier must not be reserved keyword "egress" 

device(config)# route-map a]dff 20 
Error: invalid keypath:/name error:path /name, contains invalid token name 

device(config)# route-map a^abc1 100 
Error: route-map name identifier must be an arbitrary sequence of alphabets, numerals, underscores, hyphens or dots.