13 Setting Up IM-SSF INAP CS-1

This chapter describes how to set up an IM-SSF INAP CS-1 interworking module.

About IM-SSF INAP CS-1 Setup

The process of IM-SSF INAP CS-1 setup requires the following:

Adding an IM-SSF INAP CS-1 to your Oracle Communications Service Broker deployment. You can add as many modules of type IM-SSF INAP CS-1 as you need. See "Adding an IM-SSF INAP CS-1 3 to the Service Broker Deployment" for more information.
Configuring the IM-SSF INAP CS-1. See "Configuring an IM-SSF INAP CS-1" for more information.

Adding an IM-SSF INAP CS-1 3 to the Service Broker Deployment

To add an IM-SSF INAP CS-1:

In the domain navigation pane, expand the OCSB node.
Expand the Processing Tier node.
Expand the Interworking Modules node.
Select IM Management.
On the bottom of the IM Management pane, click New.
In the New window, fill out the fields as follows:
- In the Type list, select IMSSFCS1.
- In the Version list, select the required version.
- In the Name field, enter a name for this module as it should appear in the list of modules. In this field, you can only use lower case letters (a-z), upper case letters (A-Z), numbers (0-9), and underscores (_). If you attempt to use a character which is not allowed, Service Broker displays the error message and prompts you to enter a different name.
Click OK.
In the notification window that reminds you to commit the changes, click OK.
To add the new IM-SSF INAP CS-1 to your deployment, in the Change Center pane, click Commit.

A new module of type IM-SSF INAP CS-1 is now added to your Service Broker deployment. The new module is displayed in the domain navigation pane under the Interworking Modules node.

Configuring an IM-SSF INAP CS-1

To configure an IM-SSF INAP CS-1:

In the Change Center, click Lock & Edit.

In the domain navigation pane, under the Interworking Modules node, select the newly added IM-SSF INAP CS-1.

The IM-SSF INAP CS-1 configuration pane contains the subtabs described in Table 13-1.

Table 13-1 IM-SSF INAP CS-1 Configuration Subtabs

Subtab	Description
General	Enables you to configure general parameters for an Interworking Module instance. See "Configuring General Parameters" for more information.
Call Handling	Enables you to configure how the IM-SSF handles calls. See "Configuring Call Handling Parameters" for more information.
Subscriber Data	Enables you to define IN triggers that the IM-SSF invokes towards the SCP above. See "Configuring Subscriber Data Parameters" for more information.
Operation Propagation	Enables you to define whether the IM-SSF processes operations on its own or propagates these operations to another module. See "Configuring Operation Propagation 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-SSF. 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.

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

Table 13-2 General Parameters

Name	Type	Description
Alias	STRING	Specifies an alias of the IM instance. Using this alias, the SS7 SSU recognizes the instances of the IMs to which incoming messages should be routed. For more information on how the SS7 SSU uses aliases and how to configure incoming routing in the SS7 SSU, see the discussion on configuring the SS7 Signaling Server Unit for SIGTRAN in Oracle Communications Service Broker Signaling Server Units Configuration Guide.
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.

Name

Type

Description

Alias

STRING

Specifies an alias of the IM instance.

Using this alias, the SS7 SSU recognizes the instances of the IMs to which incoming messages should be routed. For more information on how the SS7 SSU uses aliases and how to configure incoming routing in the SS7 SSU, see the discussion on configuring the SS7 Signaling Server Unit for SIGTRAN in Oracle Communications Service Broker Signaling Server Units Configuration Guide.

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 the IM-SSF handles calls.

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

Table 13-3 IM-SSF INAP CS-1 Call Handling Parameters

