Home
My MATRIXX Help
Charging Configuration
Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
General Configuration
General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
Announcements
MATRIXX Engine uses announcement data for determining the list of announcements to play to a subscriber during a voice call, and the language they must be played in. Configure announcement data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
Announcement Variables
An announcement variable defines the source for a variable you want to use in announcements and the variable type. It can be based on fields in the MtxDiamRoMsg MDC, fields in custom extensions of MtxDiamRoMsg, or subscriber balances (using balance class and an optional balance template).

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
- About My MATRIXX Help
  My MATRIXX Help provides information about My MATRIXX, a web application that offers a central location for creating pricing plans and configuring MATRIXX charging and rating behaviors. My MATRIXX is intended for pricing administrators who are responsible for creating and maintaining pricing plans and for IT administrators or developers who configure the rating and charging behavior of the online charging system.
- Introducing My MATRIXX
  The following information describes the My MATRIXX interface.
- Using My MATRIXX
  You use My MATRIXX to validate and compile the pricing configuration file, compile pricing, and set up and manage user roles and domains; create and manage catalog items and catalogs, manage eligibility features and rules, and manage the Normalizers interface; create and manage balances, pricing, offers and bundles, general components, and application-related components; and policies for charging and rating. Use General Configuration to create components that support pricing items and charging functionality such as announcements pricing components, attribute definitions, denial codes, products, decision tables, Final Unit Indication (FUI) profiles and generators, general ledger transaction types, notification profiles, normalizer templates, and subscriber information query actions, profiles, and generators.
- Home Menu
  The following information describes the tasks that can be performed using the My MATRIXX Home menu.
- Catalog Configuration
  Catalog Configuration contains the Catalog Items interface that you use to create, change, or delete catalog items; the Eligibility interface to manage eligibility features and rules to determine whether a subscriber, group, or device is eligible for a catalog item; and the Normalizers interface you use to edit normalizers.
