> PCC-Condition-Group Configuration Mode Commands
> The PCC-Condition-Group Configuration Mode is used to configure the various conditions rating parameters under a logical identifier name in the PCC-Service. A PCC-Condition-Group is a collection of conditions that identify a network or state constraint represented as a logical expression. A maximum of 128 conditions can be configured in one PCC-Condition-Group.
> Important: This configuration mode is supported from StarOS Release 12.1 onward.
> af-application-id
> This command defines a condition based on the application id of an Application Function service through the Rx interface over which the IPCF receives media information for the application usage in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] af-application-id operator af_app_id
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the AF-Application id.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> af_app_id
> Specifies the identity string for AF-Application identifier over Rx interface.
> af_app_id must be an alphanumeric string of 1 to 256 characters.
> Usage
> Use this command to define a condition based on the application id of an Application Function service through the Rx interface over which the IPCF receives media information for the application usage in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the AF Application id is not equal to pcc_af_1:
> af-application-id != pcc_af_1
> af-media-codec
> This command defines a condition based on the media Codec used by AF application in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] af-media-coded operator {g722 | g726 | ilbc | pcma | pcmu}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the AF-media Codec.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> g722
> Specifies the media Codec as G.722 used for user traffic from AF server over Rx interface.
> G.722 is a ITU-T standard 7 kHz wideband speech codec operating at 48, 56 and 64 kbit/s.
> g726
> Specifies the media codec as G.726 used for user traffic from AF server over Rx interface.
> G.726 is an ITU-T ADPCM speech codec standard covering the transmission of voice at rates of 16, 24, 32, and 40 kbit/s.
> ilbc
> Specifies the media codec as Internet Low Bitrate Codec (iLBC) used for user traffic from AF server over Rx interface.
> iLBC is a narrowband speech codec suitable for VoIP applications, streaming audio, archival and messaging. The encoded blocks encapsulated in Real-time Transport Protocol (RTP) protocol for transport.
> pcma
> Specifies the media codec as Pulse Code Modulation A-law scaling (PCMA) used for user traffic from AF server over Rx interface.
> PCMA is an ITU-T Recommendation G.711 audio data encoding in eight bits per sample, after A-law logarithmic scaling.
> pcmu
> Specifies the media codec as Pulse Code Modulation mu-law scaling (PCMU) used for user traffic from AF server over Rx interface.
> PCMU is an ITU-T Recommendation G.711 audio data encoding in eight bits per sample, after mu-law logarithmic scaling.
> Usage
> Use this command to define a condition based on the media codecs used by AF service through the Rx interface over which the IPCF receives media information for the application usage in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the AF Media codec is equal to PCMA:
> af-media-codec = pcma
> af-media-type
> This command defines a condition based on the media type used by AF application in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] af-media-type operator {application | audio | control | data | message | other | text | video}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the media type in user traffic.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> application
> Specifies the media type as Application in user traffic from AF server over Rx interface.
> audio
> Specifies the media type as Audio in user traffic from AF server over Rx interface.
> control
> Specifies the media type as Control in user traffic from AF server over Rx interface.
> data
> Specifies the media type as Data in user traffic from AF server over Rx interface.
> message
> Specifies the media type as Message in user traffic from AF server over Rx interface.
> text
> Specifies the media type as Text in user traffic from AF server over Rx interface.
> video
> Specifies the media type as Video in user traffic from AF server over Rx interface.
> Usage
> Use this command to define a condition based on the media type used by AF service through the Rx interface over which the IPCF receives media information for the application usage in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the AF Media type is equal to Video:
> af-media-type = video
> af-service-urn
> This command defines a condition based on the service Uniform Resource Names (URNs) used by AF application in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] af-service-urn operator urn_string
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <=: Lesser than or equals

> • | =: Equals

> • | >=: Greater than or equals

