28 Setting Up IM-PSX GSM MAP

This chapter describes how to set up an IM-PSX GSM MAP interworking module.

About IM-PSX GSM MAP Setup

The process of IM-PSX GSM MAP setup requires the following:

1. Adding an IM-PSX GSM MAP to your Oracle Communications Service Broker deployment. You can add as many modules of type IM-PSX GSM MAP as you need. See "Adding an IM-PSX GSM MAP to the Service Broker Deployment" for more information.

2. Configuring the IM-PSX GSM MAP. See "Configuring an IM-PSX GSM MAP" for more information.

Adding an IM-PSX GSM MAP to the Service Broker Deployment

To add an IM-PSX GSM MAP:

1. In the domain navigation pane, expand the OCSB node.

2. Expand the Processing Tier node.

3. Expand the Interworking Modules node.

4. Select IM Management.

5. On the bottom of the IM Management pane, click New.

6. In the New window, fill out the fields as follows:

   • In the Type list, select IMPSXGSM.

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

7. Click OK.

8. In the notification window that reminds you to commit the changes, click OK.

9. To add the new IM-PSX GSM MAP to your deployment, in the Change Center pane, click Commit.

   A new module of type IM-PSX GSM MAP 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-PSX GSM MAP

To configure an IM-PSX GSM MAP:

1. In the Change Center, click Lock & Edit.

2. In the domain navigation pane, under the Interworking Modules node, select the newly added IM-PSX GSM MAP.

   The IM-PSX GSM MAP configuration pane contains the tabs described in Table 28-1.

   Table 28-1 IM-PSX Configuration Subtabs

   Tab	Description
   General	Enables you to configure general parameters for an Interworking Module instance. See "Configuring General Parameters" for more information.
   SIP Subscription	Enables you to configure the SIP SUBSCRIBE and SIP NOTIFY interface that IM-PSX exposes to SIP applications. See "Configuring the SIP Subscription Parameters" for more information.
   Map Handling	Enables you to configure the IM-PSX MAP interface. See "Configuring the Map Handling Parameters" for more information.
   TCAP	Enables you to set up parameters of the IM TCAP layer. See "Configuring TCAP Parameters" for more information.
   Monitoring	Enables you to define the way that Runtime MBeans and notifications operate. See "Configuring Monitoring Parameters" for more information.

   
   

Configuring General Parameters

The General tab 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 28-2 describes the configuration parameter in the General tab.

Table 28-2 IM-PSX General Parameter

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. Default value: com.convergin.common.ase.plugin.oss.map.phase2plus.OssGsmMapPlugin

Configuring the SIP Subscription Parameters

The SIP Subscription tab enables you to configure the SIP SUBSCRIBE and SIP NOTIFY interface that IM-PSX exposes to SIP applications.

The SIP Subscription tab contains the subtabs described in Table 28-3.

Table 28-3 SIP Subscription Tabs

Subtab	Description
General	Enables you to set up a pending NOTIFY message and define a PSX SIP domain. See "General" for more information.
Accept Header	Enables you to select allowed values to which a SIP application can set the Accept header. See "Accept Header" for more information.

General

The General subtab enables you to set up a pending NOTIFY message and define a PSX SIP domain.

Table 28-4 describes the configuration parameters on the General subtab.

Table 28-4 General Parameters

Name	Type	Description
Generate Pending NOTIFY	BOOL	Specifies whether or not Service Broker needs to generate a SIP NOTIFY message with the Subscription-State set to pending together with an empty body when a new subscription is created and the terminal state is still unknown. Possible values: TRUE FALSE Default value: TRUE
PSX SIP Domain	STRING	Specifies a SIP domain name for IM-PSX. The application can use this value in the domain part of the RequestURI header and the To header to refer a request to a specific SS7 entity whose alias is configured in DefaultSS7EntityAlias. Default value: ocsb-psx.net

Accept Header

The Accept subtab enables you to select formats of the body message that IM-PSX supports.

The Accept subtab contains a table in which each row represents one of the formats that SIP applications are allowed to set in the Accept header of SIP SUBSCRIBE messages. When setting up a format, you need to specify the values described in Table 28-5.

Table 28-5 Accept Header Value Fields

Field	TYPE	Description
Name	STRING	Specifies the name of the format. This field is read-only.
Allowed	BOOL	Specifies whether IM-PSX supports the respective SIP NOTIFY message body format. When the format is supported, SIP applications can set this format in the Accept header of SIP SUBSCRIBE messages. Possible values: TRUE FALSE Default value: True

Configuring the Map Handling Parameters

The Map Handling tab enables you to configure the IM-PSX MAP interface. Table 28-6 describes the configuration parameters in the Map Handling tab.

Table 28-6 Map Handling Parameters

Name	Type	Description
Default SS7 Entity Alias	STRING	Specifies an SS7 entity to which the IM-PSX sends a MAP request. The parameter defines an alias for one of the SCCP addresses configured in the SS7 SSU. The parameter is used only when the address is not provided in the To header of the SIP SUBSCRIBE message. Default value: hlr
gsmSCF Address	STRING	Specifies a value to be set in the gsmSCF-Address parameter of the MAP request. The parameter defines the address that identifies an IM-PSX in a mobile network. Default value: Unknown
gsmSCF Nature of Address	STRING	Specifies the NatureOfAddress of the gsmSCF-Address parameter in the MAP request
MSISDN NatureOfAddress	STRING	Specifies the NatureOfAddress of the MSISDN parameter that IM-PSX sets in the MAP operation. Service Broker uses the NatureOfAddress specified in this parameter only if the NatureOfAddress is not specified in the RequestURI header of the SIP SUBSCRIBE message. Possible values: UNKNOWN NATIONAL INTERNATIONAL SUBSCRIBER_NUMBER NETWORK_SPECIFIC Default value: UNKNOWN IM-PSX also uses this parameter to set the gsmScfAddressNoa
Default Numbering Plan	STRING	Specifies a default numbering plan used to set the MSISDN and gsmSCF-Address in the MAP request. Possible values: ISDN DATA TELEX Default value: ISDN

Configuring TCAP Parameters

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

Table 28-7 describes configuration parameters in the TCAP subtab.

Table 28-7 TCAP Parameters

Name	Type	Description
Class4 Default Timeout in Seconds	INT	Specifies the time period in seconds that the IM waits for a 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 a possible REJECT. The timer starts when sending INVOKE for class 1-3 operations.
Application Part Guard Timer	INT	Specifies the PSM timer, which is a timer for incoming operations. The PSM timer defines the maximum time that the application (TC-User) has to respond to incoming INVOKE messages.
Activate Invoke Alarm in Application Layer	BOOL	When the TCAP layer receives an INVOKE, it triggers back P-ABORT 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.

Configuring Monitoring Parameters

The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-PSX. 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.