Home
MATRIXX Policy
3G/4G Policy Overview
The 3G/4G MATRIXX Policy Application provides the business logic to support real-time policy decisions and rules. It allows charging and network quality of service (QoS) to be flexibly and dynamically linked to customer, service, and network parameters.
Policy Session APIs
The SubMan APIs include session query, session validation, and session delete APIs for charging and policy sessions.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
- About MATRIXX Policy
  MATRIXX Policy describes the tasks that must be completed to configure MATRIXX Policy Application functionality and provides overviews, recommendations, and conceptual discussions to help you understand these tasks. In addition, it describes the supported Diameter policy AVPs and MATRIXX Policy Application SubMan APIs.
- 5G Policy Overview
  The MATRIXX Policy Application provides the business logic and integration into a third-party Policy Control Function (PCF) to support real-time policy decisions and rules. It enables your PCF to deliver flexible policy and charging control rules to your 5G network.
- 3G/4G Policy Overview
  The 3G/4G MATRIXX Policy Application provides the business logic to support real-time policy decisions and rules. It allows charging and network quality of service (QoS) to be flexibly and dynamically linked to customer, service, and network parameters.
  - Gy Sessions
    The policy Gy reference point enables communication between MATRIXX Charging Application Online Charging System (OCS) and a Policy and Charging Enforcement Function (PCEF).
  - Spending Limit Policy — Sy Sessions
    MATRIXX Charging Application communicates with an external Policy and Charging Rules Function (PCRF) using the Sy interface.
  - Session Management Policy — Gx Sessions
    MATRIXX Engine includes MATRIXX Charging Application, which is a Policy and Charging Rules Function (PCRF), which communicates with an external Policy and Charging Enforcement Function (PCEF) using the Gx reference point.
  - Policy Session APIs
    The SubMan APIs include session query, session validation, and session delete APIs for charging and policy sessions.
- 3G/4G Policy Configuration
  Policy configuration in My MATRIXX includes both session management and spending limit configuration.
- 3G/4G MATRIXX Policy Failover
  A MATRIXX Policy failover can be due to a hard failure or can be planned.
- Policy Profile Selection
  During policy profile selection, product offers are evaluated in descending order from highest to lowest priority. Policy profiles are collected for Sy and N28 policy counters, Gx command-level QoS, and N40 TIME_LIMIT and VOLUME_LIMIT usage triggers.
- Policy Processing Based on Quota Action
  You can configure a product offer so that Spending Limit Control/Sy policy components and Session Management/Gx components are applied when quota is authorized or denied.
- Spending Limit Policy Counter APIs
  The Sy policy counter APIs include MtxRequestDeviceEvaluatePolicyCounterSet and MtxRequestDeviceQuerySession.
- Diameter AVPs for MATRIXX Policy Application
  MATRIXX Engine supports the Sy and Gx interfaces for policy control.
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Policy Session APIs

The SubMan APIs include session query, session validation, and session delete APIs for charging and policy sessions.

Query Sessions

The MtxRequestDeviceQuerySession SubMan API queries active charging, policy, and application sessions to determine if a session exists for a device. The MtxRequestDeviceQuerySession API returns the following information in the MtxPolicySessionInfo MATRIXX Data Container (MDC):

SessionId
UpdateTime
SessionStartTime
SourceHost
SourceRealm
SessionType (1 = Sy, 2 = Gx)
Is5G (true = 5G, false = 4G)
NotifyUri
PolicyProfileName
Any private, session MDC fields (MtxChargingSessionExtension and MtxPolicySessionExtension)

Validate Sessions

The MtxRequestDeviceValidateSession SubMan API validates sessions. When a session is validated, a Gy RAR, Sy SNR, or Gx RAR message is sent. The API input can include the SessionId and the SessionType.

The session types are:

Gy = 1
Sy = 2
Gx = 3

If neither the SessionId or the SessionType is specified, all open sessions for the specified device are validated. If the device has no open sessions, no errors are returned. If a SessionId is specified, only the specified session is validated. If the specified session is not found, an error is returned. If a SessionId is not specified, but a SessionType is specified, only sessions of the specified type are validated. If the device does not have sessions of the specified type, no errors are returned.

If the session to be validated is a charging session, a Gy RAR message is sent for every context in the session.

If the session to be validated is an Sy policy session, an Sy SNR message is sent regardless of whether the applicable Sy policy counters have changed.

If the session to be validated is a Gx policy session, a Gx RAR message is sent regardless of whether the policy has changed.

Note: If a prior Gx RAR message pending receipt of an RAA exists, no additional Gx RAR messages are sent.

For more information about policy and charging APIs, see Subscriber Management (SubMan) API.

Delete Sessions

Specify the individual session IDs to delete by using the MtxRequestDeviceDeleteSession API. If the SessionIdList is not populated, all sessions of the type specified by SessionType are deleted. If neither of these parameters are populated, all sessions for this device are deleted.

The session types are:

Gy = 1
Sy = 2
Gx = 3