> urn_string
> Specifies the URN in user traffic from AF server over Rx interface.
> urn_string must be an alphanumeric string of 1 through 256 characters.
> Usage
> Use this command to define a condition based on the URN used by AF service through the Rx interface over which the IPCF receives media information for the application usage in an IP-CAN session.
> Uniform Resource Names (URNs) serves as persistent, location-independent resource identifiers and are designed to make it easy to map other namespaces into URN-space.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the AF service URN is equal to ietf:rfc:4003:
> af-service-urn = ietf:rfc:4003
> an-gw-address
> This command defines a condition based on the IP address of Access Node Gateway (AN-GW) on which subscriber is attached in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] an-gw-address {operator angw_ip/mask | {in-range | !in-range} range_start_ip to range_end_ip}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> in-range
> Specifies the condition to accept the IP address which are in range as argument to define the Access Node Gateway address which is used by subscriber in IP-CAN session.
> !in-range
> Specifies the condition to accept the IP address which are NOT in range as argument to define the Access Node Gateway address which is used by subscriber in IP-CAN session.
> range_start_ip
> Specifies the starting IP address which is used for defining the range of AN-GW IP addresses which is used by subscriber in IP-CAN session.
> range_start_ip is an IP address and must be lesser than end_start_ip address.
> range_end_ip
> Specifies the ending IP address which is used for defining the range of AN-GW IP addresses which is used by subscriber in IP-CAN session.
> range_end_ip is an IP address and must be greater than end_start_ip address.
> angw_ip/mask
> Specifies the IP address of the Access Node Gateway which is used by subscriber in IP-CAN session along with IP mask as well.
> angw_ip must be an IP address in IPv4 or IPv6 notation.
> mask Specifies the IP address mask bits to determine the number of IP addresses of AN-GW in condition. mask must be specified using the standard IPv4 dotted decimal notation.
> Usage
> Use this command to define a condition based on the AN-GW IP address used by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on AN-GW IP address 1.2.3.4 in an IP-CAN session:
> an-gw-address = 1.2.3.4
> authorized-qci
> This command defines a condition based on the authorized QoS Class Identifier used in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] authorized-qci operator qci
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <=: Lesser than or equals

> • | =: Equals

> • | >=: Greater than or equals

> qci
> Specifies the authorized QoS class identifier in user traffic for condition validation.
> qci must be an integer between 1 through 255.
> Usage
> Use this command to define a condition based on the authorized QCI used by the subscriber in an IP-CAN session.
> The condition evaluates to TRUE, if Bearer Control Mode is UE and network (PCEF bearer binding) and IPCF has authorized the specified QCI earlier.
> QCI is a number which describes the error rate and delay that are associated with the service. It includes bearer parameters including scheduling weights and queue management thresholds.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the authorized QCI is greater than or equal to 4:
> authorized-qci >= 4
> base-station-id
> This command defines a condition based on the various parameters used in base-station id by subscriber in an IP-CAN session between PCEF (PDSN) and IPCF over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] base-station-id {[sid operator sys_identifier] | range start_range to end_range]] [nid operator netwrk_identifier ] | range start_range to end_range ]] [ cellid operator cell_identifier ] | range start_range to end_range ]]}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <: Lesser than

> • | <=: Lesser than or equals

> • | =: Equals

> • | >: Greater than

> • | >=: Greater than or equals

> sid operator sys_identifier
> Specifies the system identifier in base-station id of subscriber for condition validation in an IP-CAN session.
> sys_identifier must be an integer between 0 through 65535.
> nid operator netwrk_identifier
> Specifies the network identifier in base-station id, which is used by subscriber, for condition validation in an IP-CAN session.
> netwrk_identifier must be an integer between 0 through 65535.
> cellid operator cell_identifier
> Specifies the cell identifier in base-station id, which is used by subscriber, for condition validation in an IP-CAN session.
> cell_identifier must be an integer between 0 through 65535.
> range start_range to end_range
> This optional keyword specifies range of the identifiers (SID, Cell id, Network Id) to be used for condition validation in an IP-CAN session.
> start_range is the start value of range having integer between 0 through 65535 and it must be lesser than end_range.
> end_range is the end value of range having integer between 0 through 65535 and it must be greater than start_range.
> Usage
> User this command to define a condition based on the parameters used in base-station id of subscriber, which is composition of SID, Cell Id, and/or Network Id, in an IP-CAN session between PCEF (PDSN) and IPCF over Gx interface.
> This condition is defined for PCC functionality support to CDMA users over Gx interface.
> Example
> The following command creates a condition definition to analyze the condition based on base-station id of subscriber where SID is 1001 and cell id is in range of 2001 to 2069 in an IP-CAN session between PDSN and IPCF having network id as 3989:
> base-station-id sid = 1001 nid = 3989 cellid = range 2001 to 2069
> bearer-count
> This command defines a condition based on the number of bearers allowed in a subscriber session on IPCF to accept bearer-count in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] bearer-count operator num_bearer
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <=: Lesser than or equals

> • | =: Equals

> • | >=: Greater than or equals