- Charging Configuration
  Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
  - Balance Configuration
    Balance Configuration contains interfaces you use to create and manage price components including aggregation selectors, balances and balance classes, balance state update profiles and components, meters, and rollover profiles and components.
  - Pricing Configuration
    Pricing Configuration contains interfaces you use to create pricing plan components. Pricing plan components managed through this interface include decision tables, finance and service contracts, filters, price components including charges, discounts, grants, refunds, and forfeitures, and rate tags.
  - Offer and Bundle Configuration
    Offer and Bundle Configuration contains interfaces you use to create and manage pricing and rating components including bundles, offer priority generators, product offers, and product service types and attributes.
  - Normalizer Configuration
    Normalizer Configuration contains interfaces you use to create and manage normalizers, normalizer templates, and normalizer value lists.
  - Tax Configuration
    Tax Configuration contains interfaces you use to create and manage tax classes and selectors, and US taxation. You must have the Manage Tax domain user role to enable this menu.
  - General Configuration
    General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
    - Announcements
      MATRIXX Engine uses announcement data for determining the list of announcements to play to a subscriber during a voice call, and the language they must be played in. Configure announcement data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
      - Announcement Servers
        An announcement pod is a catalog component that specifies the details of an Interactive Voice Response (IVR) system on which to play announcements, such as the address of the IVR, and whether it is internal or external.
      - Announcement Variables
        An announcement variable defines the source for a variable you want to use in announcements and the variable type. It can be based on fields in the MtxDiamRoMsg MDC, fields in custom extensions of MtxDiamRoMsg, or subscriber balances (using balance class and an optional balance template).
        Create an Announcement Variable
        Create an announcement variable to add it to the list of available announcement variables. You add variables to announcement details records. You can use the same announcement variable in multiple announcements.
        Delete an Announcement Variable
        Deleting an announcement variable removes it from the pricing plan. When the new pricing XML configuration file is loaded into the database, the announcement variable is removed.
        Announcement Variable Properties
        An announcement variable defines the source for a variable value that you want to use in announcements. You can specify to use either an MDC field, or a balance value.
      - Announcement Details
        Announcement details are catalog components that specify the details of an announcement to play, such as the message ID and language for the announcement, and the announcement server ID of the Interactive Voice Response (IVR) on which the announcement is played.
      - Announcement Menu Actions
        An announcement menu action specifies the service ID of an announcement menu service.
      - Announcement Prompt Collects
        An announcement prompt collect is a catalog component that defines parameters for PromptAndCollectUserInformation (PACUI) operations that can be sent in TCAP messages.
    - Attributes
      System attributes and product attributes are properties you can add to certain pricing objects that can be used to influence rating operations and provide information to downstream systems, such as General Ledger accounting systems.
    - Data Modify
      You use the data modify interface to configure data modify actions, data modify profiles, and data modify profile selectors.
    - Denial Codes
      Denial codes are a way to deny service access to subscribers for a specific reason. You define them in My MATRIXX and add them to rate table rows in place of a rating formula, so the value is returned to the network based on the row selected during rating.
    - Final Unit Indication
      You can configure Diameter Final Unit Indication (FUI) information to be static or dynamic.
    - General Ledger Info
      You can configure MATRIXX Charging Application to generate General Ledger (GL) information for inclusion in an _glossary/edr.html.
    - Grace Period Profiles
      You use grace period profiles to configure the length of purchased item cycle grace period(s) that extends the period of time before a cycle goes into a recovery state.
    - Languages
      A language definition indicates that My MATRIXX supports that language.
    - Notifications
      In Notifications you create notification profiles and notification profile selectors that determine when and to which tenants notifications are sent.
    - Object State Update Profiles
      An object state update profile specifies how to extend, limit, or adjust the date/time value of the custom MATRIXX Data Container (MDC) field of an offer owner (subscriber/group/device). Enable an object state update profile by selecting it when configuring an offer owner state update component. The decision table used in an offer owner state update component selects an object state update profile to use to update a custom field of an offer owner. An object state update profile can only be used in combination with an offer owner state update component. For more information, see the discussion about offer owner state update components.
    - Parameters
      You can configure definitions for parameters that you can use in pricing items such as catalog items, bundles, product offers, and price components.
    - PostRating
      MATRIXX Engine uses post-rating profiles and generators for determining a set of actions to apply to a message after it has been processed by rating. You configure post-rating to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - PreRating
      MATRIXX Engine uses pre-rating query data for determining when to perform a call out request for subscriber information to an external server or database. You configure pre-rating query data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - Purge Profiles
      Purge profiles allow you to define retention periods for expired product offers per _glossary/catalog_item.html, _glossary/meter.html, or _glossary/balance.html.
    - SH Repository Data
      Sh repository data profiles allow you to send information between the Policy and Charging Rules Function (PCRF) and the Subscriber Profile Repository (SPR), where MATRIXX Engine is the SPR. The PCRF and SPR communicate by sending Subscription Notification Requests (SNR) and Subscription Notification Answers (SNA) back and forth over Sp. The Sh repository data returns to the PCRF in an SNA.
    - Usage Quota
      Usage quota components are pricing items that are used for selecting usage quota profiles based on conditions that are valid during rating. The usage quota profile defines authorization and quota management settings to be applied to online charging sessions (to authorize a request for quota for a given service and context type). The usage quota component defines the criteria for choosing a usage quota profile as a set of normalized values.
    - Usage Triggers
      Usage triggers activate network changes based on product offers and subscriber profile data. You apply usage triggers to product offers, which then apply to ongoing subscriber sessions.
    - Virtual Fields
      Use virtual fields to avoid creating multiple pricing configurations if your MATRIXX environment accepts multiple rating message types, for example, messages from Diameter and 5G networks.
  - Application Configuration
    Application Configuration components are used by My MATRIXX for creating pricing plan items and are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
- Policy Configuration
  Policy configuration components are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Announcement Variables

An announcement variable defines the source for a variable you want to use in announcements and the variable type. It can be based on fields in the MtxDiamRoMsg MDC, fields in custom extensions of MtxDiamRoMsg, or subscriber balances (using balance class and an optional balance template).

You can add between one and five announcement variables to an announcement details record. Each variable is substituted for a value when the announcement is played.

Note: For menu announcements, variable values are generated through configuration. This configuration is set in the menu FTL files and stored in the ServiceInfo.VcsInfo.MenuVariableDataList field in the MtxDiamRoMsg MDC or a descendant of the MDC. When configuring menu announcement variables in My MATRIXX, you must specify this field, and the sequence index value for the required variable. Because an announcement can have up to five variables, the sequence index value must be in the range 1 to 5.