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.
Sample Mobile Originating Configuration
- MO services, create_config.info questions begin:
"Camel Gateway:VCS voice_mo:"
, for example:VCS voice_mo:Do you want to send CallInformationRequest to monitor calls for the Voice MO calls service (y/n)?
- MT services, create_config.info questions begin:
"Camel Gateway:VCS voice_mt:"
, for example:Do you want to send CallInformationRequest to monitor calls for the Voice MT calls service (y/n)?
Parameter | Description | Default Value |
---|---|---|
Send CIQ | Whether to send a CallInformationRequest (CIQ) operation in the same message as the Connect or Continue operation. The information is
returned in a CallInformationReport (CIR) operation. This information can be recorded in the MEF record (EDR).
When this feature is enabled and MATRIXX Engine determines that a mobile originating voice call must not be charged, the engine sends a Continue or a Connect operation with a CallInformationRequest operation but no ApplyCharging operation. For charged calls, the CIQ is sent in the same message as the ApplyCharging and Connect or Continue operations. create_config.info question: Do you want to send CallInformationRequest to monitor calls for the vcs_service calls service (y/n)? where vcs_service is replaced in the question by Voice MO or Voice MT. |
n |
Service ID | The ID of the charging service configured for the MO or MT service that is used when sending voice information to MATRIXX Engine. The ID is used to populate
the following parameters that are used in charging configuration created in My MATRIXX:
create_config.info question: What charging Service ID should be used for the vcs_service calls service? |
3 |
Requested Time | The number of seconds to request from the Charging Server for calls for this service. Sets the maximum number of seconds
granted in an ApplyCharging operation for this service. The minimum value is 30 seconds. Set to 900 seconds by
default. create_config.info question: What requested time in seconds should be used for the vcs_service calls service?
Note: The alert timer index size configuration is used for determining when to trigger an alert. You must set the alert timer index size to
20 seconds more than the maximum requested time configured for any service. For more information about configuring the timer index size, see the discussion
about alerts configuration. |
900 |
Reauthorize on Answer | Answer y if you want the Charging Server to reauthorize granted quota when a call is answered. Otherwise, answer n .
|
n |
Enable Relay SCCP | Answer y to enable CCF to relay incoming TCAP messages for subscribers who cannot be found in the MATRIXX subscriber
database to the specified relay 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 create_config.info question: Do you wish to enable relay sccp for the service? |
n |
Reauthorize on Receipt of ERBCSM chargeIndicator | (Valid only for calls using the CAP4 protocol.) Answer y if you want the service to honor the chargeIndicator parameter value requested in an
o/tAnswer EventReportBCSM operation. Otherwise, answer n . When set to y, if chargeIndicator is set to:
When set to n, the call is always charged for, even if chargeIndicator is set to no charge, unless the rating plan
specifies that the call must not be charged. Note: The ApplyCharging operation is not sent if the Charging Server determines that the call must not be charged.
create_config.info question: Honor no charge request on call answer for the vcs_service calls service (y/n)? |
y |
Send ReleaseCall on Receipt of ERBCSM | Advance configuration option valid only for calls using the CAP2 or CAP3 protocols. This configuration becomes available only when you answer y to
the following question: Do you wish to configure advanced options (y/n)?Sets whether to send ReleaseCall on receipt of an EventReportBCSM request operation for which the event detection point (EDP) is armed as anything except answer. A Continue operation is sent by default. Answer create_config.info question: Should ReleaseCall be sent on receipt of ERBCSM(EDP anything except answer,request) for CAP2 and CAP3(y/n)? |
n |
Arm Answer as Interrupted | Advanced configuration option to arm the oAnswer and tAnswer event detection points (EDPs) as interrupted. This configuration becomes
available only when you answer y to the following questions: Camel Gateway:Do you wish to configure advanced options (y/n)? VCS vcs_service:Reauthorize charge on answer for the vcs_service calls service (y/n)? CCF arms all EDPs as notifyAndContinue by default. To arm o/tAnswer as
interrupted, answer create_config.info question: Should oAnswer or tAnswer be armed as interrupted for the vcs_service calls service (y/n)? When set to
y , if MATRIXX Engine receives o/tAnswer armed as
interrupted in a TCAP CONTINUE (EventReportBCSM) operation and it determines that the call is:
|
n |
No Answer Timeout | The number of seconds to wait for an answer before a call times out. create_config.info question: What no answer timeout in seconds do you want for the vcs_service calls service? |
30 |
ActivityTest Interval | Sets the number of seconds that MATRIXX Engine should wait
between sending ActivityTest operations to the mobile switching center (MSC) for non-chargeable calls. The default value is 1800 seconds (30 minutes). If the MSC
returns:
create_config.info question: What is the interval in seconds between sending ActivityTest operations for uncharged calls for the vcs_service calls service? |
1800 |
ActivityTest Response Timeout | Sets the number of seconds that MATRIXX Engine waits for a response to the ActivityTest
operation before timing out. create_config.info question: What is the activity test response timeout in seconds for the vcs_service calls service? |
5 |
Send ActivityTest for Timed Calls | When set to y , the default, CCF sends ActivityTest for CAP 1 or CS1 INAP timed calls when the timer expires.
Time is charged only when the ActivityTest result is recieived. If no ActivityTest result is received within the specified timeout then the call finishes and no
further time is charged.create_config.info question: Should ActivityTest be sent for CS1 INAP or CAP 1 timed calls for the vcs_service calls service (y/n)? |
y |
Correlation ID Length | Sets the correlation ID length to use for the voice service for correlating the TCAP dialogues used in the message sequence when
playing announcements. CCF handles 10 digit correlation IDs by default. If you set the correlation ID length to a value other than 10, you must also configure
ranges of correlation IDs on each domain. For information about configuring correlation IDs, see the discussion about configuring correlation IDs. Note: You can override the correlation ID length on an announcement server basis. For information about configuring announcement servers,
see the discussion about configuring announcements in My MATRIXX Help. create_config.info question: What is the default correlation ID length for the vcs_service calls service? |
10 |
Arm Disconnect Leg2 As Interrupted | (Optional) Arms the oDisconnect and tDisconnect Leg 2 event detection points (EDPs) as interrupted. This configuration becomes available only
when you answer y to the following question: Do you wish to configure advanced options (y/n)?CCF arms all EDPs as notifyAndContinue by default?
To arm the oDisconnect and tDisconnect EDPs for leg 2 as interrupted, answer y to the following question: create_config.info question: Should oDisconnect or tDisconnect for leg 2 be armed as interrupted for the vcs_service calls service (y/n)? When set to
y , if MATRIXX Engine receives o/tDisconnect armed as
interrupted in a TCAP CONTINUE (EventReportBCSM) operation:
Note: Typical processing continues if MATRIXX Engine receives a TCAP
CONTINUE(EventReportBCSM(oDisconnect or tDisconnect) operation.
|
n |
Use Alternative Message Sequences | (Optional) Answer y if you want CCF to use alternative message sequences for the voice service. create_config.info question: Should an alternative message sequence be used for the vcs_service calls service (y/n)? This
configuration becomes available only when you answer |
n |
Alternative Message Sequence Type | This question is asked only if alternative message sequences are enabled for the voice service. Valid values are 'type1' (default), 'type2', and 'type3'. When set to type1, CCF:
When set to type2, CCF:
When set to type3, CCF:
create_config.info question: Which type of alternative message sequence should be used for the vcs_service calls service?type1 |
type1 |
Play Announcements | Answer y to play pre-call announcements for the calls service. Otherwise, answer n .
|
y |
Enable Announcements for Forwarded Calls | Answer y if you want to enable announcements for forwarded calls. Otherwise, answer n . This
question is asked only if Play Announcements is enabled.create_config.info question: Do you want to play announcements for forwarded calls in the vcs_service calls service
(y/n)?Note: CCF assumes the call is forwarded if the InitialDP originalCalledPartyID is present. |
n |
Announcement Failure Policy |
Answer y to release the call if the Interactive Voice Response (IVR) system is unable to play an announcement. Answer n to continue
the call without playing any announcements. create_config.info question: If any announcements fail during the vcs_service calls service should the call be released (y/n)? |
n |
Announcement Tssf Timer Reset | Answer y if, before playing the announcement, you want to send a ResetTimer operation to the MSC to set the timer to a value 10 seconds longer than
the configured time of the announcement. Answer n if you do not want to reset the announcement Tssf timer.
|
n |
Script Tssf Timer Reset | Answer y if, before running the script, you want to send a ResetTimer operation to the MSC to set the timer to a value 10 seconds longer than the
configured time of the script. Answer n if you do not want to reset the script Tssf timer.
|
n |
Arm oAbandon EDP | Arms the oAbandon EDP before playing an announcement or running a VXML script. This means that the MSC sends events instead of TCAP aborts if the call is ended
before or during an announcement or VXML script. This option becomes available for a service only when you answer y to the following question:
Do you want to play announcements in the vcs_service calls service (y/n)? By default the oAbandon EDP is not armed before playing an announcement or running a VXML script. To arm the oAbandon EDP, answer create_config.info question: Should the oAbandon EDP be armed before playing announcements or running VXML scripts (y/n)? |
n |
Bothway Indicator | Sets the value of the bothwayThroughConnectionInd field in ConnectToResource and EstablishTemporaryConnection operations
for the service. When set to:
create_config.info question: What should bothwayThroughConnectionInd be set to in ConnectToResource and EstablishTemporaryConnection operations for the
vcs_service calls service? Important: By
default this field is not set and the
bothwayThroughConnectionInd field is not included in the message. In this case, the sound path between
the caller and the IVR is enabled in both directions. MATRIXX Support recommends that you accept the default value and, if required, set the
bothwayThroughConnectionInd field on an announcement server (IVR) basis instead, when configuring announcement pricing components in My
MATRIXX. For more information, see the discussion about announcements configuration in My MATRIXX Help. |
Not set |
Play Tone | Enables CCF to play a warning tone to callers if they are about to run out of funds. Answer y if you want to enable this
feature for the service. Otherwise, answer n.
create_config.info question: Do you want the caller to hear a tone shortly before the call is cut off due to insufficient funds for the vcs_service calls service (y/n)? |
y |
Maximum Redirections | Sets the maximum number of redirections allowed for a call. Calls are released if the number of redirections exceeds the configured maximum. Enter a value between 0
and 255.
|
3 |
Emergency Number List | The list of numbers or number prefixes to treat as emergency numbers. Enter a comma separated list of up to 100 numbers. Numbers can
contain non-digits such as * and #. Note: For MSCs that handle emergency numbers themselves, you can set the emergency number list
value to none , but only if you are certain that MSCs already handle these numbers.
|
none |
Enable MT Call Forwarding | For MT voice services only. Call forwarding is not supported for the MO voice service and this question is not asked for the MO voice service. Answer
y to enable calls using the MT service to be forwarded or redirected. CCF forwards calls to the denormalized number specified in
DestinationRoutingAddress only if both the following fields are set in MtxTcapMsg.Ratingmsg.ServiceInfo.VcsInfo :
For more information about MT call forwarding, see the discussion about support for MT call forwarding in MATRIXX Call Control Framework Integration. |
n |
Search for TSANs | For MO voice services only. Call reorigination is not supported for MT calls and this question is not asked for MT voice services. If you are using the TSAN reorigination service, answer
|
n |
Send FCI | Answer y to send FurnishChargingInformation (FCI) operations during call handling. By default, FCI operations are not
sent.
create_config.info question: Do you want to send FurnishChargingInformation for the vcs_service calls service (y/n)? If you answer y , then you must answer the following additional questions:
Note: You can also enable the following FCI options for the service by using normalizers or selective updates to set the
MtxTcapMsg.RatingMsg.ServiceInfo.VcsInfo.FciFlags parameter. Set FciFlags to:
You must define the specified private MDC for the FurnishChargingInformation operation parameter data to be sent in FCI operations, and then specify selective updates to populate the MDC free format data fields. For more information, see the discussion about sending furnish charging information in Call Control Framework Integration. |
n |
AChBillingCharacteristics MDC | Specifies the private MDC to use for AChBillingCharacteristics parameter data. The AchBillingCharcteristics parameter is sent in
custom ApplyCharging operations for CS1 INAP. Note: You must also define the private MDC, and specify selective updates to populate the
AChBillingCharacteristics fields.
|
None |
Call Result MDC | Specifies the private MDC that holds the CallResult parameter data for calls using the CS1 INAP protocol. Note: You must also define the private MDC, and specify selective updates to populate the CallResult fields.
|
None |
Use CS1 INAP | Answer y if calls to the voice service will be using the CS1 INAP protocol.
If you answer y , then you must also answer the following question to specify the CS1 INAP charging method, one of:
|
3 — MATRIXX Timer |
Pre Call Initiation Delay | Sets the number of seconds to delay call initiation for USSD call back, for the voice service. Set to 0 (zero) if you do not want to delay call initiation.
create_config.info question: What pre call initiation delay in seconds do you want for the vcs_service calls service? |
0 |
Call Initiation Retries | Sets the maximum number of retries for call initiation to the A-party (calling party) for USSD call back. If Call Initiation Retries is set to a value greater than
one, then CCF retries the initiate call only if both the following are true:
create_config.info question: How many tries do you want for the call initiation a_party for the vcs_service calls service? |
1 |
Use Session Limit Service ID | Answer y to the following question to specify a service ID to use for limiting the number of concurrent USSD call back sessions to one per
subscriber. create_config.info question: Do you want to add a session limit service id in the vcs_service calls service? If you answer create_config.info question: What session limit service id do you want for the vcs_service calls service? |
n |
Use Call Initiation Session Limit Service ID | Answer y to the following question to specify a service ID to use for limiting the number of concurrent call initiation sessions for USSD call back
to one per subscriber. create_config.info question: Do you want to add a call initiation session limit service id in the vcs_service calls service? If you answer create_config.info question: What session limit service id do you want for the vcs_service calls service? |
n |
Call Initiation Order | For call initiation, CCF sends an InitateCallAttempt operation for the A-party (the caller) before the InitiateCallAttempt operation for the B-party (the callee) by
default. Answer n to the following question if you want CCF to send InitiateCallAttempt for the B-party first.
create_config.info question: For call initiation, do you want InitiateCallAttempt(A-party) to be sent before InitiateCallAttempt(B-party) for vcs_service calls service (y/n)? |
y |
Add Call Initiation Release Causes | Answer y to the following question to enter a list of valid release cause values for call initiation retries.
create_config.info question: Do you want to add call initiation release cause values in the vcs_service calls service? |
n |
Call Initiation Release Cause Values | Enter a comma separated list of call initiation release cause values. A call initiation retry is attempted only if the release cause for the previous attempt matches
a value in the list, and a EventReportBCSM(routeSelectFailure) operation is received. create_config.info question: Enter a list of release causes to be checked in order to retry call initiation in the vcs_service calls service? |
none |
Release Cause for Not Found Subscriber (Voice Service) | The number indicating the release cause if a subscriber is not found for the voice charging service. create_config.info question: What should the release cause be if the subscriber cannot be found for the voice_service calls service? |
1 |
Release Cause for Insufficient Funds (Voice Service) | The number indicating the release cause if a subscriber has insufficient funds for the voice charging service. create_config.info question: What should the release cause be if the subscriber has insufficient funds to make a call for the voice_service calls service? |
63 |
CAMEL Gateway Voice Charging Configuration
The following example create_config.info section shows CAMEL Gateway voice charging configuration for mobile originating and mobile terminating calls.
VCS voice_mo:Do you want to send CallInformationRequest to monitor calls for the Voice MO calls service
(y/n)?n
Camel Gateway:VCS voice_mo:What charging Service ID should be used for the Voice MO calls service?3
Camel Gateway:VCS voice_mo:Reauthorize charge on answer for the Voice MO calls service (y/n)?n
Camel Gateway:VCS voice_mo:Do you wish to enable relay sccp for the service?
Camel Gateway:VCS voice_mo:Honor no charge request on call answer for the Voice MO calls service (y/n)?y
Camel Gateway:VCS voice_mo:What no answer timeout in seconds do you want for the Voice MO calls service?30
Camel Gateway:VCS voice_mo:What is the interval in seconds between sending ActivityTest operations for uncharged calls for the Voice MO calls service?1800
Camel Gateway:VCS voice_mo:What is the activity test response timeout in seconds for the Voice MO calls service?5
Camel Gateway:VCS voice_mo:Should ActivityTest be sent for CS1 INAP or CAP 1 timed calls for the Voice MO calls service (y/n)?y
Camel Gateway:VCS voice_mo:Do you want to play announcements in the Voice MO calls service (y/n)?y
Camel Gateway:VCS voice_mo:If any announcements fail during the Voice MO calls service should the call be released (y/n)?n
Camel Gateway:VCS voice_mo:Should ResetTimer be sent when playing announcements (y/n)?y
Camel Gateway:VCS voice_mo:Should ResetTimer be sent when running scripts (y/n)?y
Camel Gateway:VCS voice_mo:What should bothwayThroughConnectionInd be set to in ConnectToResource and EstablishTemporaryConnection operations for the Voice MO calls service?bothwayPathNotRequired
Camel Gateway:VCS voice_mo:Do you want the caller to hear an audible tone shortly before the call is cut off due to insufficient funds for the Voice MO calls service (y/n)?n
Camel Gateway:VCS voice_mo:How many redirections are allowed in the Voice MO calls service?3
Camel Gateway:VCS voice_mo:Enter list of numbers to be treated as emergency numbers in the Voice MO calls service?none
Camel Gateway:VCS voice_mo:Do you want to send FurnishChargingInformation for the Voice MO calls service (y/n)?n
Camel Gateway:VCS voice_mt:Do you want to send CallInformationRequest to monitor calls for the Voice MT calls service (y/n)?n
Camel Gateway:VCS voice_mt:What charging Service ID should be used for the Voice MT calls service?3
Camel Gateway:VCS voice_mt:Reauthorize charge on answer for the Voice MT calls service (y/n)?n
Camel Gateway:VCS voice_mo:Do you wish to enable relay sccp for the service?
Camel Gateway:VCS voice_mt:Honor no charge request on call answer for the Voice MT calls service (y/n)?y
Camel Gateway:VCS voice_mt:What no answer timeout in seconds do you want for the Voice MT calls service?30
Camel Gateway:VCS voice_mt:What is the interval in seconds between sending ActivityTest operations for uncharged calls for the Voice MT calls service?1800
Camel Gateway:VCS voice_mt:What is the activity test response timeout in seconds for the Voice MT calls service?5
Camel Gateway:VCS voice_mt:Should ActivityTest be sent for CS1 INAP or CAP 1 timed calls for the Voice MT calls service (y/n)?y
Camel Gateway:VCS voice_mt:Do you want to play announcements in the Voice MT calls service (y/n)?n
Camel Gateway:VCS voice_mt:If any announcements fail during the Voice MT calls service should the call be released (y/n)?n
Camel Gateway:VCS voice_mt:Should ResetTimer be sent when playing announcements (y/n)?y
Camel Gateway:VCS voice_mt:Should ResetTimer be sent when running scripts (y/n)?y
Camel Gateway:VCS voice_mt:What should bothwayThroughConnectionInd be set to in ConnectToResource and EstablishTemporaryConnection operations for the Voice MT calls service?bothwayPathNotRequired
Camel Gateway:VCS voice_mt:Do you want the caller to hear an audible tone shortly before the call is cut off due to insufficient funds for the Voice MT calls service (y/n)?n
Camel Gateway:VCS voice_mt:How many redirections are allowed in the Voice MT calls service?3
Camel Gateway:VCS voice_mt:Enter list of numbers to be treated as emergency numbers in the Voice MT calls service?none
Camel Gateway:VCS voice_mt:Do you want to send FurnishChargingInformation for the Voice MT calls service (y/n)?n