> num_bearer
> Specifies the number of bearers in user traffic for condition validation.
> num_bearer indicates a condition based on the number of bearer established in a IP-CAN session and must be an integer between 1 through 11.
> Usage
> Use this command to define a condition based on the number of bearers allowed for a subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for bearers allowed in a subscriber session is equal to 4:
> bearer-count = 4
> connectivity-access-network
> This command defines a condition based on the access network type used by subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] connectivity-access-network operator {3gpp-gprs | 3gpp2 | 3gpp2-eps | docsis | wimax | xdsl}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the media type in user traffic.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> 3gpp-gprs
> Specifies the network access connectivity type as 3GPP-GPRS for user traffic in condition definition.
> 3gpp2
> Specifies the network access connectivity type as 3GPP2 (CDMA) for user traffic in condition definition.
> 3gpp2-eps
> Specifies the network access connectivity type as 3GPP2-EPS for user traffic in condition definition.
> docsis
> Specifies the network access connectivity type as Data Over Cable Service Interface Specification (DOCSIS) for user traffic in condition definition.
> wimax
> Specifies the network access connectivity type as Wi-MAX for user traffic in condition definition.
> xdsl
> Specifies the network access connectivity type as xDSL (ADSL/SDSL) or user traffic in condition definition.
> Usage
> Use this command to define a condition based on the type of connectivity used for network access by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the network type is equal to Wi-MAX:
> connectivity-access-network = wimax
> eval-condition-group
> This command defines a condition based on the TRUE or FALSE setting of a configured PCC-Condition-Group for subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] eval-condition-group cond_grp_name operator {FALSE | TRUE}
> no
> Removes the specified condition definition.
> cond_grp_name
> Specifies the name of the configured PCC-Condition-Group which is used for evaluation with in this PCC-Condition-Group for user traffic.
> cond_grp_name must be a pre-configured PCC-Condition-Group in this configuration mode.
> operator
> Specifies how to logically match the media type in user traffic.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> FALSE
> Sets the evaluation condition for specified PCC-Condition-Group to FALSE.
> With this keyword system rejects all conditions defined in specific PCC-Condition-Group and match the same in user traffic.
> TRUE
> Sets the evaluation condition for specified PCC-Condition-Group to TRUE.
> With this keyword system accepts all conditions defined in specific PCC-Condition-Group and match the same in user traffic.
> Usage
> Use this command to define a condition based on the acceptance or rejection of specific pre-configured PCC-Condition-Group for user traffic in an IP-CAN session.
> This command allows the operator to use configured PCC-Condition-Group in another PCC-Condition-Group as subset of PCC-Condition-Group.
> Important: A maximum of 3 level of recursion depth is allowed for PCC-Condition-Group evaluation in a PCC-Condition-Group.
> Example
> The following command creates a condition definition to accept the all conditions defined in PCC-Condition-Group named af_1:
> eval-condition-group af_1 = TRUE
> event-time
> This command defines a condition based on the event-trigger time as per the time specified by the named Time definition (Timedef) configured for subscriber session in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] event-time operator timedef_name
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <=: Lesser than or equals

> • | =: Equals

> • | >=: Greater than or equals

> timedef_name
> Specifies the name of the configured time definition (start and end timer of session) which is used for evaluation with this PCC-Condition-Group for user traffic.
> timedef_name must be a pre-configured Time definition in PCC-Service Configuration Mode.
> Usage
> Use this command to define a condition based on the start and end time defined in a Time Definition configuration in PCC-Service Configuration Mode for user traffic in an IP-CAN session.
> Event trigger in this command indicates a condition when the event-trigger time was as per the time specified by the named Time Definition.
> This command allows the operator to use configured time period as event trigger for this PCC-Condition-Group.
> Example
> The following command creates a condition definition to trigger the condition based on the start and end time defined in Timedef named timedef_night:
> event-time = timedef_night
> event-trigger
> This command defines a condition based on the event triggers due to various conditions for subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] event-trigger operator event_trigger
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the media type in user traffic.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> event_trigger
> Specifies the network events as condition definition for user traffic in an IP-CAN session.
> Following event triggers are supported with this command:

> • | an-gw-change

> • | bearer-qos-change

> • | bearer-setup

> • | bearer-termination

> • | default-eps-bearer-qos-change

> • | ip-can-change

> • | loss-of-bearer

> • | out-of-credit

> • | pgw-trace-control

> • | plmn-change

> • | qos-change

> • | qos-change-exceeding-authorization

> • | rai-change

> • | rat-change

> • | reallocation-of-credit

> • | recover-of-bearer

> • | resource-modification-request

> • | revalidation-timeout

> • | session-setup

> • | session-termination

> • | sgsn-change

> • | successful-resource-allocation

> • | tft-change

> • | ue-ip-address-allocate

> • | ue-ip-address-release

> • | ue-time-zone-change

> • | user-location-change

