# Create Route Map elements

Use Route Map elements in more complex networks to control or manipulate routes. You can use Access List elements as a Matching Condition in a Route Map rule.

##

For more details about the product and how to configure features, click Help or press F1.

## Steps

1. Select Engine.
2. Browse to Other Elements > Dynamic Routing Elements.
3. Right-click Route Maps, then select New Route Map.
4. Enter a name for the Route Map, then click OK.
5. To add a rule, right-click the Route Map, then select Add Rule.
6. (Optional) To add a Rule Section, right-click the Route Map, then select Add Rule Section Before or Add Rule Section After.
   You can use Rule Sections to group similar rules. Double-click the Rule Section to give it a name. Because you can jump to a Rule Section in the Goto action, use a unique name.
7. To add a Matching Condition for a rule, double-click the Matching Condition cell. Configure the rules, then click OK.
8. To select the action for the rule, right-click the Action cell, then select Permit or Deny.
9. To change the Route Entry Settings, double-click the Route Entry Settings cell, configure the settings, then click OK.
10. (Optional) To jump to a Route Map, double-click the Call cell, then select a Route Map.
11. To select how the rules processing continues, double-click the Goto cell.
    - Finish — Further rules are not processed. This is the default action.
    - Goto Next Rule — The next rule is processed.
    - Goto Rule Section — If you have created rule sections, you can jump to a rule section.

## Route Map Properties dialog box

Use this dialog box to create your Route Map.

Option | Definition
--- | ---
Name | The name of the element.
Category (Optional) | Includes the element in predefined categories. Click Select to select a category.
Comment (Optional) | A comment for your own reference.

## Route Map Policy Editing view

Use this view to add rules to your Route Map.

Option | Definition
--- | ---
Resources pane. You can drag and drop elements from this pane.
Filter | Allows you to filter the elements shown.
Up | Navigates up one level in the navigation hierarchy. Not available at the top level of the navigation hierarchy.
New | Allows you to create a new element.
More actions | A menu that contains various options, such as for creating new elements or showing elements that have been moved to the Trash.
More actions > Show Deleted Elements | When selected, elements that have been moved to the Trash are visible.

Option | Definition
--- | ---
Policy Toolbar
Preview and Edit | Changes between the preview (read-only) and editing views.
Save | Saves the changes.
Undo operation | Undoes the last change made.
Redo operation | Redoes the last change that was undone.
More actions menu |
Validate | Validates the rules in the policy. Opens the Validate Policy dialog box in which you can select which issues are checked in the rules.
Save As | Saves a copy of the policy as a new element.
Expand All | If you have added Rule Sections or Sub-Policies, they are all expanded.
Collapse All | If you have added Rule Sections or Sub-Policies, and they are expanded, they are all collapsed.
Text Size | Changes the text size.
Target Engine Selector | Selects the target Engine for the Validate, Network Details, and Rule Counters actions.

Option | Definition
--- | ---
Rules table
Matching Condition | Double-click the cell to open the Matching Conditions dialog box.
Action | Right-click the cell to select the action when the conditions match: Permit — Uses the `permit` action. The route is allowed. Deny — Uses the `deny` action. The route is not allowed.
Route Entry Settings | Double-click the cell to open the Route Entry Settings dialog box.
Call | Double-click the cell to open the Call dialog box.
Goto | Double-click the cell to open the Goto dialog box.
Comment (Optional) | A comment for your own reference. You can also add separate comment rows in between rules.
Rule Name | Contains a rule tag and optionally a rule name. Name (Optional) — Name or description for the rule. Displayed alongside the rule tag. Tag (Not editable) — Automatically assigned unique identification for the rule. Works as a link between the log entries and the rule that has generated the log entries. The rule tag consists of two parts (for example, @20.1). The first part of the tag is permanent and belongs to only that rule. The second part changes when the rule is changed. The first part and the second part are separated by a period.
Info pane | Use this pane to view more information about the selected element. The available tabs depend on the type of element selected.

## Route Map Matching Conditions dialog box

Use this dialog box to define the conditions to match in a rule in a Route Map.

Option | Definition
--- | ---
Resources pane. You can drag and drop elements from this pane.
Filter | Allows you to filter the elements shown.
Up | Navigates up one level in the navigation hierarchy. Not available at the top level of the navigation hierarchy.
More actions | A menu that contains various options, such as for creating new elements or showing elements that have been moved to the Trash.
More actions > New | Allows you to create a new element.
More actions > Show Deleted Elements | When selected, elements that have been moved to the Trash are visible.
Matching Conditions table Click Add Row to add a row to the table, or Remove Row to remove the selected row. Click Up or Down to move the selected item up or down.
Type | Select an Access List or Metric, Next Hop, or Peer Address.
Value | If you selected an Access List or Next Hop as the Type, drag the Access List from the Resource pane to this cell. If you selected Peer Address, drag a Engine or External BGP Peer to this cell. If you select Metric, double-click the cell to enter the number.

## Route Map Route Entry Settings dialog box

Use this dialog box to define Route Entry Settings in a Route Map.

For information about FRR syntax, see https://⁠docs.frrouting.org/en/latest/.

Option | Definition
--- | ---
Set IPv4 Next Hop | The value for the `set ip next-hop` command. Click Select to add routers or hosts.
Set IPv6 Global Next Hop | The value for the `set ipv6 next-hop global` command. Click Select to add routers or hosts.
Set IPv6 Local Next Hop | The value for the `set ipv6 next-hop local` command. Click Select to add routers or hosts.
Set Local Preference | The value for the `set local-preference` command.
Set Weight | The value for the `set weight` command.
Set Metric | The value for the `set metric` command.
AS Path | If you select Prepend or Exclude, click Add to define the AS number to exclude or prepend. To remove the AS number, click Remove.
Community | If you select Set to or Additive, click Add to select the community or to enter the community number. To remove the community, click Remove. If you select Delete Communities, click Select, then select the Community Access List that defines the communities to delete.
Extended Community | If you select Set to, select either: Route Target (RT) — Uses the `route-target` attribute. Site of Origin (SOO) — Uses the `soo` attribute. Click Add to select the extended community or to enter the extended community number.

## Route Map Route Entry Settings Add AS Number dialog box

Use this dialog box to define the AS number to prepend or exclude from the AS path.

Option | Definition
--- | ---
Enter AS Number | Enter the AS number that you want to prepend or exclude from the AS path.

## Route Map Add Community Number dialog box

Use this dialog box to select the community or to enter the community number.

Option | Definition
--- | ---
internet | Uses the `internet` community.
no-export | Uses the `no-export` community.
no-advertise | Uses the `no-advertise` community.
local-AS | Uses the `local-AS` community.
Community Number | Enter the community number.

## Route Map Add Extended Community Number dialog box

Use this dialog box to enter the extended community number.

Option | Definition
--- | ---
Extended Community Number | Enter the extended community number.

## Route Map Call dialog box

Use this dialog box to call another Route Map.

Option | Definition
--- | ---
Call Route Map | Select the Route Map to call. Note: Make sure that you do not unintentionally create a loop by calling the same Route Map you are editing.

## Route Map Goto Properties dialog box

Use this dialog box to set what actions to take after processing the rule.

Option | Definition
--- | ---
Finish | No more rules are processed.
Goto Next Rule | The next rule in the Route Map is processed.
Goto Rule Section | If you have created Rule Sections in your Route Map, you can set the Route Map to jump to a particular section.