Triggers

An execution trigger defines a Triggering Point within the message processing logic. When the triggering point is reached, the mediation operations (Rule Sets) associated with that triggering point are executed. The type of the Trigger defines whether the triggering point is part of the request or the answer processing. The Rule Set can be defined to be executed as a part of the Actions of another Rule Set, or it can be triggered at some specific point of the message processing. A Trigger is executed during an ingress and egress message.

Associations of a Trigger with new Rule Sets can be added, existing associations can be removed, and the sequence of the Rule Set Name list can be changed to modify the MP behavior based on the Rule Set execution. The behavior of an MP is exactly the same with and without a Trigger if no Rule Set is associated with the Trigger.

Rule Sets that are associated with a Trigger are executed in the sequence in which they are listed under the Trigger name on the Diameter > Mediation > Triggers page.

The available Diameter Mediation Triggers are the:

Diameter Routing Layer (DRL) Triggers, which enable request and answer messaging using RTP1, RTP10, ATP1, ATP10 and RTP11 trigger points. The Triggers described in Diameter Mediation Routing Layer Triggers are available for Diameter Mediation.

Diameter Mediation Routing Layer Triggers
Execution Trigger Name	Message Type	Triggering Point
Diameter request message received from connection	Request	Request Trigger Point 1; occurs upon receipt of a request (RTP1)
Diameter request message ready to be forwarded to connection	Request	Request Trigger Point 10; occurs just before forwarding the request upstream (RTP10)
Diameter answer message received from connection	Response	Answer Trigger Point 1; occurs upon receipt of an answer (ATP1)
Diameter answer message ready to be forwarded to connection	Response	Answer Trigger Point 10; occurs just before forwarding the answer downstream (ATP10)
Diameter request message attempted for re-route	Request	Request Trigger Point 11 (RTP11); occurs just prior to re-routing the request upstream.

Diameter Connection Layer (DCL) Triggers enable peer-to-peer messaging using CEx, DWx, DPx trigger points.

The data stored as an Internal Variable or a linking AVP at one of the DCL triggers is valid only inside of the current trigger and can not be accessed by other triggers. The Triggers described in Table 2 are available for Diameter Mediation.

Diameter Mediation Connection Layer Triggers
Execution Trigger Name	Message Type	Triggering Point
CER message received from connection	Request	Capabilities- Exchange-Request Trigger Point 1; occurs upon receipt of a CER message (CER1)
CER message ready to be sent	Request	Capabilities- Exchange-Request Trigger Point 10; occurs just prior to sending the CER message (CER10)
CEA message received from connection	Response	Capabilities- Exchange-Answer Trigger Point 1; occurs upon receipt of a CEA message (CEA1)
CEA message ready to be sent	Response	Capabilities- Exchange-Answer Trigger Point 10; occurs just prior to sending the CEA message(CEA10)
DWR message received from connection	Request	Device-Watchdog-Request Trigger Point 1; occurs upon receipt of a DWR message (DWR1)
DWR message ready to be sent	Request	Device-Watchdog-Request Trigger Point 10; occurs just prior to sending the DWR message (DWR10)
DWA message received from connection	Response	Device-Watchdog-Answer Trigger Point 1; occurs upon receipt of a DWA message (DWA1)
DWA message ready to be sent	Response	Device-Watchdog-Answer Trigger Point 10; occurs just prior to sending the DWA message (DWA10)
DPR message received from connection	Request	Disconnect-Peer-Request Trigger Point 1; occurs upon receipt of a DPR message (DPR1)
DPR message ready to be sent	Request	Disconnect-Peer-Request Trigger Point 10; occurs just prior to sending the DPR message (DPR10)
DPA message received from connection	Response	Disconnect-Peer-Answer Trigger Point 1; occurs upon receipt of a DPA message (DPA1)
DPA message ready to be sent	Response	Disconnect-Peer-Answer Trigger Point 10; occurs just prior to sending the DPA message(DPA10)

Application Triggers can modify the requests and answers based on the condition that the message is forwards or exits an application. The application can be verified before the template / rule set's execution, when the trigger points are assigned. The Diameter > Mediation > Triggers [Insert] screen provides an association between the template (rule set) and the DSR application, with the options to:

Execute the template (rule set), if the involved application is "name of the application".
Execute the template (rule set) unconditionally, in other words, for all involved applications.

The Triggers described in Table 3 are available for Diameter Mediation.

Diameter Mediation Application Triggers
Execution Trigger Name	Message Type	Triggering Point
Diameter request message ready to be forwarded to application	Request	Request Trigger Point 4; occurs just prior to the invocation of a DSR application (RTP4)
Diameter request message received from application	Request	Request Trigger Point 6; occurs immediately after exiting a DSR application (RTP6)
Diameter answer message ready to be forwarded to application	Response	Answer Trigger Point 4; occurs just prior to the invocation of a DSR application (ATP4)
Diameter answer message received from application	Response	Answer Trigger Point 6; occurs immediately after exiting a DSR application (ATP6)

Templates will not be executed if:
- A template (rule set) is assigned to a specific application and the application is disabled, the associated templates (rule sets) will not be executed.
- A DSR application generates an Answer, the templates at RTP6 and ATP4 will not be executed.
- A DSR application generates a Request, the templates at RTP4 and ATP6 will not be executed.
- A DSR application does not stay in the loop for answer processing, the templates at ATP4 or ATP6 will not be executed.

Rule Sets that are associated with a Trigger are executed in the sequence in which they are listed under the Trigger name on the Diameter > Mediation > Triggers page. On the Diameter > Mediation > Triggers page, you perform the following actions:

Click the Insert button under a Trigger name.
The Diameter > Mediation > Triggers [Insert] page opens to associate a new Rule Set with the Trigger. See Associating a Rule Set with a Trigger.
Select a Rule Set Name in the list under a Trigger name, and click the Remove button.
The association of the Rule Set with the Trigger can be removed, and the Rule Set Name is deleted from the list for the Trigger. See Removing the Association of a Rule Set with a Trigger
Use the Up and Down buttons to alter the sequence of execution of the Rule Sets associated with a Trigger.
- For a selected Rule Set Name, clicking the Up button under the Rule Set Name list moves the selected Rule Set Name one position toward the top or beginning of the list.
- For a selected Rule Set Name, clicking the Down button under the Rule Set Name list moves the selected Rule Set Name one position toward the bottom or end of the list.