> Usage
> Use this command to define a condition based on the event triggered in network for user traffic.
> Example
> The following command creates a condition definition when there is a change in traffic flow template for subscriber:
> event-trigger = tft-change
> imsi
> This command defines a condition based on the International Mobile Station Identification number (IMSI) of a subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] imsi operator imsi
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> imsi
> Specifies the IMSI of subscriber to be used for condition validation in an IP-CAN session.
> imsi must be a string of between 8 to 15 digits which starts with 3 digit of MCC then 2 to 3 digit of MNC.
> Wildcard characters $ and * are allowed. The * wildcard matches multiple characters and the $ wildcard matches a single character. If you do not want the wildcard characters interpreted as a wildcard enclose them in single quotes ( ‘ ). For example; ‘$’.
> Usage
> Use this command to define a condition based on the IMSI of a subscriber used in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on subscriber IMSI as 12334566434 in an IP-CAN session:
> imsi = 12334566434
> msisdn
> This command defines a condition based on the Mobile Station International Subscriber Directory Number (MSISDN) of a subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] msisdn operator msisdn
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> imsi
> Specifies the MSISDN of subscriber to be used for condition validation in an IP-CAN session.
> msisdn must be a string of between 1 to 16 digits which contains CC + NDC/NPA + SN.
> Wildcard characters $ and * are allowed. The * wildcard matches multiple characters and the $ wildcard matches a single character. If you do not want the wildcard characters interpreted as a wildcard enclose them in single quotes ( ‘ ). For example; ‘$’.
> Usage
> Use this command to define a condition based on the MS ISDN of a subscriber used in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on subscriber MSISDN as 380561234567 in an IP-CAN session:
> msisdn = 380561234567
> multi-line-or
> This command enables/disables the “OR” relation across all conditions exist in PCC-Condition-Group Configuration Mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] multi-line-or
> no
> Sets the PCC-Condition-Group to “AND” relation across all conditions exist in a PCC-Condition-Group Configuration Mode.
> Usage
> Use this command to enable the “OR” relation across all conditions exist in PCC-Condition-Group Configuration Mode.
> In absence of this command the default relation of “AND” applies across all conditions exist in PCC-Condition-Group Configuration Mode.
> Example
> The following command enables the “OR” relation across all conditions exist in PCC-Condition-Group Configuration Mode:
> multi-line-or
> The following command enables the default “AND” relation across all conditions exist in PCC-Condition-Group Configuration Mode:
> no multi-line-or
> nai
> This command defines a condition based on the Network Access Identifier (NAI) of a subscriber in an IP-CAN session between PCEF (PDSN) and IPCF over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] nai operator {username user_name [domain domain] | domain domain}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> username user_name
> Specifies the subscriber user name to be used for condition validation in an IP-CAN session.
> user_name must be an alpha and/or numeric string of 1 through 128 characters in length. The user name can contain all special characters.
> domain domain
> Specifies the domain (Realm) of subscriber to be used for condition validation in an IP-CAN session.
> domain must be an alpha and/or numeric string of 1 through 128 characters in length. The domain name can contain all special characters.
> Usage
> User this command to define a condition based on the NAI, which contains of user name and domain name, of a subscriber in an IP-CAN session between PCEF (PDSN) and IPCF over Gx interface.
> This condition is defined for PCC functionality support to CDMA users over Gx interface.
> Example
> The following command creates a condition definition to analyze the condition based on subscriber user name as cdma2000_subs1 in an IP-CAN session between PDSN and IPCF having xyz.com as domain:
> nai = username cdma2000_subs1 domain xyz.com
> out-of-credit rulename
> This command defines a condition based on the exhaustion of credit for subscriber Rulename at PCEF in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] out-of-credit rulename operator rule_name
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> rule_name
> Specifies the name of the Rulename for which out of credit condition is to match in an IP-CAN session.
> rule_name is a pre-configured Rulename on PCEF and must be an alphanumeric string of from 1 through 63 characters.
> Usage
> Use this command to define a condition based on the exhaustion of credit for subscriber Rulename at PCEF in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on the exhaustion of credit for subscriber Rulename rule_101 at PCEF in an IP-CAN session:
> out-of-credit rulename = rule_101
> out-of-credit rulebase-name
> This command defines a condition based on the exhaustion of credit for subscriber Rulebase name at PCEF in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] out-of-credit rulebase-name operator rulebase_name
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> rulebase_name
> Specifies the name of the Rulebase for which out of credit condition is to match in an IP-CAN session.
> rulebase_name is a pre-configured Rulebase on PCEF and must be an alphanumeric string of from 1 through 63 characters.
> Usage
> Use this command to define a condition based on the exhaustion of credit for subscriber Rulebase name at PCEF in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on the exhaustion of credit for subscriber Rulebase name rulebase_101 at PCEF in an IP-CAN session:
> out-of-credit rulebase-name = rulebase_101
> pcef-address
> This command defines a condition based on the IP address of Policy and Charging Enforcement Function (PCEF) which is served by IPCF and through which subscriber is attached to an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] pcef-address {operator pcef_ip/mask | {in-range | !in-range} range_start_ip to range_end_ip}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> in-range
> Specifies the condition to accept the IP address which are in range as argument to define the PCEF address which is used by subscriber in IP-CAN session.
> !in-range
> Specifies the condition to accept the IP address which are NOT in range as argument to define the PCEF address which is used by subscriber in IP-CAN session.
> range_start_ip
> Specifies the starting IP address which is used for defining the range of PCEF IP addresses which is used by subscriber in IP-CAN session.
> range_start_ip is an IP address and must be lesser than end_start_ip address.
> range_end_ip
> Specifies the ending IP address which is used for defining the range of PCEF IP addresses which is used by subscriber in IP-CAN session.
> range_end_ip is an IP address and must be greater than end_start_ip address.
> pcef_ip/mask
> Specifies the IP address of the PCEF which is used by subscriber in IP-CAN session along with IP mask as well.
> pcef_ip must be an IP address in IPv4 or IPv6 notation.
> mask Specifies the IP address mask bits to determine the number of IP addresses of PCEF in condition. mask must be specified using the standard IPv4 dotted decimal notation.
> Usage
> Use this command to define a condition based on the PCEF IP address used by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on PCEF P address 1.2.3.4 in an IP-CAN session:
> pcef-address = 1.2.3.4
> pdn-id
> This command defines a condition based on the PDN or calling station id in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] pdn-id [case-insensitive] operator pdn_id
> no
> Removes the specified condition definition.
> case-insensitive
> This optional keyword sets the condition to not to consider the case of argument phrase for condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> • | contains: Contains

