Adding a Rule Template

Use this procedure to define a new Rule Template. A maximum of 64 Rule Templates can be defined.

There are three sections of the Diameter > Mediation > Rule Templates [Insert] page: Settings, Conditions, and Actions. For a list of Rule Template elements and their definitions, see Rule Template elements.

After the definition is complete and the Rule Template State is set to "Active" or "Test", this Rule Template appears as a Rule Set in the Diameter > Mediation > Rule Sets menu folder.

  1. If Mediation-Triggered Message Copy will be used (the Message Copy Action will be selected in one or more Rule Templates), the following Diameter Configuration is required before each Action can be configured.
    1. Configure one or more Route Groups that will be used for one or more Route Lists for the Message Copy DAS.
    2. Configure one or more Route Lists for the DAS.
    3. Configure one or more Message Copy Configuration Sets that can be assigned to one or more Rule Template Message Copy Actions.
  2. Verify that the required Diameter Mediation Enumeration Types, Internal Variables, AVP Dictionary entries, and Vendors have been defined in the system.

    Use the following GUI pages to view the entries, and to access the GUI pages to enter, change, or delete entries as needed:

  3. Select Diameter > Mediation > Rule Templates.

    The Diameter > Mediation > Rule Templates page opens.

  4. Click the Insert button.

    The Diameter > Mediation > Rule Templates [Insert] page opens.

    If the maximum number of Rule Templates (100) already exist in the system, the Rule Templates [Insert] page will not open, and an error message is displayed.

  5. Enter the Settings values for the Rule Template.
    1. Enter the name for the Rule Template in the Rule Template Name text box.

      The Name describes the purpose of the Rule Template.

    2. The Message type support for the Rule Template cannot be provisioned.

      Request and Answer are both supported.

  6. Enter the values to define up to 5 Conditions in the Rule Template. The grouped AVPs can be up to 6 levels deep.

    Note: A Rule Template can be defined with no Conditions. It will unconditionally match for all processed messages.

    The order the conditions appear on the Diameter > Mediation > Rule Templates page are marked with a letter A, B, C, D, E, etc.. The Up and Down buttons are used to change the order of processing.

    The Fast Search check mark or stop symbol displayed for a condition is determined by the Operator and the Optional fields. A check mark appears for Fast Search when the Operator is either "equals", "begins with-longest match", or "begins with", and the Optional element is not check marked.

    A check mark in Optional indicates that a matching expression is optional. This means that the user can leave this condition's Value field blank on the Diameter > Mediation > Rule Set page, and this condition will then not be used during message processing.

    1. Enter a Name for the condition. This name appears on the generated Rule Set page after this Rule Template is saved.
    2. Enter a Description for the condition. This description that appears for a Condition on the Rule Sets page. If possible, provide information such as the format to be used (such as text string or telephone number format) and the range of values (such as 1 to 255 characters).
    3. Enter a Left value in the text box, or use the Formatting Value Wizard to select the components of the Left value.

      The Left value appears in the text box.

    4. Select an Operator from the pulldown menu.
    5. Select a Right value from the pulldown list.
    6. Provide a Default value for the Right value that will appear on the Rule Set page that is generated from the Rule Template.
    7. Click the appropriate check boxes to display a check mark in the boxes that apply for this Rule Template.

      Click the Optional check box to indicate that the user can decide to exclude the matching expression form the condition set by leaving the Right value empty.

      Click the Fixed check box to indicate that the Right value cannot be changed in the rule.

    8. To add another condition, click Add and repeat the substeps in this step for each additional condition.
  7. Enter the values to define one or more Actions in the Rule Template.

    When any defined Conditions are met, the Actions specified in this section of the page are taken. At least one Action must be specified for a Rule Template.

    1. From the New Action pulldown list, select an Action to take for this Rule Template.
    2. Click [Add] to open the GUI fields for the selected Action.
    3. Enter the information in the fields. The fields are described in Rule Template elements.
  8. When the Rule Template definition is complete, click:
    • OK to save the Rule Template and return to the Diameter > Mediation > Rule Templates page. The Rule Template Name appears in the list on the page.
    • Apply to save the Rule Template and remain on the Diameter > Mediation > Rule Templates [Insert] page for additional changes.
    • Cancel to return to the Diameter > Mediation > Rule Templates page without saving the Rule Template.

    If OK or Apply is clicked and any of the following conditions exist, an error or warning message appears:
    • Any of the Default value fields in the Conditions contain a value that cannot fit into the range of the selected Right value with a supported Operator.
    • Any of the Default value fields in the Conditions contain a value that is not valid or is not the correct format for the selected Right value with a supported Operator.
    • Adding the new Rule Template would cause the maximum number (100) of Rule Templates allowed in the system to be exceeded.

  9. If you want to add online help to describe this Rule Template in its generated Rule Set, perform the Adding online help to a Rule Template procedure. Then continue with 10.
  10. When the Rule Template definition is complete, go to the Diameter Mediation State & Properties page.
    1. Change the Rule Template State from Development to either Test or Active.
    2. Set the Action Error Handling property.

    After the Rule Template definition is completed and saved, the Rule Template state and properties can be changed to make the Rule Template available for testing and to generate the Rule Set from the Rule Template.

    The Rule Template state can be changed to Test to allow testing, provisioning of the Rule Set data, and associating the Rule Set with a Trigger (see Triggers) before the Rule Set is used in live traffic.

    The state can be changed to Active after the testing is successful, the Rule Set data is provisioned, the Rule Set is associated with a Trigger, and the Rule Set is ready to use in live traffic.

  11. If one or more Rule Template Actions for Message Copy have been configured, go to the Diameter > Configuration > System Options page, select the Message Copy Options tab, and select the Enabled radio button for the Message Copy Feature element.
Parent topic: Rule Templates