> Credit Control Configuration Mode Commands
> The Credit Control Configuration Mode is used to configure prepaid services for Diameter/RADIUS applications.
> apn-name-to-be-included
> This command configures whether the virtual or real APN name is sent in Credit Control Application (CCA) messaging.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> apn-name-to-be-included { gn | virtual }
> default apn-name-to-be-included
> default
> Configures this command with the default setting.
> Default: gn
> gn
> Sends Gn APN name in the CCA messages.
> virtual
> Sends virtual APN name, if configured in the APN Configuration Mode, in the CCA messages.
> Usage
> Use this command to configure the APN information in CCA messages. Virtual APN name can be set to be sent in CCA messages if it is configured in the APN Configuration Mode.
> Example
> The following command sets the virtual APN name to be sent in CCA message:
> apn-name-to-be-included virtual
> app-level-retransmission
> This command enables application-level retransmissions with “T” bit set.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> app-level-retransmission { set-retransmission-bit | unset-retransmission-bit }
> default app-level-retransmission
> default
> Configures this command with the default setting.
> Default: unset-retransmission-bit
> set-retransmission-bit
> Specifies to set retransmission bit.
> unset-retransmission-bit
> Specifies to unset retransmission bit.
> Usage
> Use this command to enable application-level transmission with “T” bit set.
> 'T' bit setting is done only for DIABASE protocol-based rerouting and not for application-based retransmissions. In order to identify such retransmissions, the server expects the T bit to be set at all levels (both DIABASE and application) of retransmission, which can be achieved with this CLI command.
> Example
> The following command specifies to set retransmission bit:
> app-level-retransmission set-retransmission-bit
> diameter dictionary
> This command configures the Diameter Credit Control dictionary for the Active Charging Service.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter dictionary { dcca-custom1 | dcca-custom10 | dcca-custom11 | dcca-custom12 | dcca-custom13 | dcca-custom14 | dcca-custom15 | dcca-custom16 | dcca-custom17 | dcca-custom18 | dcca-custom19 | dcca-custom2 | dcca-custom20 | dcca-custom21 | dcca-custom22 | dcca-custom23 | dcca-custom24 | dcca-custom25 | dcca-custom26 | dcca-custom27 | dcca-custom28 | dcca-custom29 | dcca-custom3 | dcca-custom30 | dcca-custom4 | dcca-custom5 | dcca-custom6 | dcca-custom7 | dcca-custom8 | dcca-custom9 | standard }
> default diameter dictionary
> default
> Configures this command with the default setting.
> Default: standard dictionary
> dcca-custom1 ... dcca-custom30
> Specifies a custom Diameter dictionary.
> standard
> Specifies the standard Diameter dictionary.
> Default: Enabled
> Usage
> Use this command to select the Diameter dictionary for Active Charging Service.
> Example
> The following command selects the standard Diameter dictionary:
> diameter dictionary standard
> diameter dynamic-rules request-quota
> This command is used to request quota immediately in the CCR sent to Gy interface when the traffic matches the dynamic rules with Online AVP enabled and received over Gx interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter dynamic-rules request-quota { on-traffic-match | on-receiving-rule }
> default diameter dynamic-rules request-quota
> default
> Configures this command with the default setting.
> Default: on-receiving-rule
> on-traffic-match
> Specifies to request quota only when there is a traffic matching the dynamic rules with Online AVP enabled.
> on-receiving-rule
> Specifies to request quota on receiving a dynamic rule with Online AVP enabled.
> Usage
> Use this command to request quota when the traffic matches the dynamic rules with Online AVP enabled.
> Example
> The following command specifies to request quota on receiving a dynamic rule with Online AVP enabled:
> diameter dynamic-rules request-quota on-receiving-rule
> diameter gsu-with-only-infinite-quota
> This command configures whether to accept/reject CCA messages that contain Granted-Service-Unit AVP with only infinite quota grants from the server.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter gsu-with-only-infinite-quota { accept-credit-control-answer | reject-credit-control-answer }
> default diameter gsu-with-only-infinite-quota
> default
> Configures this command with the default setting.
> Default: reject-credit-control-answer
> accept-credit-control-answer
> Specifies to accept the Credit-Control-Answer message.
> reject-credit-control-answer
> Specifies to reject the Credit-Control-Answer message.
> Usage
> Use this command to accept/reject CCA messages that contain Granted-Service-Unit AVP with only infinite quota grants from the server.
> Example
> The following command specifies to accept CCA with Granted-Service-Unit AVP containing only Infinite quota:
> diameter gsu-with-only-infinite-quota accept-credit-control- answer
> diameter ignore-returned-rulebase-id
> This command configures to accept/ignore rulebase ID in Rulebase-Id AVP returned by the Diameter server in CCA message.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ default | no ] diameter ignore-returned-rulebase-id
> default
> Configures this command with the default setting.
> Default: Accept
> no
> Specifies to accept the rulebase ID received from Diameter server in CCA.
> Usage
> Use this command to ignore/accept rulebase ID returned from the Diameter server in CCA.
> Example
> The following command specifies to ignore rulebase ID returned from Diameter server in CCA:
> diameter ignore-returned-rulebase-id
> diameter ignore-service-id
> This command enables to accept/ignore service ID in Service-Identifier AVP defined in the Diameter dictionaries. This command is applicable to all products that use the Gy interface.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ default | no ] diameter ignore-service-id
> default
> Configures this command with the default setting.
> Default: Accept
> no
> Specifies to accept the service ID in the Diameter dictionaries.
> Usage
> Use this command to ignore/accept service ID value in Service-Identifier AVP in the Diameter dictionaries for Gy interface implementation.
> This command can be used to disable the usage of Service-Identifier AVP for Gy interface implementation even if any of the Diameter dictionaries support Service-Identifier AVP and if this AVP should not be used for Gy interactions but instead should be present in GCDRs/eGCDRs.
> Example
> The following command specifies to ignore service ID in the Diameter dictionaries:
> diameter ignore-service-id
> diameter mscc-final-unit-action terminate
> This command enables either to terminate a PDP session immediately when the Final-Unit-Action (FUA) in a particular MSCC is set as TERMINATE and the quota is exhausted for that service, or to terminate the session after all other MSCCS (categories) have used up their available quota.
> Important: This command is available only in 10.2 and later releases.
> Product
> GGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter mscc-final-unit-action terminate { category | session { on-per-mscc-exhaustion | on-all-mscc-exhaustion } }
> default diameter mscc-final-unit-action terminate
> default
> Configures this command with the default setting.
> Default: Same as diameter mscc-final-unit-action terminate category
> diameter mscc-final-unit-action terminate category
> This is the standard behavior wherein the category is terminated if the Final-Unit-Indication AVP comes with TERMINATE for a given MSCC.
> diameter mscc-final-unit-action terminate session on-per-mscc-exhaustion
> When the FUA in a particular MSCC is set as TERMINATE and the quota is exhausted for that service, the session will be terminated immediately irrespective of the state of the other MSCCs.
> diameter mscc-final-unit-action terminate session on-all-mscc-exhaustion
> When the FUA in a particular MSCC is set as TERMINATE and the quota is exhausted for that service, the session termination will be initiated after all the other MSCCs (categories) have used up their available quota. There will no more CCR(U) messages sent requesting for quota after receiving the FUA as TERMINATE in the MSCC level.
> Usage
> Use this command to terminate a PDP session immediately when the Final-Unit-Action (FUA) in a particular MSCC is set as TERMINATE and the quota is exhausted for that service, or to terminate the session after all other MSCCS (categories) have used up their available quota.
> Example
> The following command terminates the PDP session after quota exhausts for all MSCCs when MSCC FUA is set to TERMINATE:
> diameter mscc-final-unit-action terminate session on-all-mscc-exhaustion
> diameter mscc-per-ccr-update
> This command configures sending single/multiple Multiple-Services-Credit-Control (MSCC) AVP in CCR-U messages.
> Important: This command is available only in 8.3 and later releases.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter mscc-per-ccr-update { multiple | single }
> default diameter mscc-per-ccr-update
> default
> Configures this command with the default setting.
> Default: multiple
> multiple
> Specifies sending multiple Multiple-Services-Credit-Control AVP in a single CCR-U message.
> single
> Specifies sending only one Multiple-Services-Credit-Control AVP in a CCR-U message.
> Usage
> Use this command to configure sending single/multiple Multiple-Services-Credit-Control AVP in CCR-U messages.
> Example
> The following command configures sending a single MSCC AVP in CCR-U messages:
> diameter mscc-per-ccr-update single
> diameter origin host
> This command is obsolete. See the diameter origin endpoint command.
> diameter origin endpoint
> This command configures the Diameter Credit Control Origin Endpoint.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter origin endpoint endpoint_name [ realm realm_name ]
> no diameter origin endpoint
> no
> Removes the Diameter Credit Control Origin Endpoint configuration.
> endpoint_name
> Specifies the Diameter Credit Control Origin Endpoint.
> endpoint_name must be the endpoint’s name, and an alpha and/or numeric string of 1 through 63 characters in length.
> realm realm_name
> Specifies the Diameter Credit Control Realm ID.
> realm_name must be a string of 1 through 127 characters in length.
> Usage
> Use this command to configure the Diameter Credit Control Origin Endpoint.
> The endpoint to configure should be pre-configured. For information on creating and configuring a Diameter endpoint, in the Context Configuration Mode, see the diameter endpoint command.
> Example
> The following command configures a Diameter Credit Control Origin Endpoint named test:
> diameter origin endpoint test
> diameter peer-select
> This command configures the Diameter credit control primary and secondary hosts for DCCA.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> In 8.x and earlier releases:
> diameter peer-select peer peer_name [ realm realm_name ] [ secondary-peer secondary_peer_name [ realm realm_name ] ] [ imsi-based start-value imsi_start_value end-value imsi_end_value ]
> no diameter peer-select [ imsi-based start-value imsi_start_value end-value imsi_end_value ]
> In 9.0 and later releases, for UMTS deployments:
> diameter peer-select peer peer_name [ realm realm_name ] [ secondary-peer secondary_peer_name [ realm realm_name ] ] [ imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ] ]
> no diameter peer-select [ imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ] ]
> no
> Removes previously configured Diameter credit control peer selection setting.
> peer peer_name
> Specifies the primary host name.
> peer_name must be an alpha and/or numeric string of 1 through 63 characters in length and can contain punctuation characters.
> imsi-based start-value imsi_start_value end-value imsi_end_value
> Important: This section applies only to 8.3 and earlier releases.
> Specifies peer selection based on International Mobile Subscriber Identification (IMSI) range.
> start-value imsi_start_value specifies the start of range in integer value of IMSI, and end-value imsi_end_value specifies the end of range in integer value of IMSI.
> imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ]
> Important: This section applies only to 9.0 and later releases for UMTS deployments.
> Specifies peer selection based on IMSI prefix or suffix or IMSI range.
> prefix: Specifies the prefix range
> suffix: Specifies the suffix range
> imsi/prefix/suffix_start_value: Specifies the IMSI/prefix/suffix start value. prefix/suffix must be IMSI prefix/suffix, and must be an integer from 1 through 15 characters in length.
> imsi/prefix/suffix_end_value: Specifies the IMSI/prefix/suffix end value. prefix/suffix must be IMSI prefix/suffix, and must be an integer from 1 through 15 characters in length, and must be greater than the start value.
> Important: If prefix/suffix is used, the lengths of both start and end prefix/suffix must be equal. If the prefix or suffix keyword is not specified, it will be considered as suffix.
> realm realm_name
> The realm_name must be an alpha and/or numeric string of 1 through 127 characters in length, and can contain punctuation characters. The realm may typically be a company or service name.
> secondary-peer secondary_peer_name
> Specifies a name for the secondary host to be used for failover processing. When the route-table does not find an AVAILABLE route, the secondary host performs a failover processing if the diameter session failover command is set.
> secondary_peer_name must be an alpha and/or numeric string of 1 through 63 characters in length, and can contain punctuation characters.
> Usage
> Use this command to configure Diameter credit control host selection.
> If the diameter peer-select command is not configured, and if multiple peers are configured in the endpoint, the available peers configured in the endpoint are automatically chosen in a load-balanced round-robin manner.
> StarOS 9.0 and later releases support peer selection using prefix or suffix of IMSI or IMSI range. Subscribers are now assigned to a primary OCS instance based on the value of the IMSI prefix or suffix of a length of 1 to 15 digits. If the prefix or suffix keyword is not specified, it will be considered as suffix. Up to 64 peer selects can be configured. At a time either prefix or suffix mode can be used in one DCCA config. If prefix or suffix mode is used, the lengths of all prefix/suffix must be equal.
> Each primary OCS may have a designated secondary OCS in case of failure of the primary. It will be the responsibility of the GGSN to use the appropriate secondary OCS in case of primary failure. The secondary OCS for each primary OCS will be one of the existing set of OCSs.
> Example
> The following command configures a Diameter credit control peer named test and the realm companyx:
> diameter peer-select peer test realm companyx
> The following command configures IMSI-based Diameter credit control peer selection in the IMSI range of 1234567890 to 1234567899:
> diameter peer-select peer star imsi-based start-value 1234567890 end-value 1234567899
> The following command configures IMSI-based DCCA peer selection with IMSI suffix of 100 through 200:
> diameter peer-select peer test_peer realm test_realm secondary-peer test_sec_realm realm test_realm2 imsi-based suffix 100 to 200
> diameter pending-timeout
> This command configures the maximum time period to wait for response from a Diameter peer.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter pending-timeout duration
> default diameter pending-timeout
> default
> Disables DCCA resending message at pending-timeout.
> duration
> Specifies the timeout duration in seconds.
> duration must be an integer from 1 through 300.
> after-expiry-try-secondary-host
> This keyword is deprecated. This can now be managed using the retry-after-tx-expiry and go-offline-after-tx-expiry keywords in the failure-handling command.
> Usage
> Use this command to set the maximum time for Diameter credit control to receive a response from its peer.
> DCCA refers to this as the Tx Timer. Typically, this should be configured to a value smaller than the response-timeout value of Diameter Endpoint Configuration Mode. That value is typically too large for DCCA's purposes.
> If DCCA gets a “no available routes” error before pending-timeout expires, then DCCA tries to send to the secondary host (if one has been configured). If DCCA gets no response and pending-timeout expires, then DCCA either tries the secondary host or gives up. This can now be managed using the failure-handling command.
> If routing has failed, i.e., the attempt to the primary host, as well as, the attempt to the secondary host (if that has been configured), then the processing configured by the failure-handling CLI command is performed.
> The routing (i.e., returning a good response, no response or an error response such as "no available routes") is controlled by Diameter Endpoint Configuration Mode. That uses a watchdog timer (called Tw Timer) to attempt a different route to a host. Multiple routes could be attempted. If there's no response before the endpoint's configured response-timeout expires, then "no available routes" is the routing result. The routing logic remembers the status of routes, so it can return "no available routes" immediately, without using any timers.
> The default case will disable DCCA resending message at Tx (pending-timeout). So messages are retried only at Tw (device watchdog timeout) by diabase or at response-timeout by DCCA.
> Example
> The following command configures a Diameter Credit Control Pending Timeout setting of 20 seconds:
> diameter pending-timeout 20
> diameter result-code
> This command enables sending GTP Create-PDP-Context-Rsp message with cause code based on the DCCA result code.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter result-code { authorization-rejected | user-unknown } use-gtp-cause-code { authentication-failure | no-resource-available }
> default diameter result-code { authorization-rejected | user-unknown } use-gtp-cause-code
> default
> Configures this command with the default setting.
> In 12.1 and earlier releases: no-resource-available
> authorization-rejected
> Result code received as DIAMETER_AUTHORIZATION_REJECTED(5003).
> user-unknown
> Result code received as DIAMETER_USER_UNKNOWN(5030).
> use-gtp-cause-code
> Cause code to be sent in GTP response.
> authentication-failure
> To send GTP cause code GTP_USER_AUTHENTICATION_FAILED in GTP response.
> no-resource-available
> To send GTP cause code GTP_NO_RESOURCES_AVAILABLE in GTP response.
> Usage
> On receiving result-code as AUTHORIZATION-REJECTED or USER_UNKNOWN from DCCA server, based on this CLI configuration, in GTP Create-PDP-Context Response message the cause code can either be sent as GTP_NO_RESOURCE_AVAILABLE or GTP_AUTHENTICATION_FAILED.
> Example
> The following command sets the deny cause as user authentication failure when the CCA-Initial has the result code DIAMETER_AUTHORIZATION_REJECTED(5003):
> diameter result-code authorization-rejected use-gtp-cause-code authentication-failure
> diameter send-ccri
> This command configures when to send CCR-Initial for the subscriber session.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter send-ccri { session-start | traffic-start }
> default diameter send-ccri
> default
> Configures this command with the default setting.
> Default: session-start
> session-start
> Specifies to send CCR-I when the PDP context is being established (on receiving Create-PDP-Context-Request).
> traffic-start
> Specifies to delay sending CCR-I until the first data packet received from the subscriber.
> Usage
> Use this command to configure when to send CCR-Initial for the subscriber session.
> Example
> The following command configures to send CCR-I on traffic detection and not on context creation:
> diameter send-ccri traffic-start
> diameter service-context-id
> This command configures the value to be sent in the Service-Context-Id AVP, which identifies the context in which DCCA is used.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter service-context-id service_context_id
> default diameter service-context-id
> default
> Configures this command with the default setting. Currently, the default value is encoded based on the dictionary wherever applicable; when not applicable, it is not encoded.
> service_context_id
> Specifies the service context.
> service_context_id must be an alpha and/or numeric string of 1 through 63 characters in length and can contain punctuation characters.
> Usage
> If Service-Context-Id is applicable and configured using this command, it will be sent in the AVP Service-Context-Id in the Diameter CCR message.
> Example
> The following command specifies the value version@customer.com is to be sent in the Service-Context-Id AVP in the Diameter CCR message:
> diameter service-context-id version@customer.com
> diameter session failover
> This command enables/disables Diameter Credit Control Session Failover. When enabled, the secondary peer is used in the event the main peer is unreachable.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ default | no ] diameter session failover
> default
> Configures this command with the default setting.
> Default: Depends on the failure-handling configuration
> no
> If the primary server is not reachable, failover is not triggered and the session is torn down. No failover action is taken.
> Usage
> Use this command to enable/disable Diameter Credit Control Session Failover.
> The failure-handling configuration comes into effect only if diameter session failover is present in the configuration. The failover can be overridden by the server in the response message, and it takes precedence.
> Example
> The following command enables Diameter Credit Control Session Failover:
> diameter session failover
> diameter update-dictionary-avps
> This command enables dictionary control of the AVPs that need to be added based on the version of the specification to which the OCS is compliant with. This CLI command is applicable to all products that use the dcca-custom8 dictionary for Gy interface implementation.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> diameter update-dictionary-avps { 3gpp-rel8 | 3gpp-rel9 }
> [ default | no ] diameter update-dictionary-avps
> default | no
> Configures this command with the default setting.
> Default: Compliant with the oldest release (Rel. 7) and send only Rel. 7 AVPs
> 3gpp-rel8
> Specifies to select the 3GPP Rel. 8 AVPs for encoding.
> 3gpp-rel9
> Specifies to select the 3GPP Rel. 9 AVPs for encoding.
> Usage
> Important: This CLI command is applicable ONLY to the dcca-custom8 dictionary. If, for any dictionary other than dcca-custom8, this command is configured with a value other than the default, configuration errors will be indicated in the output of the show configuration errors section active-charging CLI command.
> Use this command to encode the AVPs in the dictionary based on the release version of the specification to which the OCS is compliant with.
> Example
> The following command enables encoding of AVPs in the dictionary based on 3GPP Rel. 9:
> diameter update-dictionary-avps 3gpp-rel9
> end
> Returns the CLI prompt to the Exec Mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> end
> Usage
> Use this command to change to the Exec mode.
> exit
> Exits the current mode and returns to the ACS Configuration Mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> exit
> Usage
> Use this command to return to the ACS Configuration Mode.
> failure-handling
> This command configures the Diameter Credit Control Failure Handling (CCFH) behavior in the event of communication failure with the prepaid server.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> failure-handling { initial-request | terminate-request | update-request } { continue [ go-offline-after-tx-expiry | retry-after-tx-expiry ] | retry-and-terminate [ retry-after-tx-expiry ] | terminate }
> default failure-handling [ initial-request | terminate-request | update-request ]
> default failure-handling [ initial-request | terminate-request | update-request ]
> Configures the default CCFH setting.
> initial-request: The default setting is terminate.
> update-request: The default setting is retry-and-terminate.
> terminate-request: The default setting is retry-and-terminate.
> initial-request
> Specifies the message type as CCR-Initial.
> terminate-request
> Specifies the message type as CCR-Terminate.
> update-request
> Specifies the message type as CCR-Update.
> continue
> Specifies the CCFH setting as continue. The online session is converted into offline session. The associated PDP Context is established (new sessions) or not released (ongoing sessions).
> retry-and-terminate
> Specifies the CCFH setting as retry-and-terminate. The user session will continue for the duration of one retry attempt with the prepaid server. In case there is no response from both primary and secondary servers the session is torn down.
> terminate
> Specifies the CCFH setting as terminate. All type of sessions (initial or update) are terminated in case of failure.
> go-offline-after-tx-expiry
> Specifies to start offline charging after Tx expiry.
> retry-after-tx-expiry
> Specifies to retry after Tx expiry. Enables secondary-host, if up, to take over after Tx expiry.
> Usage
> Use this command to select the CCFH behavior. The specified behavior is used for sessions when no behavior is specified by the prepaid server. By default, the CCFH is taken care at response-timeout except for terminate setting.
> If the Credit-Control-Failure-Handling AVP is received from the server, the received setting will be applied to all the message types.
> The following table indicates the CCFH behavior for the combination of different CCFH settings, and the corresponding CLI commands.

