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 1 using the Service Broker Administration Console.
To access the IM-SCF CAP phase 1 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 1 configuration pane contains the subtabs described in Table 5-1.
Table 5-1 IM-SCF CAP Phase 1 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 configure how IM-SCF handles calls. For more information, see "Configuring Call Handling Parameters". |
IN Triggering |
Enables you to define the IN triggers that the 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. |
TCAP |
Enables you to set up the TCAP layer of the IM-SCF. For more information, see "Configuring TCAP Parameters". |
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 and decode SS7 messages and enables you to specify an alias for an IM instance.
Table 5-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 the 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 and decode SS7 messages. |
The Call Handling subtab enables you to define how IM-SCF handles calls.
Table 5-3 describes configuration parameters on the Call Handling subtab.
Table 5-3 IM-SCF CAP Phase 1 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 |
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. |
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 the Reset Timer Interval in Seconds parameter, this parameter is used when IM-SCF is in the middle of interaction with a media resource. Default value: 10000 |
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 a 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. |
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 5-4.
Table 5-4 IM-SCF CAP1 N 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". |
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 5-5 describes configuration parameters on the O-BCSM subtab.
Table 5-5 IM-SCF CAP Phase 1 O-BCSM DPs
Name | Type | Description |
---|---|---|
OAnswer |
STRING |
Specifies how the IM-SCF arms oAnswer. Possible values:
Default value: NOTIFY_AND_CONTINUE |
ODisconnect |
STRING |
Specifies how the IM-SCF arms oDisconnect. Possible values:
Default value: INTERRUPTED |
O Disconnect 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 5-6 describes configuration parameters on the T-BCSM subtab.
Table 5-6 IM SCF CAP Phase 1 T-BCSM DPs
Name | Type | Description |
---|---|---|
TAnswer |
STRING |
Specifies how the IM-SCF arms tAnswer. Possible values:
Default value: NOTIFY_AND_CONTINUE |
TDisconnect |
STRING |
Specifies how the IM-SCF arms tDisconnect. Possible values:
Default value: INTERRUPTED |
TDisconnect Leg |
STRING |
Specifies a leg on which the tDisconnect DP is armed. Possible values:
Default value: 1,2 |
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
IM-SCF monitors and charges a session 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 5-7.
Table 5-7 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 5-8 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 |
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 5-9 describes configuration parameters on the Reauthorization Triggers subtab.
Table 5-9 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 TCAP subtab enables you to set up parameters of the IM TCAP layer.
Table 5-10 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 1 through JMX. Figure 5-1 shows the hierarchy of the IM-SCF CAP 1 MBeans.
The following sections provide reference information for the IM-SCF CAP phase 1 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
ImscfCap1MBean is a root MBean for the IM-SCF CAP phase 1 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 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 5-2.
None
CallHandlingMBean enables you to configure how a call is handled.
Created automatically
OeReactionIntervalInSeconds
BodyEncodingFormat
ActivityTestIntervalInSeconds
ResetTimerIntervalInSeconds
UiResetTimerIntervalInSeconds
RrbcsmAccumulationMode
WaitForAssistRequestInstructionsAfterEstablishTemporaryConnection
AssistRequestInstructionsWaitingIntervalInSeconds
For more information on these attributes, see Table 5-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
OBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call origination side (O-BCSM).
InTriggering.createOBcsmDp()
OAnswer
ODisconnect
ODisconnectLeg
For more information on these attributes, see Table 5-5.
None
TBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call termination side (T-BCSM).
InTriggering.createTBcsmDp()
TAnswer
TDisconnect
TDisconnectLeg
For more information on these attributes, see Table 5-6.
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
StartChargingPhase
RequestedDuration
RequestedVolume
RequestedServiceUnits
ServiceIdentifier
TccdTimeout
For more information on these attributes, see Table 5-8.
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 5-9.
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 5-10.
None