Home
MATRIXX Call Control Framework Integration
Configuring CAMEL Gateway
CAMEL Gateway is a CAMEL Application Part (CAP) server. Configure CAMEL Gateway to allow communication between MATRIXX Engine and Network Enablers through the CAP protocols.
Alerts Configuration
The Alert database holds information about Call Control Framework (CCF) operations that require prompt attention. The alerts are a backup mechanism to handle cases when the mobile switching center (MSC) fails to perform an operation based on a request sent by MATRIXX Engine, such as releasing a phone connection when the reported time allotment has expired.
Maximum Authorized Granted Time
The maximum amount of the granted time for calls using a CCF voice service is based on the default authorized quantity configuration in the service context and the value configured for the voice_charging_service.requested_time_in_seconds parameter.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
- About Call Control Framework Integration
  MATRIXX Call Control Framework Integration provides information about MATRIXX Call Control Framework support and configuration.
- MATRIXX Call Control Framework
  MATRIXX includes an integrated GSM Service Control Function to support call control capabilities for telephony services.
- Supported Message Sequences
  MATRIXX Call Control Framework (CCF) provides support for message sequences using the Camel Application Part (CAP) protocol.
- Configuring MATRIXX Network Enabler
  This section describes how to configure MATRIXX Network Enabler.
- Configuring CAMEL Gateway
  CAMEL Gateway is a CAMEL Application Part (CAP) server. Configure CAMEL Gateway to allow communication between MATRIXX Engine and Network Enablers through the CAP protocols.
  - Alerts Configuration
    The Alert database holds information about Call Control Framework (CCF) operations that require prompt attention. The alerts are a backup mechanism to handle cases when the mobile switching center (MSC) fails to perform an operation based on a request sent by MATRIXX Engine, such as releasing a phone connection when the reported time allotment has expired.
    - Alert Timer Index Configuration
      Use the alerts timer index configuration parameters in create_config.py to define timer index values used by CAMEL voice services.
    - Maximum Authorized Granted Time
      The maximum amount of the granted time for calls using a CCF voice service is based on the default authorized quantity configuration in the service context and the value configured for the voice_charging_service.requested_time_in_seconds parameter.
  - CAMEL Gateway General Configuration
    You use configuration parameters in create_config.py to define general configuration for MATRIXX CAMEL Gateway.
  - Default CAMEL Gateway Configuration
    You can use configuration parameters in create_config.py to define default configuration for CAMEL Gateway.
  - CAMEL Gateway Link Configuration
    You can use configuration parameters in create_config.py to define links between CAMEL Gateway and MATRIXX Network Enablers.
  - CAMEL Gateway Routing Configuration
    You can use configuration parameters in create_config.py to define CAMEL Gateway routing configuration.
  - Voice Charging Configuration
    You can use configuration parameters in create_config.py to define Call Control Framework (CCF) voice charging configuration for mobile originating (MO) and mobile terminating (MT) services.
  - SMS Services Configuration
    Use configuration in create_config.py to define Call Control Framework (CCF) configuration for standard SMS mobile originating (MO) and SMS mobile terminating (MT) services.
  - USSD Services Configuration
    You can use the configuration parameters in create_config.py to configure Unstructured Supplementary Service Data (USSD) services, including USSD menu and query services, and the default and additional USSD call back services.
  - Configuring Additional Voice and SMS Services
    Call Control Framework (CCF) provides configuration options for configuring customized charging services for voice and SMS in addition to the standard mobile originating (MO) and mobile terminating (MT) charging services for voice and SMS.
  - Configuring CAMEL Gateway Advanced Options
    Enable CAMEL Gateway advanced options to enable additional configuration options.
  - Configure SCCP Calling Party Address
    Perform this task to configure the value used for the calling party address sent in Signaling Connection Control Part (SCCP) messages.
  - SCCP Calling Party Address Configuration
    You can use configuration parameters in create_config.py to define calling party address fields output in Signaling Connection Control Part (SCCP) messages.
  - Using Normalizers
    You use phone number normalizers or string normalizers to compare a value in any MATRIXX Data Container (MDC), for example, the phone number in a TCAP message, with a set of values stored in any MDC, such as an extended subscriber object or group object MDC to see if the set has the exact same value.
  - Specifying MDC Fields to Supply Digits Sent in CCF Messages
    During pricing configuration, you can specify a reference to a MATRIXX Data Container (MDC) field when setting Call Control Framework (CCF) phone number fields instead of entering a fixed value. During denormalization, the specified MDC field (or an empty string if not present) is copied to the CCF phone number field.
  - Setting Type of Digits in CAP Operations
    You can use selective updates to set the type of digits field used in CAP operations sent by Call Control Framework (CCF).
  - Network Traffic Analysis
    Use the third-party tcpdump utility to capture and analyze network traffic. Configure the utility in a Helm values file to run as a sidecar on the pod that is running a MATRIXX component.
- Configuring Routing Preferences
  Configuring routing preferences allows you to define how routes are prioritized between CAMEL Gateway on each engine and Network Enablers.