Name	Type	Description
IM-SSF Mode of Operation	STRING	Specifies the IM-SSF mode of operation. Possible values: DYNAMIC IM-SSF dynamically changes its call control mode, according to the mode requested by the SCP. BACK_TO_BACK IM-SSF monitors calls and ignores the mode requested by the SCP. REDIRECT IM-SSF does not monitor calls and ignores the mode requested by the SCP. Default value: DYNAMIC
Session Case	STRING	Specifies how IM-SSF treats sessions that arrive on the southbound interface, from the OE. Possible values: ORIG All calls are treated as originating calls. TERM All calls are treated as terminating calls. DYNAMIC Calls are treated dynamically as either originating or terminating calls, depending on the SAL Route header and/or the x-wcs-session-case header generated by a southbound Service Broker IM. Default value: DYNAMIC
Tssf Duration in Seconds	INT	Specifies the value, in seconds, of the IM-SSF Tssf timer. Default value: 20
Tssf User Interaction Duration in Seconds	INT	Specifies the value, in seconds, of the IM-SSF Tssf timer. This parameter is used when the IM-SSF is in the middle of interaction with a media resource. Default value: 1200
IM-SSF Media Capability	BOOL	Specifies whether or not the underlying network supports IP/SRF/MRF. This determines if the IM-SSF can handle media-related operations, such as EstablishTemporaryConnection or ConnectToResource. Possible values: True False Default value: True
Body Encoding Format	STRING	Specifies the method that the IM-SSF uses to encode IN parameters in the body of a SAL message. Possible options: BER XER NONE Default value: NONE
Nature of Address of Called Party Number	STRING	Specifies how to set the NatureOfAddress of the CalledPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: SUBSCRIBER_NUMBER UNKNOWN NATIONAL INTERNATIONAL NETWORK_SPECIFIC Default value: NATIONAL
Internal Network Number Indicator of Called Party Number	BOOL	Specifies how to set the InternalNetworkNumberIndicator of the CalledPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: True False Default value: True
Numbering Plan Indicator of Called Party Number	STRING	Specifies how to set the NumberingPlanIndicator of the CalledPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: ISDN DATA TELEX Default value: DATA
Nature of Address of Calling Party Number	STRING	Specifies how to set the NatureOfAddress of the CallingPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: SUBSCRIBER_NUMBER UNKNOWN NATIONAL INTERNATIONAL NETWORK_SPECIFIC Default value: NATIONAL
Number Incomplete Indicator of Calling Party Number	BOOL	Specifies how to set the IncompleteIndicator of the CallingPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible options: True False Default value: True
Numbering Plan Indicator of Calling Party Number	STRING	Specifies how to set the NumberingPlanIndicator of the CallingPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: ISDN DATA TELEX Default value: ISDN
Screening Indicator of Calling Party Number	STRING	Specifies how to set the NumberingPlanIndicator of the CallingPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: USER_PROVIDED_NOT_VERIFIED USER_PROVIDED_VERIFIED_PASSED USER_PROVIDED_VERIFIED_FAILED NETWORK_PROVIDED Default values: USER_PROVIDED_NOT_VERIFIED
Calling Party Category	STRING	Specifies how to set the CallingNumberCategory of the CallingPartyNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: UNKNOWN LANGUAGE_FRENCH LANGUAGE_ENGLISH LANGUAGE_GERMAN LANGUAGE_RUSSIAN Default value: LANGUAGE_ENGLISH
Type of Number of Called Party Number	STRING	Specifies how to set the TypeOfNumber of the CalledPartyBCDNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: Unknown InternationalNumber NationalNumber NetworkSpecificNumber DedicatedAccessShortcode Default value: NationalNumber
Numbering Plan Indicator of Called Party BCD Number	STRING	Specifies how to set the NumberingPlanIndicator of the CalledPartyBCDNumber. This parameter is used when the IM-SSF sends a new InitialDP message to the SCP. Possible values: Unknown ISDN_TelephonyNumberingPlan DataNumberingPlan TelexNumberingPlan NationalNumberingPlan Default value: DataNumberingPlan

Configuring Subscriber Data Parameters

The Subscriber Data subtab enables you to define IN triggers that IM-SSF invokes towards the SCP above.

