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.

USSD Configuration Parameters

CAMEL Gateway USSD Configuration describes the create_config.py parameters necessary for configuring USSD behavior and shows default values for each parameter. For information about USSD services and how to configure them, see the discussion about support for USSD services.

Table 1. CAMEL Gateway USSD Configuration
Parameter Description Default Value
Maximum USSD Message Length Sets the maximum number of octets that can be used in an Unstructured Supplementary Service Data (USSD) notification message. USSD notifications are truncated if they are longer than the configured maximum.
Note: You define USSD notifications in USSD notification templates. For more information about defining notification templates, see the discussion about MATRIXX Notification Framework in MATRIXX Integration.

create_config.info question: What is the maximum number of USSD octets to allow in a USSD string?

 160
USSD Query Service Codes The list of operator-defined service codes for USSD queries. Enter a comma-separated list of up to 20 numbers.
Note: In the USSD string, the service code prefixes the ID of the item to query. For example, a subscriber could enter *123*12 on their handset, where 123 is the service code for USSD balance queries and 12 identifies the balance to query.

create_config.info question: Enter a list of USSD query service codes?

 121, 123
USSD Menu Service Codes Enter a comma-separated list of up to 20 operator-defined service codes for USSD menus.

create_config.info question: Enter a list of USSD menu service codes?

 100, 200
USSD Callout Service ID The service ID of the USSD callout service to use, during USSD menu processing, when returning the UnstructuredSS-request message to the USSD device.

create_config.info question: Enter the service id of the USSD call out service to use?

 3001
USSD Service Subscriber Source (Used by both USSD queries and USSD menus). Specifies the list of subscriber sources to search for in the incoming Process-UnstructuredSS-Request message. The first source that is found in the list is used to determine the primary subscriber to associate the call with. Enter a comma-separated list of subscriber sources in search order priority. Valid values are:
  • UssdParameterMsisdn
  • MapOpenMsisdn
  • MapOpenImsi
Note: The MapOpenMsisdn or MapOpenImsi is derived from the MAP-OPEN destinationReference parameter.

create_config.info question: What subscriber sources are required for the USSD query service?

 MapOpenImsi
USSD Incoming Service Rule Set The name of the rule set that the USSD incoming service (for USSD queries and USSD menus) uses for number normalization or denormalization. To use the default rule set, enter default.

create_config.info question: What rule set should be used for number normalization for the USSD query service?

 default
USSD CB Service Subscriber Source For USSD call back services, specifies a list of subscriber sources to search for in the incoming USSD message. The first source that is found in the list is used to determine the primary subscriber (the A-party) for the InitiateCallAttempt operation. Enter a comma-separated list of subscriber sources in search order priority. Valid values are:
  • MsisdnFromUssdParameter
  • DestinationReferenceId
  • MsisdnFromDatabase

create_config.info question: What subscriber sources are required for the USSD call back service?

 MsisdnFromDatabase
USSD CB Service Rule Set The name of the rule set that USSD call back services use for number normalization or denormalization. To use the default rule set, enter default.

create_config.info question: What rule set should be use for number normalization for the USSD call back service?

 default
Enable USSD Relay SCCP Address Answer y to enable CCF to relay USSD incoming messages for subscribers who cannot be found in the MATRIXX subscriber database to a new SCCP address. You will be asked additional create_config.info questions for configuring the relay SCCP address. For information, see the discussion about relay sccp address configuration parameters.

If you answer n, the additional questions are not asked.

Note: USSD relay works only for non-segmented SCCP/MAP messages. The USSD service returns a MAP error and logs a warning message if it receives a segmented SCCP/MAP message.

create_config.info question: Do you wish to enable relay sccp for the service?

 n
USSD CB Service: IDP Service Key Defines the voice service IDP service key to use for the USSD call back service. This service key value is entered into the IDP that triggers the voice call between the A-party and the B-party. It has a minimum value of 0 (zero).

create_config.info question: Enter the USSD call back idp service key?

 222
USSD CB Service Service Code The operator-defined USSD service code for the call back service. The minimum value is 0 (zero).
Note: The USSD call back service code prefixes the destination number in the USSD message. For example, in the following sequence, 123 is the service code (or Service Access Number (SAN)) and 0722724681234 is the B-number for the destination: *123*0722724681234#.

create_config.info question: Enter the USSD call back service code?

 124
