Home
MATRIXX Pricing and Rating
Appendices
Pricing Utilities
Use the utilities in this section to retrieve information about pricing, load pricing, and convert pricing files.
convert_price_plan.jar
Use the convert_pricing_plan.jar command line utility to validate the schema of a pricing XML configuration file against a running MATRIXX Engine. It can also be used to convert an input pricing file into compact MDC, XML, or Stacked Data Container (SDC) format.

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
- About Pricing and Rating
  MATRIXX Pricing and Rating provides an introduction to MATRIXX pricing and rating functionality and describes how to define the catalog components necessary for rating and policy selection. It also provides an overview of the MATRIXX rating process and an introduction to My MATRIXX, a web-based user interface application you use to create and manage product catalogs.
- Rating
  The following information describes MATRIXX Charging Application rating functionality.
- Pricing
- Appendices
  - Diameter Result Codes
    Diameter results codes are carried in a response message from Diameter Gateway to the network. Result codes are also written to the transaction log.
  - ISO Currency Codes
    The ISO currency codes listed in pricing/iso_currency_codes2015.html#reference_6D8EB3710A90439088805EF2603D765E5__table_37079E6CF5E9451FBB69CE64A31758D1 were last updated by ISO on 01 January 2015. Other codes may have been added since then. Check the ISO (International Organization for Standardization) website for the official list.
  - Pricing Validation Error Codes
    The following errors can be displayed during pricing validation.
  - Pricing Utilities
    Use the utilities in this section to retrieve information about pricing, load pricing, and convert pricing files.
    - convert_price_plan.jar
      Use the convert_pricing_plan.jar command line utility to validate the schema of a pricing XML configuration file against a running MATRIXX Engine. It can also be used to convert an input pricing file into compact MDC, XML, or Stacked Data Container (SDC) format.
    - diff_pricing.py
      Use the diff_pricing.py script to display the differences between two specified pricing ZIP files.
    - get_pricing.py
      Use the get_pricing.py script to compile a pricing plan into a version that can be loaded into the engine.
    - load_pricing.py
      Use the load_pricing.py script to load a pricing configuration file into the pricing database.
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

convert_price_plan.jar

Use the convert_pricing_plan.jar command line utility to validate the schema of a pricing XML configuration file against a running MATRIXX Engine. It can also be used to convert an input pricing file into compact MDC, XML, or Stacked Data Container (SDC) format.

Note: Custom MDCs are defined in the /opt/mtx/conf/mdc_config_custom.xml file.

Syntax

java -jar convert_price_plan.jar [-h] [-v] [-address:ipAddress -port:port] mtxPricingFile [--validate-pricing] [--write-txt:txtFilename] [--write-sdc:sdcFilename] [--write-xml:xmlFilename]

Options

-h: Prints help information for this utility.
-v: Runs the utility in verbose mode and prints additional information during processing.
-address:ipAddress -port:portNumber: The IP address and port number of a running MATRIXX Engine or Gateway Proxy from which to retrieve the MATRIXX Engine schema definitions during validation.
-custom:filename: Specify an XML file containing extension MDCs. If custom MDCs are not defined in /opt/mtx/conf/mdc_config_custom.xml, specifying the file prevents errors during price plan loading.
--validate-pricing: Validates the specified pricing configuration file against the MATRIXX Engine schema.
--write-txt:txtFilename: Converts the specified XML or SDC input file to a compact MDC file.
--write-sdc:sdcFilename: Converts the specified XML or TXT input file to an SDC file, which is used internally by the load_pricing.py utility. Customers should never need to convert a pricing file to this format.
--write-xml:xmlFilename: Converts the specified SDC or TXT input file to an element-based xml file. Customers might need to convert an SDC file to this format to revert back to an mtx_pricing.xml file that was wrongly deleted.

Example

Use the configuration of a running MATRIXX Engine to validate the mtx_pricing.xml pricing configuration file.

java -jar convert_price_plan.jar mtx_pricing.xml -port:4070 -address:10.10.11.12 --validate-pricing