Policy Rule Installation Failure Handling

By default, MATRIXX Policy Application ignores Gx policy rule installation failures on the PCEF.

To configure Gx policy rule installation failure handling, you must answer y to the following global create_config.info question: Global:Session:Policy:Notify:Enable graceful handling of Gx rule installation failures (y/n)?

When true, installation failures of policy rules unknown to the PCEF are handled by MATRIXX PCRF for the following scenarios:
  • Rule-Failure-Code=UNKNOWN_RULE_NAME(0) in response to CCA (rules pulled by PCEF).
  • Rule-Failure-Code=UNKNOWN_RULE_NAME(0) in response to RAR (rules pushed by PCRF).
The PCEF sends the following AVPs in a Gx CCR or Gx RAA on rule installation failures for unknown rules:
  • AVP: Charging-Rule-Report (1018), len=16, V=1, M=1, P=0, VendorId=10415, dataType=Grouped
    • AVP: Rule-Failure-Code (1031), len=4, V=1, M=1, P=0, VendorId=10415, dataType=Enumerated, value=1

The following sections describe how the PCRF response is determined by the Gx message type.

Gx CCR

In response to a PCEF Rule-Failure-Code in Gx CCR:
  1. The PCRF deletes the policy session.
  2. The PCRF sends a Gx CCA containing the AVPs:
    • Experimental-Result(297), len=24, V=0, M=1, P=0, VendorId=0, dataType=Grouped
      • Vendor-Id(266), len=4, V=0, M=1, P=0, VendorId=0, dataType=Unsigned32, value=10415
      • Experimental-Result-Code(298), len=4, V=0, M=1, P=0, VendorId=0, dataType=Unsigned32, value=5007
    • Error-Message(281), len=81, V=0, M=0, P=0, VendorId=0, dataType=UTF8String, value=Received Gx CCR-U with Rule-Failure-Code=1. Session will be deleted. Session ID=1

Gx RAA

In response to a PCEF Rule-Failure-Code in a Gx RAA:

  1. The PCRF initiates a graceful termination of the Gx session by sending a Gx RAR containing the following AVP:

    Session-Release-Cause(1045), len=4, V=1, M=1, P=0, VendorId=10415, dataType=Enumerated, value=0

  2. While awaiting PCEF RAA response to the above (or a timeout) the PCRF uses the following:
    1. MtxSessionPolicyObject State flag, POLICY_SESSION_STATE_FLAG_NOTIFICATION_FAILURE
    2. Gx RAR failure handling configuration parameters:
      • Global:Session:Policy:Notify:How many attempts?1
      • Global:Session:Policy:Notify:How long (in seconds) to wait after each attempt?30
  3. If the release notification RAR times-out, the PCRF deletes the session after n resend attempts.
  4. If the PCEF acknowledges (with a RAA), the PCRF retains the session until the PCEF initiates termination with a CCR-T.