> CCFH Setting | CLI Command | Behavior at Tx | Behavior at RT | Secondary is Up | Secondary is Down
> Initial-request Message Type
> Continue | initial-request continue | N/A | Continue | Secondary takes over after RT | Offline after another RT. No more quota requests are performed for any rating group within the session after DCCA failure (even if connectivity to DCCA is restored)
> | initial-request continue go-offline-after-tx-expiry | Offline | N/A | Offline at Tx | Offline at Tx
> | initial-request continue retry-after-tx-expiry | Continue | N/A | Secondary takes over after Tx | Offline after another Tx
> Retry-and-terminate | initial-request retry-and-terminate | N/A | Retry | Secondary takes over after RT | Terminate after another RT
> | initial-request retry-and-terminate retry-after-tx-expiry | Retry | N/A | Secondary takes over after Tx | Terminate after another Tx
> Terminate | initial-request terminate | Terminate | N/A | Terminate after Tx | Terminate after Tx
> Update-request Message Type
> Continue | update-request continue | N/A | Continue | Secondary takes over after RT | Offline after another RT
> | update-request continue go-offline-after-tx-expiry | Offline | N/A | Offline at Tx | Offline at Tx
> | update-request continue retry-after-tx-expiry | Continue | N/A | Secondary takes over after Tx | Offline after another Tx
> Retry-and-terminate | update-request retry-and-terminate | N/A | Retry | Secondary takes over after RT | Sends CCR-T after another RT
> | update-request retry-and-terminate retry-after-tx-expiry | Retry | N/A | Secondary takes over after Tx | Sends CCR-T after another Tx
> Terminate | update-request terminate | Terminate | N/A | Sends CCR-T after Tx | Sends CCR-T after Tx
> Terminate-request Message Type
> Continue | terminate-request continue | N/A | Retry | CCR-T is sent to secondary after RT | Terminate after another RT
> | terminate-request continue go-offline-after-tx-expiry | Retry | N/A | CCR-T is sent to secondary after Tx | Terminate after another Tx
> | terminate-request continue retry-after-tx-expiry | Retry | N/A | CCR-T is sent to secondary after Tx | Terminate after another Tx
> Retry-and-terminate | terminate-request retry-and-terminate | N/A | Retry | CCR-T is sent to secondary after RT | Terminate after another RT
> | terminate-request retry-and-terminate retry-after-tx-expiry | Retry | N/A | CCR-T is sent to secondary after Tx | Terminate after another Tx
> Terminate | terminate-request terminate | Terminate | N/A | Terminate after Tx | Terminate after Tx

