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.
Configuring CAMEL Gateway Advanced Options
Enable CAMEL Gateway advanced options to enable additional configuration options.
Forced Rating Configuration
When CAMEL Gateway advanced options are enabled, you can configure whether to force rating for failed and non-chargeable voice calls and SMS per voice or SMS service.

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.
  - 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.
    - Forced Rating Configuration
      When CAMEL Gateway advanced options are enabled, you can configure whether to force rating for failed and non-chargeable voice calls and SMS per voice or SMS service.
    - Configure Forced Rating
      Perform this task to configure force rating for failed and non-chargeable voice calls and SMS per voice or SMS service
    - Concatenate LAC and Cell ID Configuration
      When CAMEL Gateway advanced options are enabled, you can configure whether to concatenate the Local Area Code (LAC) and Cell ID parameter values.
    - Configure to Concatenate LAC and Cell ID
      Perform this task to configure to concatenate the Local Area Code (LAC) and Cell ID parameter values.
    - Store Application Context and Call Reference Number Configuration
      When CAMEL Gateway advanced options are enabled, you can configure Call Control Framework (CCF) to store the application context and call reference number for a call or SMS attempt to fields in the custom MDC for rating TCAP and CAP services. This enables the application context and call reference number to be reported in MATRIXX Event Files (MEFs) for use in reconciliation.
    - Configure Store Application Context and Call Reference Number
      Perform this task to configure Call Control Framework (CCF) to store the application context and call reference number for a call or SMS attempt to fields in the custom MATRIXX Data Container (MDC) for rating TCAP and CAP services.
    - Arm oAnswer and tAnswer as Interrupted
      When CAMEL Gateway advanced options are enabled, you can configure whether to arm oAnswer and tAnswer Event Detection Points (EDPs) as interrupted per voice charging service.
    - Arm oDisconnect and tDisconnect Leg 2 as Interrupted
      When CAMEL Gateway advanced options are enabled, you can configure whether to arm oDisconnect and tDisconnect Leg 2 Event Detection Points (EDPs) as interrupted per voice charging service.
    - Send ReleaseCall Instead of Continue in ERBCSM Requests
      For calls using the CAP2 or CAP3 protocols, you can configure whether to send ReleaseCall or Continue in EventReportBCSM request operations for which eventTypeBCSM is anything except answer.
    - Configuring CCF to use Alternative Message Sequences
      When CAMEL Gateway advanced options are enabled, you can configure, per voice charging service, whether Call Control Framework (CCF) uses alternative message sequences.
  - 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

Forced Rating Configuration

When CAMEL Gateway advanced options are enabled, you can configure whether to force rating for failed and non-chargeable voice calls and SMS per voice or SMS service.

Use this feature if you want:

MATRIXX Engine to set values for an account, such as expiry dates, based on first usage time even when the first usage is a failed call.
To copy custom fields into the MEF using normalizers.

When this feature is enabled, the service determines whether to apply rating based on the value in a field named ZeroCharge in the custom MDC for rating TCAP and CAP services.

Note: You must set up rating so that no charge is applied when the value of ZeroCharge is not 0 (zero). For information about rating set up, see MATRIXX Pricing and Rating.

For failed and non-chargeable voice calls and SMS, when the ZeroCharge value is set to:

0 — The service sends Accounting:stop(0) or Accounting:single_event(0) to MATRIXX Engine and normal charging rules are applied.
1 — The service sends Accounting:stop(1) or Accounting:single_event(1) to MATRIXX Engine, a MEF is generated but no charging is applied.