Rules Data Model (4.0)
The UDRs in PCRF.Rules store information about different rules regarding the provided quality of service for different subscribers.
See APL - PCC Runtime Support (4.0) for further information about how to use the PCC.Rules UDRs with APL.
The main objects of PCRF.Rules are:
Object | Description |
---|---|
Rules_Mapping | A flexible mapping table used to map from an external representation to a list of rules. The mapping should not include any information related to a specific subscriber. |
Rules | Rules contains the rule settings regarding quality of service and charging that should be applied for the subscribers. |
Overview of the Rules Data Model
The different UDRs within the Rules Data Model are connected as follows:
Overview of the Rules Data Model
RulesMapping UDR
In the RulesMapping UDR you set up the priority for the rules mapping, the product, enforcements, notifications, etc that the rules mapping should use and the PCC rules that should be applied.
Field | Description |
---|---|
| The unique ID of the rules mapping table. |
| The priority of the mapping item, a low value indicates a high priority. Determines the order in which the matched mapping objects are returned. |
| The arguments of a mapping object e g the product. The arguments are stated with regular expressions, which means that entering "Products [2-5]" will match Products 2, 3, 4, or 5. |
| The different rules used by the mapping object, see the section below PCC_Rule UDR. |
| Used in the rules selection process. If several rules apply, but the one with highest priority has been configured with StopFallthrough set to Yes in the APL code, only this rule will be returned if it is active. If it is not active, all other active rules that apply will be returned. |
Below is a screenshot of the UDR Assistance displaying the RulesMapping UDR:
RulesMapping UDR
Example RulesMapping UDR
The following values:
ID=11 Priority=2 Arguments=['Product 1'] Targets=[1,2] ID=12 Priority=1 Arguments=['Product 2-4'] Targets=[3] StopFallthrough=yes
will give the following setup:
The second mapping table, with priority 1, will have higher priority than the first one, with priority 2.
The first mapping table use the product
Product 1
, while the second mapping table use the productsProduct 2
,Product 3
, orProduct 4
.The first mapping table uses PCC Rules with IDs 1 and 2, while the second mapping object uses the rule with ID 3.
If the second mapping table is active, only the rules for this table will be returned even if other rules apply.
PCC_Rule UDR
In the PCC_Rule UDR you determine the period during which the rule should be active, the charging rule that should be applied and the quality of service that should be applied for the rule.
Field | Description |
---|---|
| The unique ID of the rule. |
| The activity period that the rule should have, see Periods Data Model Rules (4.0). |
| The charging rules that should be applied for this rule, see the section below, Charging_Rule UDR. |
| The name of the rule. |
| The quality of service that should be applied for this rule, see the section below, QoS_Information UDR. |
Below is a screenshot of the UDR Assistance displaying the Rules UDR:
Rules UDR
Example Rules UDR
The following values:
ID=1 Period='WEEKDAYS' Charging_Rules=[1] Rule_Name='PRIMARY' QoS=[20] ID=2 Period='NIGHTS' Charging_Rules=[3] Rule_Name='SECONDARY' QoS=[10] ID=3 Period="WEEKENDS' Charging_Rules=[5] Rule_Name='THIRD' QoS=[30]
will give the following setup:
The IDs used for the three rules; 1,2 3, are the IDs stated as Targets in the mapping tables, see the section above, RulesMapping UDR.
The three rules are active during three different periods;
WEEKDAYS
,NIGHTS
andWEEKENDS
, see Periods Data Model Rules (4.0).Rule number 1 uses the charging rule with ID 1, rule number 2 uses charging rule with ID 3 and rule number 3 uses charging rule with ID 5, see the section below, Charging_Rule UDR.
The names of the rules are
PRIMARY
,SECONDARY
andTHIRD
.The first rule uses QoS ID 20, the second rule uses QoS ID 10 and the third rule uses QoS ID 30, see the section below, QoS_Information UDR.
Charging_Rule UDR
In the Charging_Rule UDR you determine the Static, Dynamic or Final Indication that should be used for the charging rule.
Field | Description |
---|---|
| The unique ID of the charging rule. |
| The name of the charging rule. |
| The static rule that should be applied, see the section below, Static_Rule UDR. |
| The dynamic rule that should be applied, see the section below, Dynamic_Rule UDR. |
| The final indication rule that should be applied, see the section below, Final_Indication_Rule UDR. |
Note
The Charging rule only indicates one type of rule; static, dynamic or final indication, not a combination.
Below is a screenshot of the UDR Assistance displaying the Charging_Rule UDR:
Charging_Rule UDR
Example Charging_Rule UDR
The following values:
ID=1 Name='PRIMARY' Static_Rule=111 Dynamic_Rule= Final_Indication_Rule= ID=3 Name='SECONDARY' Static_Rule=112 Dynamic_Rule= Final_Indication_Rule= ID=5 Name='REST' Static_Rule= Dynamic_Rule= Final_Indication_Rule=200
will give the following setup:
The first charging rule, with ID 1 and name Primary, uses the static rule with ID 111.
The second charging rule, with ID 3 and name Secondary, uses the static rule with ID 112.
The third charging rule, with ID 5 and name Rest, uses the final indication rule with ID 200.
QoS_Information UDR
The QoS_Information UDR contains Quality of Service parameters according to 3GPP specifications TS 29.212 and TS23.203.
Field | Description |
---|---|
| The unique ID of the quality of service. |
| The name of the quality of service. |
| The maximum aggregated bit rate for downloading data to the APN (Access Point Name). |
| The maximum aggregated bit rate for uploading data from the APN (Access Point Name). |
| The priority of allocation and retention, the pre-emption capability and pre-emption vulnerability. This field is only applicable for Dynamic Rules. |
| The guaranteed bit rate for downloading data. |
| The guaranteed bit rate for uploading data. |
| The maximum bit rate for downloading data. |
| The maximum bit rate for uploading data. |
| The Quality of Service Class Identifier identifies a set of QoS parameters that define the authorized QoS, excluding the applicable bitrates and ARP, for the bearer or service flow. The following values are defined:
|
Below is a screenshot of the UDR Assistance displaying the QoS_Information UDR:
QoS_Information UDR
Example QoS_Information UDR
The following values:
ID=10 Name='Quality A' APN_AGG_MBR_DL=32 APN_AGG_MBR_UL=32 GBR_DL=64 GBR_UL=64 MBR_DL=128 MBR_UL=64 QCI=7 ID=20 Name='Quality B' APN_AGG_MBR_DL=32 APN_AGG_MBR_UL=32 GBR_DL=64 GBR_UL=64 MBR_DL=128 MBR_UL=128 QCI=4
will give the following setup:
The maximum aggregated bit rate for both uploading and downloading data is 32 kbit/s for both QoS settings, Quality A and Quality B.
The guaranteed bit rate for both uploading and downloading data is 64 kbit/s for both QoS settings.
The maximum bit rate for uploading data is 64 kbit/s for Quality A and 128 kbit/s for Quality B.
The maximum bit rate for downloading data is 128 kbit/s for both QoS settings.
The first QoS setting uses Quality of Service Indicator 7, while the second uses Quality of Service Indicator 4.
Static_Rule UDR
Static rules are provisioned via the Gx interface and can be activated or deactivated at any time.
Field | Description |
---|---|
| The unique ID of the static rule. |
| The name of the static rule. |
| The base name of the rule which indicates the name of a pre-defined group of PCC rules. This field is not necessary if a Rule Name has been set. |
Below is a screenshot of the UDR Assistance displaying the Static_Rule UDR:
Static_Rule UDR
Example Static_Rule UDR
The following values:
ID=111 Rule_Name='STATIC 1' ID=112 Rule_Name='STATIC 2' ID=113 Rule_Name='STATIC 3'
will give the following setup:
The three static rules; 111, 112 and 113, have the names
STATIC 1
,STATIC 2
andSTATIC 3
.
Dynamic_Rule UDR
Dynamic rules are dynamically provisioned via the Gx interface. Dynamic PCC rules can be installed, modified and removed at any time.
For information about the fields in the Dynamic_Rule UDR, see specification TS 29.212 from 3GPP.
Below is a screenshot of the UDR Assistance displaying the Dynamic_Rule UDR:
Dynamic_Rule UDR
Final_Indication_Rule UDR
A Final Indication Rule is used to indicate when a subscriber should be redirected or blocked based on reaching a certain usage level. In the case of mobile data traffic control, this would be done by sending the information in the Gy-answer (as opposed to Gx, which is used for Static and Dynamic rules), in the Multiple-Services-Credit-Control field "Final-Unit-Indication", with the same fields populated as the fields in this table.
Field | Description |
---|---|
| The unique ID of the final indication rule. The ID is only included as a key and will not be part of the MSCC. |
| The name of the final indication rule. |
| The rating group for the final indication rule. |
| Indicates if redirection should be used. Possible values are 0 - Terminate, 1 - Redirect and 2 -Restrict Access. |
| The type of address used for the redirect messages; 0 - IPv4 Address, 1 - IPv6 Address, 2 - URL, or 3 - SIP URI. |
| The address the subscriber should be redirected to. |
| The ID of the filter to be used. |
| The Restriction_Filter_Rule to be used |
Below is a screenshot of the UDR Assistance displaying the Final_Indication_Rule UDR:
Final_Indication_Rule UDR
Example Final_Indication_Rule UDR
The following values:
ID=100 Name='FIRST REDIRECT' Rating_Group=1 Final_Unit_Action=1 Redirect_Address_Type=2 Redirect_Server_Address='http://example1.com' ID=200 Name"'SECOND REDIRECT' Rating_Group=2 Final_Unit_Action=1 Redirect_Address_Type=2 Redirect_Server_Address='http://example2.com'
will give the following setup:
The first rule, with ID 100 and name First Redirect, will use rating group 1 while the second rule, with ID 200 and name Second Redirect will use rating group 2.
Both rules will use redirect messages (indicated by setting
Final_Unit_Action
to 1).The type of address used for the redirect messages is URL (indicated by setting
Redirect_Address_Type
to 2).The subscribers adhering to the rule with ID 100 will be redirected to
http://example1.com
, while the subscribers adhering to the rule with ID 200 will be redirected tohttp://example2.com/
.