The table on the Subscriber Data subtab displays the rules for invoking triggers. Each row represents one rule. When defining a new rule, you need to specify the fields described in Table 13-4.

Table 13-4 IM-SSF INAP CS-1 Subscriber Data Fields

Name	Type	Description
Name	STRING	A unique identifier.
IMSI	STRING	Specifies a condition on session IMSI. When the condition is met, IM-SSF invokes triggers towards the SCP. To apply the rule for all IMSIs, set this parameter to default (case sensitive).
MSISDN	STRING	Specifies a condition on session MSISDN. When the condition is met, IM-SSF invokes triggers towards the SCP. To apply the rule for all MSISDNs, set this parameter to default (case sensitive).
Service Key	STRING	Specifies a Service Key to set on the trigger to the SCP.
SCP Address Alias	STRING	Specifies the SCP to which IM-SSF invokes a trigger. This is an alias to one of the SCCP addresses specified in the SS7 SSU configuration.
Default Call Handling	STRING	Specifies how IM-SSF handles a call when a signal between IM-SSF and SCP fails (that is invokes a trigger towards the failed SCP). Possible values: CONTINUE_CALL RELEASE_CALL Default value: CONTINUE_CALL
TDP List	STRING_LIST	Specifies a list of TDPs that must be triggered. Each trigger is specified in the following format: id=type where: id is one of the following 2: COLLECTED_INFO 3: ANALYSED_INFORMATION 4: ROUTE_SELECT_FAILURE 12: TERMINATING_ATTEMPT_AUTHORISED 13: T_BUSY 14: T_NO_ANSWER type is one of the following: R, which means Interrupt N, which means Notify 13=R, 14=N

Configuring Operation Propagation Parameters

The Operation Propagation parameters subtab enables you to define whether the IM-SSF processes operations on its own or propagates these operations to another module.

The table on the Operation Propagation subtab displays a list of operations. Each row represents one operation for which you define whether IM-SSF processes this operation or propagates the operation to another module. When configuring a new operation, you need to specify the fields described in Table 13-5.

Table 13-5 IM-SSF INAP CS1 Operation Propagation

Name	Type	Description
Name	STRING	Specifies a unique identifier.
Operation	STRING	Specifies an operation. Possible values: RequestReportBCSMEvent PlayAnnouncement PromptAndCollect
Module name	STRING	Specifies a name of a module instance to which an operation is propagated.
Enable Propagation	BOOL	Specifies whether IM-SSF processes operations on its own or propagates a request to the session control layer. Possible values: True The IM-SSF propagates RRBCSMEvent operations. False The IM-SSF processes RRBCSMEvent operations. Default value: True

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 13-6.

Table 13-6 IM-SSF 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 to 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.
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: SUBSCRIBER_NUMBER UNKNOWN NATIONAL INTERNATIONAL NETWORK_SPECIFIC 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: ISDN DATA TELEX Default value: ISDN
Operation Type	STRING	Possible values: internal The media resource is internal part of the SSP. ConnectToResource (CTR) operation is used to connect the media resource. external The media resource not a part of the SSP. EstablishTemporaryConnection (ETC) is used to connect the media resource. Default value: internal
Service Interaction Indicators	STRING	Specifies the value of ServiceInteractionIndicators to include in ConnectToResource operations. If set to the string 'none', or left empty no ServiceInteractionIndicators parameter is included. Specify value as a hex string. For example, a 2 octet string is specified as 'O3A5'.

Configuring TCAP Parameters

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

Table 13-7 describes configuration parameters on the TCAP subtab.

Table 13-7 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
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. Default value: 1000
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. Default value: 200
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
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. Default value: 512

Configuring Monitoring Parameters

The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-SSF. For more information about configuring monitoring, see "Configuring Service Broker Monitoring" in "Monitoring Service Broker Using Runtime MBeans" in Oracle Communications Service Broker System Administrator's Guide.