> ‌
> Example
> The following command sets the Credit Control Failure Handling behavior for initial request message type to retry-and-terminate:
> failure-handling initial-request retry-and-terminate
> mode
> This command configures the Prepaid Credit Control mode to RADIUS or Diameter.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> mode { diameter | radius }
> default mode
> default
> Configures the default prepaid credit control mode.
> Default: diameter
> diameter
> Enables Diameter Credit Control Application (DCCA) for prepaid charging.
> radius
> Enables RADIUS Credit Control for prepaid charging.
> Usage
> Use this command to configure the prepaid charging application mode between Diameter or RADIUS credit control.
> Example
> The following command specifies to use RADIUS prepaid credit control application:
> mode radius
> pending-traffic-treatment
> This command controls the pass/drop treatment of traffic while waiting for definitive credit information from the server.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> pending-traffic-treatment { { { forced-reauth | trigger | validity-expired } drop | pass } | { { noquota | quota-exhausted } buffer | drop | limited-pass volume | pass } }
> default pending-traffic-treatment { forced-reauth | noquota | quota-exhausted | trigger | validity-expired }
> default
> Configures this command with the default setting.
> Default: drop
> forced-reauth
> Sets the Diameter credit control pending traffic treatment to forced reauthorization.
> trigger
> Sets the Diameter credit control pending traffic treatment to trigger.
> validity-expired
> Sets the Diameter credit control pending traffic treatment to validity expired.
> noquota
> Sets the Diameter credit control pending traffic treatment to no quota.
> quota-exhausted
> Sets the Diameter credit control pending traffic treatment to quota exhausted.
> buffer
> Specifies to tentatively count/time traffic, and then buffer traffic pending arrival of quota. Buffered traffic will be forwarded and fully charged against the quota when the quota is eventually obtained and the traffic is passed.
> drop
> Specifies to drop any traffic when there is no quota present.
> limited-pass volume
> Specifies to enable limited access for subscribers when the OCS is unreachable.
> volume specifies the Default Quota size, in bytes, and must be an integer from 1 through 4294967295.
> This feature allows the subscriber to use the network when the OCS response is slow. This configuration enables to set a Default Quota size from which the subscriber can consume quota until response from the OCS arrives. The traffic consumed by the subscriber from the Default Quota at the beginning of the session is reported and counted against the quota assigned from the OCS.
> Default Quota is not used for subsequent credit requests.
> In case the Default Quota is NOT exhausted before the OCS responds with quota, traffic is allowed to pass. Initial Default Quota usage is counted against initial quota allocated. If quota allocated is less than the actual usage then actual usage and request additional quota are reported. If no additional quota is available then traffic is denied.
> In case the Default Quota is NOT exhausted before the OCS responds with denial of quota, traffic is blocked after the OCS response. The gateway will report usage on Default Quota even in this case in CCR-U (FINAL) or CCR-T until the OCS responds.
> In case the Default Quota is exhausted before the OCS responds, the session is dropped.
> The default pending-traffic-treatment for noquota is drop. The default pending-traffic-treatment noquota command removes any Default Quota limit configured.
> pass
> Specifies to pass all traffic more or less regardless of quota state.
> Usage
> Use this command to set the Diameter credit control pending traffic treatment while waiting for definitive credit information from the server.
> This CLI command is different than the failure-handling CLI command, which specifies behavior in the face of an actual timeout or error, as opposed to the behavior while waiting. See also the buffering-limit CLI command in Active Charging Service Configuration Mode.
> Example
> The following command sets the Diameter credit control pending traffic treatment to drop any traffic when there is no quota present:
> pending-traffic-treatment noquota drop
> quota
> This command is used to set various time-based quotas in the prepaid credit control service.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> { default | no } quota { holding-time | validity-time }
> holding-time holding_time
> Specifies the Quota Holding Time (QHT).
> holding_time must be an integer from 1 through 4000000000.
> validity-time validity_time
> Specifies the validity lifetime of the quota.
> validity_time must be an integer from 1 through 65535.
> Usage
> Use this command to set the prepaid credit control quotas.
> Example
> The following command sets the prepaid credit control request holding time to 30000 seconds:
> quota holding-time 30000
> quota request-trigger
> This command configures the action on the packet that triggers the credit control application to request quota.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> quota request-trigger { exclude-packet-causing-trigger | include-packet-causing-trigger }
> { default | no } quota request-trigger
> default quota request-trigger
> Configures this command with the default setting.
> Default: include-packet-causing-trigger
> no
> Same as the default quota request-trigger command.
> exclude-packet-causing-trigger
> Specifies to exclude the packet causing threshold limit violation trigger.
> include-packet-causing-trigger
> Specifies to include the packet causing threshold limit violation trigger.
> Usage
> Use this command to configure action on the packet that triggers the credit control application to request quota, whether the packet should be excluded/included in the utilization information within the quota request.
> Example
> The following command sets the system to exclude the packets causing threshold limit triggers from accounting of prepaid credit of a subscriber:
> quota request-trigger exclude-packet-causing-trigger
> quota time-threshold
> This command configures the time threshold limit for subscriber quota in the prepaid credit control service.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> quota time-threshold { abs_time_value | percent percent_value }
> { default | no } quota time-threshold
> default
> Configures this command with the default setting.
> Default: Disabled
> no
> Disables time threshold for prepaid credit control quota.
> abs_time_value
> Specifies the absolute threshold time in seconds for configured time quota in prepaid credit control charging.
> abs_time_value must be an integer from 1 through 86400. To disable this assign 0.
> Default: 0 (Disabled)
> percent percent_value
> Specifies the time threshold value in percentage of configured time quota in DCCA.
> percent_value must be an integer from 1 through 100.
> Usage
> Use this command to set the time threshold for prepaid credit control quotas.
> Example
> The following command sets the prepaid credit control time threshold to 400 seconds:
> quota time-threshold 400
> quota units-threshold
> This command is used to set the unit threshold limit for subscriber quota in the prepaid credit control service.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> quota unit-threshold { abs_unit_value | percent percent_value }
> { default | no } quota units-threshold
> default
> Configures this command with the default setting.
> Default: Disabled
> no
> Disables unit threshold for DCCA quota.
> abs_unit_value
> Specifies the absolute threshold value in units for the configured units quota in prepaid credit control application.
> abs_unit_value must be an integer from 1 through 4000000000. To disable this assign 0.
> Default: 0 (Disabled)
> percent percent_value
> Specifies the time threshold value in percentage of configured units quota in DCCA.
> percent_value must be an integer from 1 through 100.
> Usage
> Use this command to set the units threshold for prepaid credit control quotas.
> Example
> The following command sets the prepaid credit control time threshold to 160400 units:
> quota units-threshold 160400
> quota volume-threshold
> This command is used to set the volume threshold limit for subscriber quota in the prepaid credit control service.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> quota volume-threshold { abs_vol_value | percent percent_value }
> { default | no } quota volume-threshold
> default
> Configures this command with the default setting.
> Default: Disabled
> no
> Disables volume threshold for prepaid credit control quota.
> abs_vol_value
> Specifies the absolute threshold volume in bytes to configured volume quota in prepaid credit control.
> abs_vol_value must be an integer from 1 through 4000000000. To disable this assign 0.
> Default: 0 (Disabled)
> percent percent_value
> Specifies the volume threshold value in percentage of configured volume quota in prepaid credit control.
> percent_value must be an integer from 1 through 100.
> Usage
> Use this command to set the volume threshold for prepaid credit control quotas.
> Example
> The following command sets the prepaid credit control volume threshold to 160400 bytes:
> quota volume-threshold 160400
> radius usage-reporting-algorithm
> This command configures the usage reporting algorithm for RADIUS prepaid using DCCA.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> radius usage-reporting-algorithm { cumulative | relative }
> default radius usage-reporting-algorithm
> default
> Configures this command with the default setting.
> Default: cumulative
> cumulative
> Specifies that the total accumulated usage of quota be reported in every accounting interim.
> relative
> Specifies that the quota usage be reported per accounting interim, i.e. since the previous usage report.
> Usage
> Use this command to configure the usage reporting algorithm for RADIUS prepaid using DCCA.
> Example
> The following command configures the usage reporting algorithm for RADIUS prepaid using DCCA to relative:
> radius usage-reporting-algorithm relative
> redirect-indicator-received
> This command configures the action on buffered packet when redirect-indicator is received from the RADIUS server.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> redirect-indicator-received { discard-buffered-packet | reprocess-buffered-packet }
> { default | no } redirect-indicator-received
> default
> Configures this command with the default setting.
> Default: discard-buffered-packet
> no
> Disables the redirect-indicator-received configuration.
> discard-buffered-packet
> Specifies to discard the buffered packet.
> reprocess-buffered-packet
> Specifies to redirect the buffered packet on receiving a redirect-indicator from the RADIUS server.
> Usage
> Use this command to configure the action taken on buffered packet when redirect-indicator is received.
> Diameter can return a redirect URL but not a redirect indicator, however RADIUS can return a redirect indicator. In this situation, any subsequent subscriber traffic would match ruledefs configured with cca redirect-indicator, and charging actions that have flow action redirect-url should be configured. However, some handsets do not retransmit, so there will be no subsequent packets. On configuring reprocess-buffered-packet, the ruledefs are reexamined to find a new charging action, which may have flow action redirect-url configured.
> Example
> The following command configures the action taken on buffered packet when redirect-indicator is received to reprocess-buffered-packet:
> redirect-indicator-received reprocess-buffered-packet
> servers-unreachable
> This command configures whether to continue/terminate calls when Diameter server(s)/OCS become unreachable.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> In 12.1 and earlier releases:
> servers-unreachable { initial-request { continue | terminate [ after-timer-expiry timeout_period ] } | update-request { continue | terminate [ after-quota-expiry | after-timer-expiry timeout_period ] } }
> no servers-unreachable { initial-request | update-request }
> no
> Deletes the current servers-unreachable configuration.
> initial-request { continue | terminate [ after-timer-expiry timeout_period ] }
> Important: This section applies only to 12.1 and earlier releases.
> Specifies behavior when Diameter server(s)/OCS become unreachable during initial session establishment.

