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 INAP CS-1 by using the Service Broker Administration Console.
To access the IM-SCF INAP CS-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 INAP CS-1 configuration pane contains the subtabs described in Table 9-1.
Table 9-1 IM-SCF INAP CS-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 define the way that IM-SCF handles calls. See "Configuring Call Handling Parameters" for more information. |
IN Triggering |
Enables you to define the IN triggers that the IM-SCF arms in the underlying session control entity. See "Configuring IN Triggering Parameters" 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 9-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 9-3 describes configuration parameters on the Call Handling subtab.
Table 9-3 IM-SCF INAP CS-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 |
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. |
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 |
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 9-4.
Table 9-4 IM-SCF INAP CS1 Triggering Subtabs
Subtab | Description |
---|---|
O-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call origination side. See "Configuring DPs on the Call Origination Side" for more information. |
T-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call termination side. See "Configuring DPs on the Call Termination Side" for more information. |
Initial Call Attempt |
Enables you to configure how DPs that the IM-SCF arms upon receiving the InitiateCallAttempt message. See "Configuring DPs for Initial Call Attempt Message" for more information. |
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 9-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 9-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 for Initial Call Attempt Message
The Initiate Call Attempt subtab enables you to configure how DPs that the IM-SCF arms upon receiving the InitiateCallAttempt message.
Table 9-7 describes configuration parameters on the Initiate Call Attempt subtab.
Table 9-7 Initial Call Attempt DPs
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 |
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 9-8.
Table 9-8 IM-SCF INAP CS-1 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. For example: mrf.network@domain.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 |
Operation Type |
STRING |
Possible values:
Default value: internal |
Service Interaction Indicators |
STRING |
Specifies the ServiceInteractionIndicators parameter in the ConnectToResource operation. Provide the value of the Service Interaction Indicators parameter as a hex string. For example, a two octet long string is represented as 03A5. If you leave this parameter empty or set it to "none", IM-SCF does not add ServiceInteractionIndicators to ConnectToResource. |
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 9-9 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 INAP CS-1 through JMX. Figure 9-1 shows the hierarchy of the IM-SCF INAP CS-1 MBeans.
The following sections provide reference information for the IM-SCF INAP CS-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
ImscfCs1MBean is a root MBean for the IM-SCF INAP CS-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 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 9-2.
None
CallHandlingMBean enables you to configure how a call is handled.
Created automatically
OeReactionInterval
ResetTimerIntervalInSeconds
UiResetTimerIntervalInSeconds
BodyEncodingFormat
RrbcsmAccumulationMode
WaitForAssistRequestInstructionsAfterEstablishTemporaryConnection
AssistRequestInstructionsWaitingIntervalInSeconds
gsmSCFAddress
For more information on these attributes, see Table 9-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 getIcaDp()
Returns a reference to the instance of IcaDpMBean
ObjectName createIcaDp()
Creates a new instance of IcaDpMBean
void destroyIcaDp()
Destroys an existing instance of IcaDpMBean
ObjectName lookupIcaDp()
Returns a specified instance of IcaDpMBean
OBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call origination side (O-BCSM).
InTriggering.createOBcsmDp()
routeSelectFailure
OCalledPartyBusy
ONoAnswer
OTermSeized
OAnswer
ODisconnect
OAbandon
ODisconnectLeg
For more information on these attributes, see Table 9-5.
None
TBcsmDpMBean enables you to configure DPs that the IM-SCF arms on the call termination side (T-BCSM).
InTriggering.createTBcsmDp()
TBusy
TNoAnswer
CallAccepted
TAnswer
TDisconnect
TAbandon
TDisconnectLeg
For more information on these attributes, see Table 9-6.
None
IcaDpMBean enables you to configure DPs that the IM-SCF arms upon receiving the InitiateCallAttempt message.
InTriggering.createIcaDp()
RouteSelectFailure
OCalledPartyBusy
ONoAnswer
OTermSeized
OAnswer
ODisconnect
For more information on these attributes, see Table 9-7.
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
OperationType
ServiceInteractionIndicators
For more information on these attributes, see Table 9-8.
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 9-9.
None