- Configuring Correlation ID Length
  Call Control Framework (CCF) supports configurable correlation ID lengths. CCF handles 10 digit correlation ID lengths by default.
- Support for CAP1
  Call Control Framework (CCF) supports the processing of roaming voice calls that use the CAP1 protocol.
- Charging for CS1 INAP Calls
  Call Control Framework (CCF) provides support for processing and applying charging for voice calls that use the CS1 INAP protocol.
- Sending Furnish Charging Information
  You can configure Call Control Framework (CCF) to send Furnish Charging Information (FCI) operations at specific points during call handling. CCF sends FCI operations to instruct the Mobile Switching Center (MSC), or service switching point (SSF), to add charging information to the call data record (CDR) for a call.
- Support for MT Call Forwarding
  When handling a mobile terminating (MT) call, Call Control Framework (CCF) can forward the call to another number if the call is not answered, or the called number is busy.
- TCAP Handover and Relay Configuration
  Call Control Framework (CCF) can handover (relay) incoming TCAP requests for subscribers that MATRIXX cannot find in its subscriber database to another platform for processing. For example, when migrating to the MATRIXX platform, CCF can relay incoming TCAP requests to the incumbent platform for subscribers that have not yet been migrated across. After handover, the incumbent platform processes the TCAP request without any further involvement with MATRIXX.
- Support for Announcements
  MATRIXX Call Control Framework (CCF) provides support for playing pre-call announcements. The following topics describe CCF pre-call announcement functionality and explain how to configure CCF to play announcements.
- Support for USSD Services
  Call Control Framework (CCF) supports making Mobile Application Part (MAP) Unstructured Supplementary Service Data (USSD) call out requests to deliver USSD notifications to a subscriber. CCF also supports USSD services for queries, call back, and interactive menus using MAP-Process-UnstructuredSS-Request messages, and MAP-UnstructuredSS-Request messages.
- Announcements (IVR) and USSD Menus
  Call Control Framework (CCF) provides support for menu driven announcements using IVRs and interactive USSD service menus that give subscribers options for retrieving and updating their balances and account details.
- Apache FreeMarker Template Configuration
  You can configure Apache FreeMarker templates for handling Call Control Framework (CCF) services such as Unstructured Supplementary Service Data (USSD) query and call back services, and menu services using announcements or interactive USSD menus.
- Mobile Application Part (MAP) Call Outs
  MATRIXX Call Control Framework (CCF) provides support within the Charging Server for making MAP call out requests to an external platform in response to TCAP or Diameter messages that require them.
- Extending MAP Callouts
  You can extend the data used in Mobile Application Part (MAP) callout requests and results. You can include customized private extension data in the extensionContainer parameter in MAP ATI (AnyTimeInterrogation) and MAP SRI (SendRoutingInfo) operations. This feature enables you to manipulate the data sent and returned in MAP callouts, for example, to correct the digits dialed by a user when roaming.
- LDAP Callout Service
  Call Control Framework (CCF) provides support for making Lightweight Directory Access Protocol (LDAP) call out requests to an LDAP server in response to TCAP or Diameter messages that require them.
- Callout Response Data MDCs
  Call Control Framework (CCF) holds response data for Mobile Application Part (MAP) callouts and Lightweight Directory Access Protocol (LDAP) callouts for a call or a session in MATRIXX Data Container (MDC) format.
- Appendixes
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
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Maximum Authorized Granted Time

The maximum amount of the granted time for calls using a CCF voice service is based on the default authorized quantity configuration in the service context and the value configured for the voice_charging_service.requested_time_in_seconds parameter.

Pricing administrators configure a hierarchy of service types, each with service contexts containing quota parameters. However, CAMEL voice services typically use only one service with one service context that defines default and maximum quota amounts. The service context configuration may also force the use of the default authorized quota amounts (for example, if the Use Default Auth Quantity parameter is selected for the service context) even if the network requests otherwise.

Voice offers may also include components that select a usage quota profile with parameters similar to the service context parameters.

For each set of service context or quota profile parameters:

If Use Default Auth Quantity is selected, the default authorized amount is always the maximum.
If Use Default Auth Quantity is not selected, the maximum amount is set to the lesser of the following: the configured maximum amount, or the value of the voice_charging_service.requested_time_in_seconds parameter. The voice_charging_service.requested_time_in_seconds parameter defines the requested time for CCF services, and is set to 900 seconds by default. If required, change this value for a voice service by answering the following create_config.info configuration question: What requested time in seconds should be used for the vcs_service calls service?. For more information, see the discussion about voice charging configuration.
The global maximum is the highest defined maximum value across all sets of parameters. Typically, this would be the maximum value defined in the service context.

Pricing administrators can also configure a minimum authorization amount (MinAuth) for a service type as part of pricing configuration. MinAuth is the minimum below which which quota is not authorized by the Charging Server, for example, to ensure a voice call is established only if the subscriber has enough funds to prevent the call being cut off after a few seconds. If the requested amount is less than the minimum amount, the request is denied.