> • | !contains: Does not contain

> • | starts-with: Starts with

> • | !starts-with: Does not start with

> • | ends-with: Ends with

> • | !ends-with: Does not end with

> pdn_id
> Specifies the PDN or calling station id to be used for condition validation in an IP-CAN session.
> pdn_id must be an alphanumeric string of between 1 to 128 characters.
> Usage
> Use this command to define a condition based on the PDN or calling station id used in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on calling station id ggsn_all_102 in an IP-CAN session:
> pdn-id = ggsn_all_102
> profile-attribute
> This command defines a condition based on the matching between subscriber profile attribute value and SPR attribute value in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] profile-attribute parameter subs_prof_attr_value operator spr_attr_value
> no
> Removes the specified condition definition.
> parameter subs_prof_attr_value
> Specifies the attribute parameter value to match with SPR attribute for condition validation in an IP-CAN session.
> subs_prof_attr_value must be an alphanumeric string of from 1 through 31 characters.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> spr_attr_value
> Specifies the attribute value in SPR to match with Subscriber profile attribute for condition validation in an IP-CAN session.
> spr_attr_value must be an alphanumeric string of from 1 through 63 characters.
> Usage
> Use this command to define a condition based on the matching parameters between subscriber profile attribute and SPR attribute parameters used in an IP-CAN session and provides a generic way of specifying and triggering actions based on any of the subscriber profile attribute received from SPR interactions.
> Example
> The following command creates a condition definition to analyze the condition based on matching of subscriber profile attribute value subs_gold_102 with SPR attribute value spr_gold_102in an IP-CAN session:
> profile-attribute parameter subs_gold_102 = spr_gold_102
> radio-access-technology
> This command defines a condition based on the radio access technology used by subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] radio-access-technology operator RAT
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the media type in user traffic.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> RAT
> Specifies the radio access technology used by subscriber to access the network as condition definition for user traffic in an IP-CAN session.
> Following RAT are supported with this command:

> • | cdma2000-1x: 3GPP2 CDMA 2000 - 1x RTT

> • | eutran: Evolved Universal Terrestrial Radio Access Network (eUTRAN)

> • | gan: Generic Access Network (GAN)

> • | geran: GSM Edge Radio Access Network (GERAN)

> • | hrpd: High Rate Packet Data (CDMA 2000 1xEV-DO)

> • | hspa-evolution: Evolved High-Speed Packet Access (eHSPA/HSPA+)

> • | umb: Ultra-Mobile Broadband

> • | utran: Universal Terrestrial Radio Access Network (UTRAN)

> • | wlan: Wireless Local Area Network (WLAN/xDSL)

