Usage Quota Profile Properties

Usage quota profiles are used in usage quota tables that are referenced from usage quota components. Usage quota profiles contain the following properties.

Usage Quota Profile – General Properties

Usage Quota Profile General Properties lists the general properties of all usage quota profiles.

Table 1. Usage Quota Profile General Properties
Property	Description
Name	A descriptive name for the usage quota component. Usage quota component names are displayed in My MATRIXX.
Description	Information about the purpose of the usage quota component.
External ID	(Optional) Use this field to identify this item in MATRIXX pricing items. An External ID is saved to the pricing configuration file and loaded into the Pricing Database. Set the External ID value to any alphanumeric character that is meaningful to your implementation. An External ID can be used, for example, to relate offers in the MATRIXX system to products in an external pricing plan. It can be used, for example, by the Subscriber Management API to query and purchase product offers and bundle IDs.
Is Quota Adaptive?	Enables AQM functionality for quota authorizations. Only set this property for services using Session Charging with Unit Reservation (SCUR), where ongoing usage is periodically reauthorized across many CCR messages.
Adaptive Threshold Use Min Auth?	AQM uses a minimum quota value in the following circumstances: The quota velocity is unknown. The balance velocity is unknown. The balance velocity is near a balance threshold. In such cases, the minimum quota value can be the configured Minimum Authorized Quantity or the computed minimum, which equals the quota velocity × the Minimum Quota Validity Time. This property indicates which minimum value to use. When this property is selected or the quota velocity is unknown, the Minimum Authorized Quantity is used. When this property is not selected (the default) and the quota velocity is known, the greater of the two values is used. Set this property only for services using SCUR, where ongoing usage is periodically reauthorized across many CCR messages.
Adaptive Threshold Use Min Auth After Time Change	When authorizing across a time change into a new balance or meter whose consumption is velocity, this property determines the AQM behavior. When this property is selected, AQM uses the Minimum value after the time change, which might prevent authorization across the time change and increase network traffic at that time. When this property is not selected, the quota can use the default quota across the time change regardless of the velocity, even if that might cross a balance threshold. Set this property only for services using SCUR, where ongoing usage is periodically reauthorized across many CCR messages.
Use Default Auth Quantity	Select to always use the Default or Reauthorization value, even if the request message includes the amount. Otherwise the Default and Reauthorization values are used only when the request message does not include the amount.
Auth Full Beat	Indicates whether the MATRIXX Charging Application only authorized whole beats instead of partial beats during rating. When this property is selected and a partial beat amount is calculated, the amount is rounded down to the nearest whole beat. The default behavior is to disable whole beat authorization and allow partial beats.
Limit Charge to Last Authorization Quantity	Whether to charge for all usage reported by the network or to charge for only the amount of usage that was authorized. When: Selected, only the amount of usage that was authorized is charged. Not selected, the amount of usage reported is charged. This property does not apply to Immediate Event Charging (IEC).
Authorization Full Request	Sets whether rating fails when the available balance amount is less than 100% of the authorization request amount. For example, say an authorization request is for 1MB and the data balance is only 800KB. If this property is selected, 0 bytes are authorized and a CREDIT_LIMIT_REACHED message is returned to the network, so usage can be denied. If this property is not selected, the partial amount (800KB) is authorized so usage can occur.

Usage Quota Profile – Quota Settings Properties

Usage Quota Profile - Quota Settings Properties lists the quota information you can define for a usage quota profile.