USSD CB Service Voice Service ID For the USSD call back service, specifies the ID of the existing voice service to use when connecting the A-party with the B-party. The minimum value is 0 (zero).

create_config.info question: Enter the USSD call back voice service id?

1
USSD CB Service Call Initiation SCCP Address Type The call initiation SCCP address type in the incoming USSD message for the call back service. Valid values are:
  • 1.pc — To specify a point code as the SCCP calling address, you must answer an additional question.
  • 2.gt — To specify a global title as the SCCP calling address, you must answer additional questions.

create_config.info question: Enter the USSD call back call initiation SCCP address type (pc/gt)?

 1 for pc
USSD CB Service Call Initiation SCCP Point Code If Call Inititiation SCCP Address Type for the USSD call back service is set to point code (PC), specifies the PC to use in the SCCP calling address. The minimum point code value is 0 (zero).

create_config.info question: Enter the USSD call back call initiation SCCP point code?

 0
USSD CB Service Call Initiation SCCP GT Type The the global title (GT) type to use for the USSD call back service in the SCCP calling address.
Note: The specified GT is also used to set the gsmScfAddress. You must configure the GT even if you are using a point code for the SCCP address.
Valid values are:
  • 1 — Use digits and nature of address.
  • 2 — Use digits and translation type.
  • 3 — Use digits, translation type, and numbering plan.
  • 4 — Use digits, translation type, numbering plan, and nature of address.

create_config.info question: Enter the USSD call back call initiation SCCP global title type?

 4
USSD CB Service Call Initiation SCCP GT Translation Type The call initiation SCCP global title translation type for the USSD call back service. Enter a value in the range: 0 to 255.

create_config.info question: Enter the USSD call back call initiation SCCP global title translation type?

 1
USSD CB Service Call Initiation SCCP GT Number Plan The call initiation SCCP global title number plan for the USSD call back service. Enter a value in the range: 0 to 15.
Valid values are:
  • 0 — Unknown.
  • 1 — ISDN/telephony numbering plan (ITU-T E.163 and E.164).
  • 2 — Generic numbering plan.
  • 3 — Data numbering plan (ITU-T X.121).
  • 4 — Telex numbering plan (ITU-T F.69).
  • 5 — Maritime mobile numbering plan (ITU-T E.210, E.211).
  • 6 — Land mobile numbering plan (ITU-T E.212).
  • 7 — ISDN/mobile numbering plan (ITU-T E.214).
All other values are spare or reserved.

create_config.info question: Enter the USSD call back call initiation SCCP global title number plan?

 1
USSD CB Service SCCP GT Nature of Address The nature of address of the global title to use in the call initiation SCCP address for the USSD call back service. Enter a value in the range: 0 to 127. All other values are spare or reserved.
Valid values are:
  • 0 — Unknown
  • 1 — Subscriber
  • 3 — National
  • 4 — International

create_config.info question: Enter the USSD call back call initiation SCCP global title Nature of Address?

 4
USSD CB Service Call Inititiation SCCP GT Digits The global title digits to use in the call initiation SCCP calling party address for the USSD call back service. Enter the phone number digits, or enter none.

create_config.info question: Enter the USSD call back call initiation SCCP global title digits?

 12345678
USSD CB Service Call Initiation SCCP SSN The sub-system number (SSN) to use in the call inititation SCCP calling address for the USSD call back service. Leave blank for no SSN. The minimum value is 0.

create_config.info question: Enter the USSD call back call initiation SCCP subsystem number (ssn)?

 0
USSD CB Service CB String Format
The call back string format for the USSD call back service. One of:
  • *SAN*B_NUMBER
  • *SAN#B_NUMBER
where the B-number for the destination is substituted in the call back string.

create_config.info question: Enter the USSD call back format of the USSD call back string?

 *SAN*B_NUMBER#
USSD CB Service CB Response Type
The call back response type for the USSD call back service. Valid values are:
  • respond_before_call_initiation
  • respond_after_b_party_initiation
  • respond_after_a_answer
  • respond_after_connection

create_config.info question: Enter the USSD call back response type?

 respond_before_call_initiation
Number of Additional USSD CB Services The number of USSD call back services required in addition to the default call back service. Enter 0 if no additional services are required, otherwise enter a value between 1 and 999. You must answer additional questions to configure the additional call back services. The questions are the same as those for the default call back service.

create_config.info question: How many additional USSD Call back services do you wish to create?

 0