> • | continue: Specifies to continue call if Diameter server(s) becomes unreachable.

> • | terminate [ after-timer-expiry timeout_period ]: Specifies to terminate call if Diameter server(s) becomes unreachable.

> after-timer-expiry timeout_period: Specifies to terminate call after timeout period expires.
> timeout_period specifies the timeout period, in seconds, and must be an integer from 1 through 4294967295.
> update-request { continue | terminate [ after-quota-expiry | after-timer-expiry timeout_period ] }
> Important: This section applies only to 12.1 and earlier releases.
> Specifies behavior when Diameter server(s)/OCS become unreachable during mid session.

> • | continue: Specifies to continue call if Diameter server(s) becomes unreachable.

> • | terminate [ after-quota-expiry | after-timer-expiry timeout_period ]: Specifies to terminate call if Diameter server(s) becomes unreachable.

> • | after-quota-expiry: Specifies to terminate call on exhaustion of all available quota.

> • | after-timer-expiry timeout_period: Specifies to terminate call after timeout period expires.

> timeout_period specifies the timeout period, in seconds, and must be an integer from 1 through 4294967295.
> Usage
> Use this command to configure whether to continue/terminate calls when Diameter server(s)/OCS are unreachable. This command can be used to verify the functionality of the configurable action if the OCS becomes unreachable.
> In 12.1 and earlier releases, the OCS is considered down/unreachable when all transport/TCP connections are down for that OCS.
> The following set of actions are performed if the servers become unreachable:

> • | During initial session establishment:

> • | Block traffic: Terminate the session.

> • | Continue call: Continue by making the session offline.

> • | Pass traffic until timer expiration post which terminates the call: Session would be offline while the timer is running.

> • | During mid session:

> • | Block traffic: Terminate the session.

> • | Continue call: Continue by making the session offline.

> • | Run out of session quota post which terminates the call.

> • | Pass traffic until timer expiration post which terminates the call: Session would be offline while the timer is running.

> This command works on the same lines as the failure-handling command, which is very generic for each of the xxx-request and applies for CCFH handling during:

> 1. | Application-level (Tx) timeout: Here message is sent out but server does not respond for the configured “pending-timeout” so application does CCFH actions.

> 2. | Diabase-level request timeout: Here message is sent out but server does not respond and Diabase detects timeout of the application message and application does CCFH actions.

> 3. | TCP connection error: Here message is NOT sent out due to no TCP connection and application does CCFH actions.

> This CLI command is specifically for TCP connection error. The administrator can configure both of the following commands:
> failure-handling initial-request continue
> servers-unreachable initial-request terminate after-timer-expiry 30
> For conditions 1 and 2 described above, the failure-handling command will be applied, whereas for condition 3 both failure-handling and/or servers-unreachable commands can be used. This way, the operator has the flexibility to configure CCFH independent of OCS-unreachable feature, that is have two different failure handlings for same request types (as illustrated in the example above.)
> If server returns the CC-Failure-Handling AVP, it would apply for conditions 1 and 2 described above. It would also apply for condition 3 if the servers-unreachable CLI is not configured. But, if configured it would take the highest precedence for all Diabase errors scenarios.
> Example
> The following command configures to terminate initial request calls if Diameter servers/OCS becomes unreachable after a timeout period of 1111 seconds:
> servers-unreachable initial-request terminate after-timer-expiry 1111
> timestamp-rounding
> This command configures how to convert exact time into the units that are used in quotas.
> Product
> ACS
> Privilege
> Security Administrator, Administrator
> Syntax
> timestamp-rounding { ceiling | floor | roundoff }
> default timestamp-rounding
> default
> Configures the default timestamp-rounding setting.
> Default: roundoff
> ceiling
> This keyword round-off to the smallest integer greater than the fraction.
> If the fractional part of the seconds is greater than 0, then this keyword adds 1 to the number of seconds and discard the fraction.
> floor
> This keyword always discards the fractional part of the second.
> roundoff
> This keyword sets the fractional part of the seconds to nearest integer value. If fractional value is greater than or equal to 0.5 it adds 1 to the number of seconds and discards the fractional part of second.
> Usage
> Use this command to configure how to convert exact time into the units that are used in quotas for CCA charging.
> The specified rounding will be performed before system attempts any calculation. For example using round-off, if the start time is 1.4, and the end time is 1.6, then the calculated duration will be 1 (i.e., 2 – 1 = 1).
> Example
> The following command sets the CCA timestamp to nearest integer value second; i.e. 34:12.23 to 34:12.00:
> timestamp-rounding roundoff
> trigger type
> This command enables or disables triggering a credit reauthorization when the named values in the subscriber session changes.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ no ] trigger type { cellid | lac | qos | rat | serving-node | sgsn } +
> default trigger type
> default
> Configures this command with the default setting.
> Default: No triggers.
> no
> Removes the previously configured trigger type.
> cellid
> Sets the trigger based on change in cell identity or Service Area Code (SAC).
> lac
> Sets the trigger based on change in Location Area Code.
> qos
> Sets the trigger based on change in the Quality of Service (QoS).
> rat
> Sets the trigger based on change in the Radio Access Technology (RAT).
> serving-node
> Sets the trigger based on change in serving node. The serving node change causes the credit control client to ask for a re-authorization of the associated quota.
> Typically used as an extension to sgsn trigger in P-GW, however, may also be used alone.
> sgsn
> Sets the trigger based on change in the IP address of SGSN.
> +
> Indicates that more than one of the previous keywords can be entered within a single command.
> Usage
> Use this command to set the credit control reauthorization trigger.
> Example
> The following command selects a credit control trigger as lac:
> trigger type lac
> usage-reporting
> This command configures the ACS Credit Control usage reporting type.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> usage-reporting quotas-to-report based-on-grant { report-only-granted-volume }
> default usage-reporting quotas-to-report
> default
> Configures this command with the default setting.
> Default: Disabled
> report-only-granted-volume
> This keyword is used to suppress the input and output octets. If the GSU comes with CC-Total-Octets, then the device will send total, input and output octets in USU. If it comes with Total-Octets, the device will send only Total-Octets in USU.
> Usage
> Use this command to configure reporting usage only for granted quota. On issuing this command, the Used-Service-Unit AVP will report quotas based on grant i.e, only the quotas present in the Granted-Service-Unit AVP.
> With this command only the units for which the quota was granted by the DCCA server will be reported irrespective of the reporting reason.
> Example
> The following command configures to report usage based only on granted quota:
> usage-reporting quotas-to-report based-on-grant

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