> Usage
> Use this command to define a condition based on the type of radio technology used for network access by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the PCC service user traffic for the radio access technology type as WLAN:
> radio-access-technology = wlan
> sgsn-ip
> This command defines a condition based on the IP address of SGSN on which subscriber is attached in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] sgsn-ip {operator sgsn_ip/mask | {in-range | !in-range} range_start_ip to range_end_ip}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> in-range
> Specifies the condition to accept the IP address which are in range as argument to define the SGSN address which is used by subscriber in IP-CAN session.
> !in-range
> Specifies the condition to accept the IP address which are NOT in range as argument to define the SGSN address which is used by subscriber in IP-CAN session.
> range_start_ip
> Specifies the starting IP address which is used for defining the range of SGSN IP addresses which is used by subscriber in IP-CAN session.
> range_start_ip is an IP address and must be lesser than end_start_ip address.
> range_end_ip
> Specifies the ending IP address which is used for defining the range of SGSN IP addresses which is used by subscriber in IP-CAN session.
> range_end_ip is an IP address and must be greater than end_start_ip address.
> sgsn_ip/mask
> Specifies the IP address of the SGSN which is used by subscriber in IP-CAN session along with IP mask as well.
> sgsn_ip must be an IP address in IPv4 or IPv6 notation.
> mask Specifies the IP address mask bits to determine the number of IP addresses of SGSN in condition. mask must be specified using the standard IPv4 dotted decimal notation.
> Usage
> Use this command to define a condition based on the SGSN IP address used by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on SGSN IP address 1.2.3.4 in an IP-CAN session:
> sgsn-ip = 1.2.3.4
> sgsn-mcc-mnc
> This command defines a condition based on the PLMN (MCC+MNC) of SGSN on which subscriber is attached in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] sgsn-mcc-mnc operator {mcc mcc_value [mnc mnc_value] | [mcc mcc_value] mnc mnc_value}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> mcc mcc_value
> Specifies the Mobile Country Code in PLMN of SGSN which is used by subscriber in IP-CAN session.
> mcc_value must be an integer between 101 and 998.
> mnc mnc_value
> Specifies the Mobile Network Code in PLMN of SGSN which is used by subscriber in IP-CAN session.
> mnc_value must be an integer between 1 and 998.
> Usage
> Use this command to define a condition based on the PLMN of SGSN used by subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on PLMN of SGSN with MCC as 102 and MNC as 99in an IP-CAN session:
> sgsn-mcc-mnc = mcc 102 mnc 99
> subscription-attribute
> This command defines a condition based on the matching between subscriber subscription attribute value and SPR attribute value in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] subscription-attribute subsription_attr_value operator spr_attr_value
> no
> Removes the specified condition definition.
> subsription_attr_value
> Specifies the subscriber subscription attribute value to match with SPR attribute for condition validation in an IP-CAN session.
> subsription_attr_value must be an alphanumeric string of from 1 through 31 characters.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> spr_attr_value
> Specifies the attribute value in SPR to match with subscriber subscription attribute for condition validation in an IP-CAN session.
> spr_attr_value must be an alphanumeric string of from 1 through 63 characters.
> Usage
> Use this command to define a condition based on the matching parameters between subscriber subscription attribute and SPR attribute value used in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on matching of subscriber subscription attribute value subs_gold_102 with SPR attribute value spr_gold_101in an IP-CAN session:
> subscription-attribute subscribe_gold_102 = spr_gold_101
> spr-profile-not-found
> This command defines a condition based on the availability of SPR profile for s subscriber in an IP-CAN session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] spr-profile-not-found
> no
> Removes the specified condition definition.
> Usage
> Use this command to define a condition based on the availability of SPR profile for a subscriber in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition if SPR profile is not available for a subscriber in an IP-CAN session:
> spr-profile-not-found
> threshold-condition usage-monitor
> This command defines a condition based on the threshold conditions in usage of traffic by subscriber session in an IP-CAN session. It is used to support usage tracking and dynamic Policy control based on subscriber usage.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] threshold-condition usage-monitor usage_mon_name usage operator {absolute value volume | subscription-limit | subscription-threshold subs_thres_limit}
> no
> Removes the specified condition definition.
> usage_mon_name
> Specifies a unique name for configured usage monitor condition which is used for evaluation with this condition group for user traffic in IP-CAN session.
> usage_mon_name must be an alphanumeric string of 1 through 63 characters.
> usage
> This keyword specifies the condition as usage for threshold condition which is used for evaluation with this condition group for user traffic in IP-CAN session.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | <=: Lesser than or equals

> • | =: Equals

> • | >=: Greater than or equals

