Oracle® Communications Service Broker Processing Domain Configuration Guide Release 6.0 Part Number E23525-02 |
|
|
View PDF |
The following sections describe how to configure IM-SCF using the Service Broker Administration Console and Java MBeans.
This section describes how to configure the IM-SCF CAP phase 3 by using the Service Broker Administration Console.
To access the IM-SCF CAP phase 3 configuration screen:
In the domain navigation pane, expand OCSB.
Expand Processing Tier.
Expand Interworking Modules.
A list of currently deployed Interworking Modules is displayed.
From the module list, select the module instance that you want to configure.
The IM-SCF CAP phase 3 configuration pane contains the subtabs described in Table 7-1.
Table 7-1 IM-SCF CAP Phase 3 Configuration Subtabs
Subtab | Description |
---|---|
General |
Enables you to configure general parameters for an Interworking Module instance. For more information, see "Configuring General Parameters" |
Call Handling |
Enables you to define the way that IM-SCF handles calls. For more information, see "Configuring Call Handling Parameters". |
IN Triggering |
Enables you to define the IN triggers that IM-SCF arms in the underlying session control entity. For more information, see "Configuring IN Triggering Parameters". |
Charging Service |
Enables you to define how IM-SCF sends credit reservation requests and specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC. See "Charging Services" for more information. |
Media Resources |
Enables you to set up the media resources that Service Broker uses to play announcements. See "Configuring Media Resources Parameters" for more information. |
TCAP |
Enables you to set up the TCAP layer of the IM-SCF. See "Configuring TCAP Parameters" for more information. |
Monitoring |
Enables you to define how Runtime MBeans and notifications operate. See "Configuring Monitoring Parameters" for more information. |
The General subtab displays the protocol variant that is used to encode / decode SS7 messages and enables you to specify an alias for an Interworking Module instance.
Table 7-2 describes the configuration parameter on the General subtab.
Name | Type | Description |
---|---|---|
Alias |
STRING |
Specifies the alias of the IM's SS7 address. The alias is an index to SS7 SSU configuration, where the IM's SS7 address is configured. The IM uses this alias to set the origination field of outgoing SS7 messages. This ensures that further session messages arrive to this IM instance. |
Plugin |
STRING |
Specifies the protocol variant used over the SS7 interface. It informs the IM which plug-in (class) to use to encode / decode SS7 messages. |
The Call Handling subtab enables you to define how IM-SCF handles calls.
Table 7-3 describes configuration parameters on the Call Handling subtab.
Table 7-3 IM-SCF CAP Phase 3 Call Handling Parameters
Name | Type | Description |
---|---|---|
OE Reaction Interval in Seconds |
INT |
Specifies the time period in seconds during which the IM-SCF waits for the OE to respond to SAL messages. When this timer expires, IM-SCF decides how to handle existing session (Continue or Release) according to the configuration settings. Default value: 100 |
Reset Timer Interval in Seconds |
INT |
Specifies the time period, in seconds, from receiving IN operation and till invoking the ResetTimer operation towards the MSC (reset Tssf). Default value: 10000 |
UI Reset Timer Interval in Seconds |
INT |
Specifies the time period, in seconds, from receiving IN operation and till invoking the ResetTimer operation towards the MSC (reset Tssf). As opposed to Reset Timer Interval in Seconds, this parameter is used when IM-SCF is in the middle of interaction with a media resource. Default value: 10000 |
Body Encoding Format |
STRING |
Specifies the method that the IM-SCF uses to encode IN parameters in the body of a SAL message. Possible options:
Default value: None In an IN mediation solution, when IM-SCF is coupled with IM-SSF, this parameter must be set to XER. |
Activity Test Interval in Seconds |
INT |
Specifies the time interval in seconds between two invocations of ActivityTest operation. This operation is used to check whether or not the call exists. Default value: 0, which means that the ActivityTest is not sent |
RRBCSM Accumulation Mode |
BOOL |
Specifies whether or not IM-SCF arms DPs using a single or multiple RRBCSM requests. Possible values:
|
Wait for AssistRequestInstructions after EstablishTemporaryConnection |
BOOL |
Specifies whether or not IM-SCF expects an ARI operation, following an ETC operation to the switch. Possible values:
|
AssistRequestInstructions Waiting Interval in Seconds |
INT |
Specifies the time period in seconds during which the IM-SCF waits for an ARI operation, following an ETC operation to the switch |
gsmSCFAddress |
STRING |
Specifies gsmSCFAddress to be set in an EstablishTemporaryConnection (ETC) operation. gsmSCFAddress represents the address of IM-SCF that initiates the ETC operation. gsmSCFAddress consists of the following:
For more information about the format of gsmSCFAddress, see 3GPP 29.002. |
The IN Triggering subtab enables you to define IN triggers that the IM-SCF arms in the underlying session control entity and specify additional parameters.
The IN Triggering subtab contains the subtabs described in Table 7-4.
Table 7-4 IN Triggering Subtabs
Subtab | Description |
---|---|
O-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call origination side. For more information, see "Configuring DPs on the Call Origination Side". |
T-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call termination side. For more information, see "Configuring DPs on the Call Termination Side". |
O-SMS |
Enables you to configure how the IM-SCF arms DPs on the SMS origination side. For more information, see "Configuring DPs on the SMS Origination Side". |
Configuring DPs on the Call Origination Side
The O-BCSM subtab enables you to configure how the IM-SCF arms DPs on the call origination side.
Table 7-5 describes configuration parameters on the O-BCSM subtab.
Name | Type | Description |
---|---|---|
RouteSelectFailure |
STRING |
Specifies how the IM-SCF arms RouteSelectFailure. Possible values:
Default value: INTERRUPTED |
OCalledPartyBusy |
STRING |
Specifies how the IM-SCF arms oCalledPartyBusy. Possible values:
Default value: INTERRUPTED |
ONoAnswer |
STRING |
Specifies how the IM-SCF arms oNoAnswer. Possible values:
Default value: INTERRUPTED |
OAnswer |
STRING |
Specifies how the IM-SCF arms oAnswer. Possible values:
Default value: INTERRUPTED |
ODisconnect |
STRING |
Specifies how the IM-SCF arms oDisconnect. Possible values:
Default value: INTERRUPTED |
OAbandon |
STRING |
Specifies how the IM-SCF arms oAbandon. Possible values:
Default value: INTERRUPTED |
ODisconnect Leg |
STRING |
Specifies a leg on which the oDisconnect DP is armed. Possible values:
Default value: 1,2 |
Configuring DPs on the Call Termination Side
The T-BCSM subtab enables you to configure how the IM-SCF arms DPs on the call termination side.
Table 7-6 describes configuration parameters on the T-BCSM subtab.
Name | Type | Description |
---|---|---|
TBusy |
STRING |
Specifies how the IM-SCF arms tBusy. Possible values:
Default value: INTERRUPTED |
TNoAnswer |
STRING |
Specifies how the IM-SCF arms tNoAnswer. Possible values:
Default value: INTERRUPTED |
TAnswer |
STRING |
Specifies how the IM-SCF arms tAnswer. Possible values:
Default value: INTERRUPTED |
TDisconnect |
STRING |
Specifies how the IM-SCF arms tDisconnect. Possible values:
Default value: INTERRUPTED |
TAbandon |
STRING |
Specifies how the IM-SCF arms tAbandon. Possible values:
Default value: INTERRUPTED |
TDisconnect Leg |
STRING |
Specifies a leg on which the tDisconnect DP is armed. Possible values:
Default value: 1,2 |
Configuring DPs on the SMS Origination Side
The O-SMS subtab enables you to configure how the IM-SCF arms DPs on the SMS origination side.
Table 7-7 describes configuration parameters on the O-SMS subtab.
Name | Type | Description |
---|---|---|
OSmsSubmission |
STRING |
Specifies how the IM-SCF arms oSmsSubmission. Possible values:
Default value: INTERRUPTED |
OSmsFailure |
STRING |
Specifies how the IM-SCF arms oSmsFailure. Possible values:
Default value: INTERRUPTED |
You can configure IM-SCF to monitor session duration and charge sessions. IM-SCF provides the following capabilities:
Credit reservation requests generation
IM-SCF sends these requests to IM-OCF through the OE. IM-OCF translates credit reservation requests to Diameter CCRs, which are then forwarded to a billing application.
Session monitoring and charging
You can specify whether a session is monitored by IM-SCF or by an MSC. In the former case, IM-SCF generates an ApplyCharging message based on the Granted-Service-Unit AVP of the CCA received from a billing application. IM-SCF sends this ApplyCharging message to an MSC. Then the MSC applies charging. If the session is monitored by IM-SCF, IM-SCF applies charging on its own.
Quota reauthorization
You can specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
To set up IM-SCF charging services, you use the Charging Services tab. This tab contains the subtabs described in Table 7-8.
Table 7-8 Charging Services Subtabs
Subtab | Description |
---|---|
General |
Enables you to specify how IM-SCF sets up and sends credit reservation requests to the OE. See "General" for more information. |
Reauthorization Triggers |
Enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC. See "Reauthorization Triggers" for more information. |
The General subtab enables you to specify how IM-SCF sets up and sends credit reservation requests to the OE. The OE forwards these requests to an IM-OCF, which translates credit reservation requests to Diameter CCRs, which are then forwarded to a billing application.
Table 7-9 describes the configuration parameters that you need to specify for credit reservation requests.
Name | Type | Description |
---|---|---|
Service Monitoring |
STRING |
Specifies the component that monitors session duration. Possible values:
Default value: None |
First Credit Reservation Request |
STRING |
Specifies when IM-OCF sends the first CCR to a billing application. This request is generated by IM-SCF and sent to IM-OCF through the OE. Possible values:
Default value: Initial |
First Credit Granted Notification |
STRING |
When the Service Monitoring parameter is set to "External" and session duration is monitored by an MSC, the First Credit Granted Notification parameter specifies when IM-SCF sends an ApplyCharging message to the MSC. Possible values:
Default value: Initial |
Start Charging Phase |
STRING |
Specifies when IM-SCF starts charging a session. Possible values:
Default value: Answer |
Requested Duration |
INT |
Specifies the value to which IM-OCF needs to set the CC-time AVP in a CCR sent to a billing application. |
Requested Volume |
INT |
Specifies the value to which IM-OCF needs to set the CC-Total-Octets AVP in a CCR sent to a billing application. |
Requested Service Units |
INT |
Specifies the value to which IM-OCF needs to set the CC-Service-Specific-Units AVP in a CCR sent to a billing application. |
Service Identifier |
INT |
Specifies the value to which IM-OCF needs to set the Service-Identifier AVP in a CCR sent to a billing application. |
Tccd Timeout |
INT |
Specifies the maximum time, in seconds, that IM-SCF waits for a credit reservation response after sending a credit reservation request. If the timeout expires, IM-SCF releases the call. To disable the timeout timer, enter a negative value. |
The Reauthorization Triggers subtab enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
Table 7-10 describes configuration parameters on the Reauthorization Triggers subtab.
Table 7-10 Reauthorization Triggers Parameters
Name | Type | Description |
---|---|---|
Info Received |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Info Received trigger. Possible values:
Default value: Dynamic |
Session Alerted |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Alerted trigger. Possible values:
Default value: Dynamic |
Session Connected |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Connected trigger. Possible values:
Default value: Dynamic |
Session ReInvite Complete |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session ReInvite Complete trigger. Possible values:
Default value: Dynamic |
Session Reinvited |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Reinvited trigger.
Default value: Dynamic |
Session Update Complete |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Update Complete trigger.
Default value: Dynamic |
Session Updated |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Updated trigger.
Default value: Dynamic |
The Media Resources subtab enables you to define the media resources that the SSP can connect in order to play announcements.
The table in the Media Resources subtab displays the media resources that are used to play announcements. Each row represents one media resource. When defining a new media resource, you need to specify the fields described in Table 7-11.
Table 7-11 IM-SCF CAP Phase 3 Media Resource Definition Fields
Name | Type | Description |
---|---|---|
Name |
STRING |
Specifies a name of the media resource |
Alias |
STRING |
Specifies a unique identifier that applications use to instruct Service Broker which media resource to connect in order to play announcements. Aliases are defined in a URI format and must contain the number of the MRF. For example: mrf.12345@domain.com. To specify a generic alias that fits a range of aliases, you can use the question mark character (?). A question mark can be substituted by a number. For example, if you set the Alias parameter to mrf.1234????@network.com, this alias fits any alias in the range from mrf.12340000@network.com to mrf.12349999@ network.com. |
Address Digits |
STRING |
Specifies the digits part of the media resource address. The media resource address is used to set up a connection towards the media resource. Note: when this parameter is not set, the network's session control entity uses a pre-configured media resource to play announcements. In this case, Nature of Address and Address Numbering Plan Indicator should be set to 'None'. |
Nature of Address |
STRING |
Specifies the NatureOfAddress part of the media resource address. The media resource address is used to set up a connection towards the media resource. Possible values:
Default value: SUBSCRIBER_NUMBER |
Address Numbering Plan Indicator |
STRING |
Specifies the NumberingPlanInd part of the media resource address. The media resource address is used to set up a connection towards the media resource. Possible values:
Default value: ISDN |
Numbering Qualifier |
STRING |
Specifies the numbering qualifier of the media resource address. Possible values:
Default value: NONE |
Number Screening |
STRING |
Specifies the numbering screening of the media resource address. Possible values:
Default value: UNDEFINED |
Presentation Restriction |
STRING |
Specifies the presentation restriction of the media resource address. Possible values:
Default value: UNDEFINED |
Operation Type |
STRING |
Possible values:
Default value: internal |
Answer Indication |
BOOL |
Specifies how to set the ServiceInteractionIndicatorTwo.bothway ThroughConnectionInd parameter in ETC and CTR operations in order to specify whether IM-SCF needs to request opening of the voice channel in both directions or in one direction only. Possible values:
|
Note:
When an internal media resource is used (CTR), the Address Digits, Nature of Address and Address Numbering Plan Indicator parameters can be set to 'None' in order to instruct the network's session control entity to connect its pre-configured media resource.The TCAP subtab enables you to set up parameters of the IM TCAP layer.
Table 7-12 describes configuration parameters on the TCAP subtab.
Name | Type | Description |
---|---|---|
Class4 Default Timeout in Seconds |
INT |
Specifies the time period in seconds that the IM waits for possible REJECT. The timer starts when sending INVOKE for class 4 operations. Default value: 5 seconds. |
Reject Timeout in Seconds |
INT |
Specifies the time period in seconds that the IM waits for possible REJECT. The timer starts when sending INVOKE for class 1-3 operations. |
Activate Invoke Alarm in Application Layer |
BOOL |
When the TCAP layer receives an INVOKE, it triggers back PABORT if there is no response. The waiting time period for response is configured in the encoding library. The Activate Invoke Alarm in Application Layer parameter specifies whether or not to activate this timer. Possible values:
Default value: False. |
Application Part Guard Timer |
INT |
Specifies the PSM timer, which is a timer for incoming operations. The PSM timer defines the maximum time in seconds that the application (TC-User) has to respond to incoming INVOKE messages. |
Result Split Length |
INT |
Specifies the maximum length of the TCAP RESULT message. When the actual length of the message exceeds the specified value, the message is split. |
The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-SCF. For more information about configuring monitoring, see "Configuring Monitoring with the Administration Console".
Service Broker provides a set of MBeans that provide attributes and operations for configuring the IM-SCF CAP phase 3 through JMX. Figure 7-1 shows the hierarchy of the IM-SCF CAP 3 MBeans.
The following sections provide reference information for the IM-SCF CAP phase 3 configuration MBeans.
Note:
MBeans described in this guide may include additional advanced attributes, which are not described in the guide. Advanced attributes are reserved for internal use. Do not change these attributes.The following MBeans are common for all components of Service Broker and described in "Configuring Monitoring with Java MBeans":
MonitoringGeneralMBean
ThresholdCrossedNotificationRulesMBean
ThresholdCrossedNotificationRuleMBean
StateChangedNotificationRulesMBean
StateChangedNotificationRuleMBean
ImscfCap3MBean is a root MBean for the IM-SCF CAP phase 3 configuration.
Created automatically
None
ObjectName getGeneral()
Gets a reference to the instance of GeneralMBean
ObjectName getCallHandling()
Gets a reference to the instance of CallHandlingMBean
ObjectName getInTriggering()
Gets a reference to the instance of InTriggeringMBean
ObjectName getMonitoringGeneral()
Gets a reference to the instance of MonitoringGeneralMBean
ObjectName getThresholdCrossedNotificationRules()
Gets a reference to the instance of ThresholdCrossedNotificationRulesMBean
ObjectName getStateChangedNotificationRules()
Gets a reference to the instance of StateChangedNotificationRulesMBean
ObjectName getMediaResources()
Gets a reference to the instance of MediaResourcesMBean
ObjectName getTcap()
Gets a reference to the instance of TcapMBean
GeneralMBean enables you to specify an alias for an Interworking Module instance.
Created automatically
Alias
For more information on this attribute, see Table 7-2.
None
CallHandlingMBean enables you to configure how a call is handled.
Created automatically
OeReactionInterval
ResetTimerIntervalInSeconds
UiResetTimerIntervalInSeconds
BodyEncodingFormat
ActivityTestIntervalInSeconds
RrbcsmAccumulationMode
WaitForAssistRequestInstructionsAfterEstablishTemporaryConnection
AssistRequestInstructionsWaitingIntervalInSeconds
gsmSCFAddress
For more information on these attributes, see Table 7-3.
None
InTriggeringMBean enables you to define the IN triggers that the IM-SCF arms in the underlying session control entity and specify additional parameters.
Created automatically
None
ObjectName getOBcsmDp()
Returns a reference to the instance of OBcsmDpMBean
ObjectName createOBcsmDp()
Creates a new instance of OBcsmDpMBean
void destroyOBcsmDp()
Destroys an existing instance of OBcsmDpMBean
ObjectName lookupOBcsmDp()
Returns a specified instance of OBcsmDpMBean
ObjectName getTBcsmDp()
Returns a reference to the instance of TBcsmDpMBean
ObjectName createTBcsmDp()
Creates a new instance of TBcsmDpMBean
void destroyTBcsmDp()
Destroys an existing instance of TBcsmDpMBean
ObjectName lookupTBcsmDp()
Returns a specified instance of TBcsmDpMBean
ObjectName getOSmsDp()
Returns a reference to the instance of OSmsDpMBean
ObjectName createOSmsDp()
Creates a new instance of OSmsDpMBean
void destroyOSmsDp()
Destroys an existing instance of OSmsDpMBean
ObjectName lookupOSmsDp()
Returns a specified instance of OSmsDpMBean
OBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call origination side (O-BCSM).
InTriggering.createOBcsmDp()
RouteSelectFailure
OCalledPartyBusy
ONoAnswer
OAnswer
ODisconnect
OAbandon
ODisconnectLeg
For more information on these attributes, see Table 7-5.
None
TBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call termination side (T-BCSM).
InTriggering.createTBcsmDp()
TBusy
TNoAnswer
TAnswer
TDisconnect
TAbandon
TDisconnectLeg
For more information on these attributes, see Table 7-6.
None
OSmsDpMBean enables you to configure DPs that the IM-SCF arms on the SMS origination side (O-SMS).
InTriggering.createOSmsDp()
OSmsSubmission
OSmsFailure
For more information on these attributes, see Table 7-7.
None
ChargingServiceMBean enables you to define how IM-SCF sends credit reservation requests and to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
Created automatically
ServiceMonitoring
FirstCreditReservationRequest
FirstCreditGrantedNotification
StartChargingPhase
RequestedDuration
RequestedVolume
RequestedServiceUnits
ServiceIdentifier
TccdTimeout
For more information on these attributes, see Table 7-9.
None
ReAuthorizationTriggerTableMBean is a container for instances of ReAuthorizationTriggerTableEntryMBean. Each instance of ReAuthorizationTriggerTableEntryMBean represents a single reauthorization trigger that an MSC sends to IM-SCF.
Created automatically.
None
ObjectName[] getReAuthorizationTriggerTableEntry()
Returns an array of references to instances of ReAuthorizationTriggerTableEntryMBean
ObjectName createReAuthorizationTriggerTableEntry()
Creates a new instance of ReAuthorizationTriggerTableEntryMBean
void destroyReAuthorizationTriggerTableEntry()
Destroys an existing instance of ReAuthorizationTriggerTableEntryMBean
ObjectName lookupReAuthorizationTriggerTableEntry()
Gets a reference to the instance of ReAuthorizationTriggerTableEntryMBean
ReAuthorizationTriggerTableMBean enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
ReAuthorizationTriggerTable.createReAuthorizationTriggerTableEntry()
Info Received
Session Alerted
Session Connected
SessionReInviteComplete
SessionUpdateComplete
Session Reinvited
Session Update Complete
Session Updated
For more information about these attributes, see Table 7-10.
None
MediaResourcesMBean is a container for instances of MediaResourceMBean. Each instance of MediaResourceMBean represents a single media resource to which an SSP can connect.
Created automatically
None
ObjectName[] getMediaResource()
Returns an array of references to instances of MediaResourceMBean
ObjectName createMediaResourceMBean()
Creates a new instance of MediaResourceMBean
void destroyMediaResourceMBean()
Destroys an existing instance of MediaResourceMBean
ObjectName lookupMediaResourceMBean()
Gets a reference to the instance of MediaResourceMBean
Each instance of MediaResourceMBean represents one media resource to which an SSP can connect to play announcements.
MediaResources.createMediaResource()
Name
Alias
AddressDigits
NatureOfAddress
AddressNumberingPlanIndicator
NumberingQualifier
NumberScreening
PresentationRestriction
OperationType
AnswerIndication
For more information on these attributes, see Table 7-11.
None
TcapMBean enables you to configure the TCAP layer of the module.
Created automatically
Class4DefaultTimeoutInSeconds
RejectTimeoutInSeconds
ActivateInvokeAlarmInApplicationLayer
ApplicationPartGuardTimer
ResultSplitLength
For more information on these attributes, see Table 7-12.
None