Table 2. Usage Quota Profile - Quota Settings Properties
Minimum Quota Validity Time	The period of time, in seconds, that sets a minimum baseline or target validity time before rating. Rating might result in a lower value in the Validity-Time AVP based on several factors. The GGSN reauthorizes service at this time, regardless of whether the authorized amount has been used. The Charging Server might send one or more Re-Authorization Request (RAR) messages to elicit a reauthorization, after which the session might be terminated. Important: If you set this value for a service type, you must also set the Default Quota Validity Time and Maximum Quota Validity Time. If you do not set any Quota Validity Time values, the default values are used. This property does not apply to Immediate Event Charging (IEC) and is used only when the Is Quota Adaptive property is selected (`true`).
Default Quota Validity Time	The default number of seconds for which the authorized quota is valid. The GGSN must send a request at this time, regardless of whether the authorized amount has been used. Important: If you set this value for a service type, you must also set the Minimum Quota Validity Time and Maximum Quota Validity Time. If you do not set the Quota Validity Time values, the default values are used. This property does not apply to IEC.
Maximum Quota Validity Time	The maximum number of seconds for which the authorized quota is valid. Important: If you set this property for the service type, you must also set the Minimum Quota Validity Time and Default Quota Validity Time values. If you do not set the Quota Validity Time properties, the default values are used. This property does not apply to IEC.
Quota Holding Time	The period of time, in seconds, of inactivity after which the network reports usage and release the remaining quota. MATRIXX reports this amount in the response message to the network. This value must be 0 or more. This property does not apply to IEC.
Quota Threshold	The amount of unused quota under which the network sends a request to reauthorize assets, based on the current usage. When the subscriber has less than this amount remaining from the authorized quantity, the network sendd a request for additional assets. The value must be less than or equal to the Default or Reauthorization Authorized Quantity total. You can specify a Quota Threshold for each service context. If this property is specified and the value is not zero, Rating ensures that the appropriate quota threshold AVP (Time-Quota-Threshold for duration, Volume-Quota-Threshold for volume, or Unit-Quota-Threshold for service-specific) is set in the CCA message. The value set in the CCA message might be zero if the authorized quota size would be less than the configured value or if AQM is trying to reach a balance threshold exactly. Set this property only for services using SCUR, where ongoing usage is periodically reauthorized across many CCR messages.
Quota Threshold Unit	The measurement unit of the Quota Threshold, for example, bytes, or kilobytes. MATRIXX sets the Quota Threshold value in bytes for data volume rating or in seconds for duration rating, even if the Quota Threshold Unit value is a higher unit. MATRIXX then converts the unit value. For service-specific quantities, for example, SMS, there is no unit conversion of the value. Set this property only for services using SCUR, where ongoing usage is periodically reauthorized across many CCR messages.
Adaptive Threshold Scale Factor	Controls the distance before a threshold at which the quota drops from default authorization or reauthorization values to the minimum authorization or reauthorization values. This property provides a buffer if additional subscribers request quota. The value must be more than or equal to 1.0. The threshold scale factor value in the balance template overrides the service or context type value. If neither value is set, the default value (1.0) is used. Set this property only for services using SCUR, where ongoing usage is periodically reauthorized across many CCR messages.

Usage Quota Profile – Authorized Quantities Properties

Usage Quota Profile - Authorized Quantities Properties lists the authorization information you can define for a usage quota profile.

Table 3. Usage Quota Profile - Authorized Quantities Properties
Property	Description
Minimum (Minimum Authorization Quantity)	The minimum usage amount to authorize for a session. If the amount that can be authorized is less than the minimum set, nothing is authorized. When specifying a minimum amount, also select a measurement. The unit can be different from the usage quantity unit but must be of the same measurement type. For example, if a balance unit is minutes, the minimum authorization unit can be minutes or seconds but not bytes. The default is `none`. Accepted values are: `none` `seconds` `minutes` `hours` `days` `weeks` `bytes` `kbytes` `mbytes` `gbytes`
Maximum (Maximum Authorization Quantity)	The maximum usage amount to authorize. When specifying a maximum amount, also select the measurement unit. The unit can be different from the usage quantity unit but must be of the same measurement type. See the Minimum description for valid units. Note: This property applies only when AQM has been enabled.
Default (Default Authorization Quantity)	The default amount of service to try to authorize when requesting quota for the first time after starting a session or after Reporting-Reason: FINAL. This value must be more than the Minimum value if it is not set to 0. This value cannot be set to 0 if the Use default authorization flag is selected. When specifying a default amount, also select the quantity measurement unit. See the Minimum description for valid units. The default is none. Note: The default authorization only applies when requesting the use of a service. To charge for a service that has already been used, you must include the Used-Service-Unit AVP, and it must indicate the amount of service used.
Reauthorization (Default ReAuth Quantity)	The default amount of service to try to authorize when requesting quota, except for the first time after starting a session or after Reporting-Reason: FINAL. This value must be more than the Minimum value if it is not set to 0. This value cannot be set to 0 if the Use default authorization flag is selected. Set this property only for services using Session Charging with Unit Reservation (SCUR), where ongoing usage is periodically reauthorized across many CCR messages. When specifying a default reauthorization amount, also select the measurement unit. See the Minimum description for valid units. The default is none.