> absolute value volume
> Specifies the threshold limit condition definition based on absolute usage volume volume in Kilo Bytes which is used for evaluation with this condition group for user traffic in IP-CAN session.
> volume must be an integer between 1 through 4294967295.
> subscription-limit
> Specifies the threshold limit condition based on Subscriber’s subscription limit which is used for evaluation with this condition group for user traffic in IP-CAN session.
> In this condition the system takes Subscriber’s subscription limit as defined in subscriber subscription policy for threshold limit monitoring.
> subscription-threshold subs_thres_limit
> Specifies the condition definition for threshold limit based on a configured usage monitor threshold named subs_thres_limit in IP-CAN session.
> subs_thres_limit is a pre-configured subscription limit in this configuration mode.
> This command allows the operator to use configured subscription limit as subset of a threshold condition.
> Usage
> Use this command to define a condition based on the duration of usage of service in seconds or volume usage in Bytes for user traffic in an IP-CAN session. This usage monitor is used to support usage tracking and dynamic Policy control based on subscriber usage.
> IPCF supports the concept of Monitoring Key. PCEF, when instructed by PCRF, keeps track of usage per Monitoring Key. PCEF reports the usage when thresholds are reached or requested by PCRF.
> To allow operator to have dynamic Policy control, IPCF uses Usage Monitor. This Usage Monitor has single attribute of volume-limit. Operator can “associate” different Monitoring Keys to these usage monitors. It can be a Many-To-Many relationship between Usage-Monitor and Monitoring-Key. Operator can use Usage conditions on Usage Monitors instead of Monitoring Keys directly.
> IPCF tracks usage per usage-monitor. Different monitoring keys associated to a Usage-Monitor. When monitoring key is associated to a Usage-Monitor, the usage reported for that particular monitoring key is added to all the usage monitoring to which it is associated.
> IPCF supports 2 types of usage monitors; it can be defined on IPCF or SSC supplied usage monitors. The name usage_mon_name identifies an usage-monitor, which is locally defined or received from SSC. The absolute value applies to both types of usage monitors.
> This command allows the operator to use configured threshold condition with another threshold condition as subset.
> A maximum of 8 thresholds can be configured per usage monitor.
> Example
> The following command creates a threshold condition with usage monitor name threshold1 as usage monitor to trigger the condition based on the subscription limit as provide in Subscriber policy:
> threshold-condition usage-monitor threshold1 usage = subscription-limit
> user-access-network
> This command defines a condition based on the access location type of the subscriber in an IP-CAN session as received on Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-access-network operator {home | roaming | visiting}
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> home
> Specifies the subscriber network access type as Home for condition validation in an IP-CAN session.
> This condition contains all subscribers active in Home networks in this condition.
> roaming
> Specifies the subscriber network access type as Roaming for condition validation in an IP-CAN session.
> This condition contains all subscribers active in Roaming networks in this condition.
> visiting
> Specifies the subscriber network access type as Visiting for condition validation in an IP-CAN session.
> This condition contains all subscribers active in Visiting networks in this condition.
> Usage
> Use this command to define a condition based on the location of the user in access type (Home/Roaming/Visiting) in an IP-CAN session as received on Gx interface.
> Example
> The following command creates a condition definition to analyze the condition based on location of the subscribes as roaming in an IP-CAN session:
> user-access-network = roaming
> user-equipment-info esn
> This command defines a condition based on the Electronic Serial Number (ESN) used for the identification of mobile device (UE) in a Non-3GPP IP-CAN session received over Gx interface between PDSN and IPCF.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info esn operator esn
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> esn
> Specifies the Electronic Serial Number used for the identification of UE in 64 bit format as condition value for UE information received over Gx interface in a Non-3GPP IP-CAN session.
> esn must be a 15 character long string of Hexadecimal numbers only.
> Usage
> Use this command to define a condition based on the ESN of the UE received over Gx interface in a Non-3GPP IP-CAN session between PDSN and IPCF.
> Example
> The following command creates a condition definition to analyze the condition based on the ESN of the UE as 1234567890120AF in a Non-3GPP IP-CAN session:
> user-equipment-info esn = 1234567890120AF
> user-equipment-info eui64
> This command defines a condition based on the Extended Unique Identifier in 64 bit (EUI-64) used for the identification of mobile device (UE) in an IP-CAN session received over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info eui64 operator eui64
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> eui64
> Specifies the Extended Unique Identifier in 64 bit format as a condition value for UE information received over Gx interface in an IP-CAN session.
> eui64 is a 16 character long string of Hexadecimal numbers only.
> Usage
> Use this command to define a condition based on the EUI-64 value of the UE received over Gx interface in an IP-CAN session between PCEF and IPCF.
> Example
> The following command creates a condition definition to analyze the condition based on the EUI-64 of the UE as 0012989099832345 in an IP-CAN session:
> user-equipment-info eui64 = 0012989099832345
> user-equipment-info imeisv
> This command defines a condition based on the International Mobile Equipment Identity Software Version (IMEI-SV) used for the identification of mobile device (UE) in an IP-CAN session received over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info imeisv operator imei_sv
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> imei_sv
> Specifies the International Mobile Equipment Identity Software Version (IMEI-SV) as a condition value for UE information received over Gx interface in an IP-CAN session.
> eui64 is a 16 digit long string of decimal numbers only.
> Usage
> Use this command to define a condition based on the IMEI-SV value of the UE received over Gx interface in an IP-CAN session between PCEF and IPCF.
> Example
> The following command creates a condition definition to analyze the condition based on the IMEI-SV of the UE as 0012989099832345 in an IP-CAN session:
> user-equipment-info eui64 = 0012989099832345
> user-equipment-info mac
> This command defines a condition based on the Media Access Control (MAC) address used for the UE information in an IP-CAN session as received over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info mac operator mac_value
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> mac_value
> Specifies the Media Access Control (MAC) address as condition value for UE information received over Gx interface in an IP-CAN session.
> mac_value is a 17 character long string of Hexadecimal numbers in xx:xx:xx:xx:xx:xx format only.
> Usage
> Use this command to define a condition based on the MAC address value as UE information received over Gx interface in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on the MAC value of the UE as 00:12:98:90:99:83 in an IP-CAN session:
> user-equipment-info mac = 00:12:98:90:99:83
> user-equipment-info meid
> This command defines a condition based on the Mobile Equipment Id (MEID) used for the identification of CDMA mobile device (UE) in a Non-3GPP IP-CAN session received over Gx interface between PDSN and IPCF.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info meid operator me_id
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> me_id
> Specifies the Mobile Equipment identifier used for the identification of UE in 64 bit format as condition value for UE information received over Gx interface in a Non-3GPP IP-CAN session.
> me_id must be a 14 character long string of Hexadecimal numbers only.
> Usage
> Use this command to define a condition based on the MEID of the CDMAUE received over Gx interface in a Non-3GPP IP-CAN session between PDSN and IPCF.
> Example
> The following command creates a condition definition to analyze the condition based on the MEID of the CDMA UE as 123456780120AF in a Non-3GPP IP-CAN session:
> user-equipment-info meid = 123456780120AF
> user-equipment-info modified-eui64
> This command defines a condition based on the modified-Extended Unique Identifier in 64 bit (EUI-64) used for the identification of mobile device (UE) in an IP-CAN session received over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-equipment-info modified-eui64 operator meui64
> no
> Removes the specified condition definition.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> meui64
> Specifies the modified Extended Unique Identifier (EUI) in 64 bit format as condition value for UE information received over Gx interface in an IP-CAN session.
> meui64 is a 16 character long string of Hexadecimal numbers only.
> Usage
> Use this command to define a condition based on the modified EUI-64 value of the UE received over Gx interface in an IP-CAN session between PCEF and IPCF.
> Example
> The following command creates a condition definition to analyze the condition based on the EUI-64 of the UE as 0012989099832345 in an IP-CAN session:
> user-equipment-info modified-eui64 = 0012989099832345
> user-location-info
> This command defines a condition based on the UE location used in an IP-CAN session as received on Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [no] user-location-info {cgi operator mcc mcc_value mnc mnc_value lac lac_value ci ci_value | ecgi operator mcc mcc_value mnc mnc_value ecgi ecgi_value | rai operator mcc mcc_value mnc mnc_value lac lac_value rai rai_value| sai operator mcc mcc_value mnc mnc_value lac lac_value sac sac_value| tai operator mcc mcc_value mnc mnc_value tai tai_value}
> no
> Removes the specified condition definition.
> cgi
> Specifies the Cell Global Identifier in UE location received over Gx interface in an IP-CAN session.
> ecgi
> Specifies the E-UTRAN Cell Global Identifier in UE location received over Gx interface in an IP-CAN session.
> rai
> Specifies the Routing Area Identifier in UE location received over Gx interface in an IP-CAN session.
> sai
> Specifies the Service Area Identifier in UE location received over Gx interface in an IP-CAN session.
> tai
> Specifies the Tracking Area Identifier in UE location received over Gx interface in an IP-CAN session.
> operator
> Specifies how to logically match the information in the analyzed field.
> operator must be one of the following:

