Application Routing Rule configuration elements

Table 1 describes the fields on the Application Routing Rules View, Insert, and Edit pages. Data Input Notes apply only to the Insert and Edit pages; the View page is read-only.

Application Routing Rules Configuration Elements
Field (* indicates required field) Description Data Input Notes
* Rule Name Name of the Application Routing Rule. The Name must be unique.

Format: text box; case-sensitive; alphanumeric and underscore (_); cannot start with a digit and must contain at least one alpha (A-Z, a-z)

Range: 1 - 32 characters

* Application Route Table Application Route Table associated with this Rule. View Only
* Priority

Priority of the Rule in relation to other Rules.

The lower the Priority number, the higher a Priority a Application Routing Rule will have. That is, the Application Routing Rule with a Priority set to 1 has first priority, the Application Routing Rule with a Priority set to 2 has second priority, and so on.

Format: text box; numeric

Range: 1 - 99

* Conditions

Conditions associated with this Rule.

Each condition has three parts:
  • Parameter
  • Operator
  • Value
Parameter:
  • Destination-Realm
  • Destination-Host
  • Application-ID
  • Command-Code
  • Origin-Realm
  • Origin-Host

Format: Operator and Value for each Parameter

Operator

Sets the relationship between the Parameter and the Value. For example, if the Operator is set to Equals then the Diameter message Parameter must match the set Value.

Format: Pulldown list

Range: See Application Routing Rule operators for a description of operators available for each parameter.

Default: "-Select-"

Value

The value in the Diameter message that the Application Routing Rule uses to determine a match.

The Value field is required when the Operator is "Equals", "Starts With", and "Ends With".

The Value field is disabled for the Operators "Present", "Absent", and "Always True".

Format: text box or pulldown list
  • Destination-Realm and Origin-Realm: text box; case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be at most 63 characters long and a Realm cab be at most 255 characters long.
  • Destination-Host and Origin-Host (FQDN): text box; case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be at most 63 characters long and a FQDN can be at most 255 characters long.
  • Application-ID: pulldown list of configured Application Ids
  • Command-Code: pulldown list of configured Command Codes, including Extended Command-Code (ECC) immediately after their parent Command-Code
    Note: An ECC is a Command Code that also takes into account the value of a specific AVP for that Command Code that gives the "true" command type (for example, CCR-I, CCR-U, and so on).

Range: One or more Parameters with Operator and Value for each Parameter

Default for Application-Id and Command Code: "-Select-"

Action The action that will happen if the Diameter message matches the conditions set in the Application Routing Rule:
  • Route to Application: routes a message to an Application associated with this Rule.
  • Forward To Egress Routing: forward the message to PRT to route to Peer
  • Send Answer: send and answer response containing the required Result-Code and optional Vendor Id and Answer Error Message associated with the application routing rule
  • Abandon With No Answer: abandon message routing without sending an Answer response to external peer.

Format: selection box

Range: Route to Application, Forward to Egress Routing, Send Answer, and Abandon With No Answer

Default: Route to Application

Answer Result-Code Value The value to be placed in the Result-Code AVP of the Answer message.

A Diameter answer code is required if the Action is set to Send Answer.

Format: selection box radio button for pulldown list; radio button for text box

Range: 1000 - 5999

Default: none

Vendor Id

The value to be placed in the Vendor Id AVP

Format: text box; digits only

Range: 0 - 4294967295

Default: none

Answer Error Message String to be placed in the Error-Message AVP of the Answer message

Format: text box; case-sensitive; alphanumeric and underscore (_); cannot start with a digit and must contain at least one alpha (A-Z, a-z)

Range: 0 - 64

Default: null, no Error-Message AVP in Answer message

* Application Name DSR Application Name associated with this Rule.

Format: pulldown list

Range: All activated DSR Applications

Default: "-Select-"

Gx-Prime If this Rule matches a Request, Policy DRA treats the Request's Diameter Application as Gx-Prime. Check box