10 Configuring IM-SCF WIN Phase 1

The following sections describe how to configure IM-SCF using the Service Broker Administration Console and Java MBeans.

Configuring IM-SCF WIN Phase 1 with the Administration Console

This section describes how to configure the IM-SCF WIN phase 1 by using the Service Broker Administration Console.

To access the IM-SCF WIN 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 WIN phase 1 configuration pane contains the subtabs described in Table 10-1.

Table 10-1 IM-SCF WIN 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 define the way that IM-SCF handles calls. For more information, see "Configuring Call Handling Parameters".
Media Resources	Enables you to set up the media resources that Service Broker uses to play announcements. For more information, see "Configuring Media Resources Parameters".
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. For more information, see "Configuring Monitoring Parameters".

Configuring General Parameters

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 10-2 describes the configuration parameter on the General subtab.

Table 10-2 General Parameter

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.

Configuring Call Handling Parameters

The Call Handling subtab enables you to define how IM-SCF handles calls.

Table 10-3 describes configuration parameters on the Call Handling subtab.

Table 10-3 IM-SCF WIN 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: BER XER None Default value: None In an IN mediation solution, when IM-SCF is coupled with IM-SSF, this parameter must be set to XER.
UI Reset Timer Interval in Seconds	INT	Specifies the value, in seconds, of the WIN REST timer. The timer is first triggered upon invocation of ConnectRersource operation. Whenever the timer expires, IM-SCF invokes the ResetTimer operation towards the MSC (reset SSFT) and triggers the timer again. Default value: 20

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:

BER
XER
None

Default value: None

In an IN mediation solution, when IM-SCF is coupled with IM-SSF, this parameter must be set to XER.

UI Reset Timer Interval in Seconds

INT

Specifies the value, in seconds, of the WIN REST timer.

The timer is first triggered upon invocation of ConnectRersource operation. Whenever the timer expires, IM-SCF invokes the ResetTimer operation towards the MSC (reset SSFT) and triggers the timer again.

Default value: 20

Configuring Media Resources Parameters

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 10-4.

Table 10-4 IM-SCF WIN Phase 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 IM-SCF which media resource to connect in order to play announcements. Alias is used by IM-SCF to lookup a media resource details in this table. 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'.
Operation Type	STRING	Possible values: Switched_Based: the media resource is internal part of the SSP. CCDIR operation is used to connect the media resource. External: The media resource not a part of the SSP. ConnectResource operation is used to connect the media resource.
Resource Type	STRING	Specifies the value to set in the SpecializedResource parameter of the SEIZERES operation.
Private Resource Type	STRING	Specifies the value to set in the PrivateSpecializedResource parameter of the SEIZERES operation
SN-IP Configuration	STRING	Possible values: SN IP and SCP are co-located. When you choose this option, you need to set also the SN Address parameter. IP IP and SCP are not co-located None
SN Address	STRING	Specifies the value to set in the DestinationDigits parameter of the CONNRES operation. This value is regarded only when SN-IP Configuration parameter is set to SN.

Configuring TCAP Parameters

The TCAP subtab enables you to set up parameters of the IM TCAP layer.

Table 10-5 describes configuration parameters on the TCAP subtab.

Table 10-5 TCAP Parameter

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: True False 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.

Configuring Monitoring Parameters

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".

Configuring IM-SCF WIN Phase 1 with Java MBeans

Service Broker provides a set of MBeans that provide attributes and operations for configuring the IM-SCF WIN phase 1 through JMX. Figure 10-1 shows the hierarchy of the IM-SCF WIN phase 1 MBeans.

Figure 10-1 IM-SCF WIN Phase 1 MBeans Hierarchy

The following sections provide reference information for the IM-SCF WIN 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

ImscfWin1MBean

ImscfWin1MBean is a root MBean for the IM-SCF WIN phase 2 configuration.

Factory Method

Created automatically

Attributes

None

Operations

ObjectName getGeneral()

Gets a reference to the instance of GeneralMBean

ObjectName getCallHandling()

Gets a reference to the instance of CallHandlingMBean

ObjectName getTriggering()

Gets a reference to the instance of TriggeringMBean

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

GeneralMBean enables you to specify an alias for an Interworking Module instance.

Factory Method

Created automatically

Attributes

Alias

For more information on this attribute, see Table 10-2.

Operations

None

CallHandlingMBean

CallHandlingMBean enables you to configure how a call is handled.

Factory Method

Created automatically

Attributes

OeReactionTimerInterval
BodyEncodingFormat
UIResetTimerIntervalinSeconds

For more information on these attributes, see Table 10-3.

Operations

None

MediaResourcesMBean

MediaResourcesMBean is a container for instances of MediaResourceMBean. Each instance of MediaResourceMBean represents a single media resource to which an SSP can connect.

Factory Method

Created automatically

Attributes

None

Operations

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

MediaResourceMBean

Each instance of MediaResourceMBean represents one media resource to which an SSP can connect to play announcements.

Factory Method

MediaResources.createMediaResource()

Attributes

Name
Alias
AddressDigits
OperationType
SnAddress
SnIpConfiguration
ResourceType
PrivateResourceType
AnswerIndication

For more information on these attributes, see Table 10-4.

Operations

None

Tcap MBean

TcapMBean enables you to configure the TCAP layer of the module.

Factory Method

Created automatically

Attributes

Class4DefaultTimeoutInSeconds
RejectTimeoutInSeconds
ActivateInvokeAlarmInApplicationLayer
ApplicationPartGuardTimer
ResultSplitLength

For more information on these attributes, see Table 10-5.

Operations

None