Rule Sets

A Rule Set is generated from a Rule Template that was defined on the Diameter > Mediation > Rule Templates page, when the Rule Template state is changed from Development to Test or Active. The Diameter > Mediation > Rule Sets GUI folder contains an entry for each generated Rule Set. If no Rule Sets have been generated, the Rule Sets folder contains no entries. All rules in a Rule Set are specific to the Rule Template from which the Rule Set was generated. The Rule Set View screen provides up to 6 levels deep AVPs.

Clicking a Rule Sets entry opens the Diameter > Mediation > Rule Sets > {name} GUI page for the Rule Set ({name} is the name of the Rule Set).

The condition set expression and actions are displayed above the Rule Set in a form of an IF (Condition set expression) and THEN (Actions).

The Diameter > Mediation > Rule Sets > {name} page displays the following columns:

Rule Id
A Rule Id column appears at the left of the rules list that is a unique number from the database table that identifies each rule in the Rule Template.

Move the rule

A Move the rule column appears at the left of Rules ID and at the right of the rules list when there are rules that are allowed to be moved up or down in the list to change the order of rule execution.

Up and buttons in the Move the rule columns can be used to move a rule up one Down position in the list or down one position in the list each time the button is clicked.

Up and Down buttons appear in the Move the rule columns for a rule or rule group when the order of the rules is allowed to be changed, with the following restrictions:

When the Filter function or clicking a Condition column heading is used to sort the columns, the Move the rule columns are not displayed. The Restore Order button can be clicked to return the list to its original order.
If all of the conditions in the rule support Fast Search, then the Move the rule columns are not displayed. See Fast Search.

If there is at least one condition that does not support Fast Search, then the Up and Down buttons are displayed according to the following rules:

All of the rules that support Fast Search always appear in the list before any rules that do not support Fast Search.

The rows that have exactly the same data in the conditions that support Fast Search form a group. Rows can be moved only within their group; the Up and Down buttons are enabled and disabled accordingly.

Table 1 shows an example of default ordering of rules.

Example of Default Ordering of Rules in a Rule Set
Fast-search condition 1	Fast-search condition 2	Non fast-search condition 3
abc	1	-
abc	12	-
abc	-	-
abcd	1	-
abcd	1	a1
abcd	-	b1
-	1	a1
-	1	b1
-	-	-

Each row across the columns is inserted (created) in the list when a rule is provisioned. The rules on a Diameter > Mediation > Rule Sets > {name} page are looked up in the database in the order in which they are listed on the page. By default, the rules are sorted in the list by condition in the following order:

First the conditions, in alphabetical order from left to right, that have the Fast Search option enabled
Followed by any conditions, in the order that they were provisioned, that do not have the Fast Search option enabled.
Though all rules in a Rule Set have the same conditions available, rules can be provisioned with one or more of the conditions “empty” (with no values), indicating that the condition is always matched in message processing. The rules with empty conditions are listed after the rules that contain values for the same conditions.

When a Rule Set entry is selected in the Rule Sets folder, the Diameter > Mediation > Rule Sets > {name} page opens for the selected Rule Set.

On each Diameter > Mediation > Rule Sets > {name} page, a user can perform the following actions:

Filter by the column contents, to display only the rules with the desired contents.
If the Move a rule columns are displayed and contain Up and Down buttons, move rules up and down in the list to change the order of execution of the rules in the Rule Set.
Click Insert to add a new rule.
The Diameter > Mediation > Rule Sets > {name} [Insert] page opens.

The Diameter > Mediation > Rule Sets > {name} [Insert] page will not open if adding a new rule will cause the allowed maximum number of rules in the Rule Set (250) to be exceeded.

The Diameter > Mediation > Rule Sets > {name} [Insert] page will not open if adding a new rule will cause the allowed maximum total number of rules in the system (3750) to be exceeded.

Rule Templates without any conditions form a special case, because their provisioned rule unconditionally matches. The Rule Sets generated from these Rule Templates allow only one rule to be provisioned.
Click Import to import rules from an XML-file (Rule Template) that is either in a "Test" or "Active" state.
Click Delete All Rules to delete all of the rules that have been provisioned for this Rule Set.
Select a rule and click Edit.
The Diameter > Mediation > Rule Sets > {name} [Edit] page opens. You can change the Values of the Conditions and Actions for the selected rule.
Select a rule and click Delete to delete the rule from the Rule Set list.
Click Export to export rules to create an XML-file containing the Mediation version number, Template Definition, the provisioned values of the conditions and actions for each rule.
Select Show Counters to open the Rule Counters column of the Rule Set. A Total Pegs column displays the number of times the specific rule is matched.
If Show Counters is grayed out the Rule Counters will not open. To enable see Editing State and Properties.

When the Rule Sets View screen is expanded with the Rule Counters, the following buttons are available:
- Click <<Hide Counters to hide the Rule Counters column.
- Click Expand Counters expands more sub-columns under the Rule Counters for all MPs under the SO. Each sub-column is MP name and displays the counters for each.
- Click Collapse Counters to hide the MP counters.
The Pause Updates box is unchecked by default. This means the counters refreshes every 30 second to provide the user a printout on the GUI screen. Checking the Pause Updates box pauses the counters. To disable the counter, see Editing State and Properties.