> • | !=: Does not equal

> • | =: Equals

> mcc mcc_value
> Specifies the Mobile Country Code used in UE location information received over Gx interface in IP-CAN session.
> mcc_value must be an integer between 101 through 998.
> mnc mnc_value
> Specifies the Mobile Network Code used in UE location information received over Gx interface in IP-CAN session.
> mnc_value must be an integer between 1 through 998.
> lac lac_value
> Specifies the Location Area Code used in UE location information received over Gx interface in IP-CAN session.
> lac_value must be an integer between 1 through 65535.
> ci ci_value
> Specifies the Cell Identifier used in UE location information received over Gx interface in IP-CAN session.
> ci_value must be an integer between 1 through 65535.
> ecgi ecgi_value
> Specifies the E-UTRAN Cell Global Identifier used in UE location information received over Gx interface in IP-CAN session.
> ecgi_value must be an integer between 1 through 1048575.
> rai rai_value
> Specifies the Routing Area Identifier used in UE location information received over Gx interface in IP-CAN session.
> rai_value must be an integer between 1 through 65535.
> sac sac_value
> Specifies the Service Area Code used in UE location information received over Gx interface in IP-CAN session.
> sac_value must be an integer between 1 through 65535.
> tai tai_value
> Specifies the Tracking Area Code used in UE location information received over Gx interface in IP-CAN session.
> tai_value must be an integer between 1 through 65535.
> Usage
> Use this command to define a condition based on the UE location information received over Gx interface in an IP-CAN session.
> Example
> The following command creates a condition definition to analyze the condition based on the RAI received for UE location in an IP-CAN session:
> user-location-info rai = mcc 102 mnc 99 lac 1003 rai 3521

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883