This command sets an
action to install a PCC Dynamic rule for the specified PCC-Data-service
in PCC-Action-Set configuration for PCC-Service instance.
Privilege:
Security Administrator,
Administrator
Syntax
[no] dynamic-rule-install data-service data_svc_name [qos-profile qos_prof_name] [precedence preced_value] [monitoring-key mon_key_id [rating-group rating_grp_id] [gate-status {disabled | enabled | enabled-downlink | enabled-uplink}] [defer-by interval delayed_dur] [metering-method {both-duration-volume | duration | volume}] [reporting-level {service-identifier-level | rating-group-level}] [failure-policy { continue | terminate}]
no
Removes the Dynamic
Rule install action configured for specific PCC-Data-Service from
a PCC-Action-Set configuration instance for PCC-Service configuration.
data-service data_svc_name
Specifies the name of
the pre-configured PCC-Data-Service for which Dynamic Rules to be installed
under PCC-Action-Set configuration instance for PCC-Service configuration.
data_svc_name is
a pre-configured PCC-Data-Service instance in PCC-Service Configuration
mode.
metering-method {both-duration-volume | duration | volume}
Specifies the reporting
level to be used by PCEF to report the data usage for the related
PCC rule in a PCC-Data-service instance on IPCF node.
-
both-duration-volume sets
the metering method as based on volume of data usage and duration
of session, both for offline charging in a PCC-Data-service instance
on IPCF node.
-
duration sets
the metering method as based on duration of session usage for offline
charging in a PCC-Data-service instance on IPCF node.
-
volume sets
the metering method as based on the volume of data usage for offline
charging in a PCC-Data-service instance on IPCF node.
If no metering method
is defined, the reporting level preconfigured at PCEF is considered.
monitoring-key mon_key_id
Specifies the pre-defined
Monitoring Key identifier which is to be used in Dynamic Rule for specific
PCC-Data-service under PCC-Action-Set configuration instance for
PCC-Service configuration.
mon_key_id is
a pre-defined Monitoring Key identifier in PCC-Service Configuration
mode.
precedence preced_value
Specifies the precedence
value for the Dynamic Rule for specific PCC-Data-service under PCC-Action-Set
configuration instance for PCC-Service configuration.
preced_value must
be an integer between 1 through 65535.
qos-profile qos_prof_name
Specifies the name of
the pre-configured PCC-QoS-Profile which is to be used in Dynamic Rule
for specific PCC-Data-Service under PCC-Action-Set configuration
instance for PCC-Service configuration.
qos_prof_name is
a pre-configured PCC-QoS-Profile instance in PCC-Service Configuration
mode.
rating-group rating_grp_id
Specifies the pre-defined
Rating Group identifier which is to be used in Dynamic Rule for specific
PCC-Data-service under PCC-Action-Set configuration instance for
PCC-Service configuration.
rating_grp_id is
a pre-defined Rating Group identifier in PCC-Service Configuration
mode.
reporting-level {service-identifier-level | rating-group-level
Specifies the reporting
level to be used by PCEF to report the data usage for the related
PCC rule in a PCC-Data-service instance on IPCF node.
-
service-identifier-level sets
the data usage reporting level to be used by PCEF to report the
data usage for the related PCC rule at the Service Identifier level
which is configured in a PCC-Data-service instance on IPCF node.
-
rating-group-level sets
the data usage reporting level to be used by PCEF to report the
data usage for the related PCC rule at the Rating Group level which is
configured in a PCC-Data-service instance on IPCF node.
If no reporting level
is defined, the reporting level preconfigured at PCEF is considered.
gate-status {disabled | enabled | enabled-downlink | enabled-uplink}
Default: Enabled
Sets the Gate-status
which is to be used in Dynamic Rule for specific PCC-Data-Service under
PCC-Action-Set configuration instance for PCC-Service configuration.
disabled:
disables the Gate status in downlink and uplink direction which
is to be used in Dynamic Rule for specific PCC-Data-Service under
PCC-Action-Set configuration instance for PCC-Service configuration.
enabled: Enables
the Gate status in downlink and uplink direction which is to be
used in Dynamic Rule for specific PCC-Data-Service under PCC-Action-Set
configuration instance for PCC-Service configuration. This is the
default status of Gate.
enabled-downlink:
Enables the Gate status in downlink direction which is to be used
in Dynamic Rule for specific PCC-Data-Service under PCC-Action-Set
configuration instance for PCC-Service configuration.
enabled-uplink:
Enables the Gate status in uplink direction which is to be used
in Dynamic Rule for specific PCC-Data-Service under PCC-Action-Set configuration
instance for PCC-Service configuration.
defer-by interval delayed_dur
This optional keyword
supports the time-of-day-based procedures under PCC-Action-Set instance
by configuring the relative time delay for dynamic rule installation.
delayed_dur configures
the relative delay time by which the corresponding dynamic rule
installation is deferred. The action is triggered only when the
time specified by delayed_dur is
passed.
delayed_dur specifies
the delayed interval in HH MIN SS format.
Following format is
used for
HH MIN SS in
delayed_dur:
-
HH specifies
the hour to defer the action trigger and must be an integer between
00 through 23.
-
MIN specifies
the minutes to defer the action trigger and must be an integer between
00 through 59.
-
SS specifies
the seconds to defer the action trigger and must be an integer between
00 through 59.
failure-policy { continue | terminate}
Default: Continue
This optional keyword
configures the rule failure policy action when failure occurs on
PCEF for PCC rules.
-
Continue: If this
option enabled, the IPCF continues even if PCEF reports rule failure
through charging rule report. This is the default action.
-
Terminate: If this
option enabled, the IPCF triggers PCC session termination on receiving
rule failure through charging rule report.
Usage:
Use this command to
set an action to install a PCC Dynamic rule for the specified PCC-Data-Service
in PCC-Action-Set configuration for PCC-Service instance
Operator can override
parameters such as, QoS profile, Precedence, Gate-status, Monitoring
Key and PCC-Rating-id.
The same command is
used to modify already installed PCC Dynamic-rule for the PCC-Data-Service
by overriding required parameters only.
Additionally defer-by interval keyword
is used to configure relative time by which the corresponding dynamic
rule installation is deferred.
IPCF handles operation
of PCC Rule and activate/deactivate/install/modify/remove
the PCC rules at PCEF through this configuration. PCC rule operation
may fail on PCEF due to various reasons. In such failure cases PCEF
sends back a Charging Rule Report containing name of the failed
PCC rule and corresponding failure cause.
The IPCF handles these
charging rule report and take appropriate actions based on configuration
done through failure-policy keyword.
Charging Rule Report
comes through CCA or RAA messages in a call flow used for handling
the charging-rule-report.
IPCF supports following
charging rule failure codes in report:
- Out-of-credit
- Reallocation-of-credit
- Unknown rule name
- Invalid Rating Group
- Invalid Service Identifier
- GW/PCEF Malfunction
- Limited Resources
- Max No. of Bearers Reached
- Unknown Bearer Id
- Missing Bearer Id
- Missing Flow Description
- Resource Allocation
Failure
- QoS Validation Failure
Charging rule status
can any one of the following in this scenario:
- Active
- Inactive
- Temporarily Inactive
A charging rule report
can occur in CCR message multiple times and maximum of 16 charging
rule reports per CCR message is supported by IPCF.
Example:
The following command
sets the action for PCC-Data-Service named
temp_data1 for
Dynamic Rule install with PCC-QoS-Profile named
temp_qos1 having
precedence
22 and Gate-status
as
Enabled under
PCC-Action-Set configuration instance for PCC-Service configuration:
dynamic-rule-install data-service temp_data1 qos-profile temp_qos1 precedence 22