18 Configuring IM-PSX

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

Configuring IM-PSX GSM MAP
Configuring IM-PSX ANSI-MAP

Configuring IM-PSX GSM MAP

This section describes how to configure IM-PSX MAP for GSM networks using the Service Broker Administration Console and Java MBeans.

Configuring IM-PSX MAP with the Administration Console

This section describes how to configure IM-PSX module instances using the Service Broker Administration Console.

To access the IM-PSX Configuration screen:

In the Domain Navigation pane, select OCSB > Processing Tier > Interworking Modules.

The list of currently deployed Interworking Modules is displayed.
In the list of the deployed modules, select the module instance that you want to configure.

The module instance configuration screen is displayed in the Configuration pane.

The configuration screen of the IM-PSX contains the tabs described in Table 18-1.

Table 18-1 IM-PSX Configuration Subtabs

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

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

Table 18-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.

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 18-3.

Table 18-3 SIP Subscription Tabs

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

Subtab

Description

General

Enables you to set up a pending NOTIFY message and define a PSX SIP domain.

For more information, see "General".

Accept Header

Enables you to select allowed values to which a SIP application can set the Accept header.

For more information, see "Accept".

General

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

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

Table 18-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

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

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 18-5.

Table 18-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

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 18-6 describes the configuration parameters in the Map Handling tab.

Table 18-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: NETWORK_SPECIFIC SUBSCRIBER_NUMBER UNKNOWN NATIONAL INTERNATIONAL 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 18-7 describes configuration parameters in the TCAP subtab.

Table 18-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.
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.
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.
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.

Configuring IM-PSX MAP with Java MBeans

Service Broker provides a set of MBeans with attributes and operations for configuring the IM-PSX through JMX. The hierarchy of the MBeans is shown in Figure 18-1.

Figure 18-1 IM-PSX MBeans Hierarchy

The following sections provide reference information for the IM-PSX configuration MBeans.

Note:

MBeans covered in this guide might 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:

MonitoringGeneralMBean
ThresholdCrossedNotificationRulesMBean
ThresholdCrossedNotificationRuleMBean
StateChangedNotificationRulesMBean
StateChangedNotificationRuleMBean

ImpsxMap3MBean

ImpsxMap3MBean is the root MBean for the IM-PSX MAP phase 3 configuration. It provides reference to other configuration MBeans in the hierarchy, and does not expose any additional specific configuration.

Factory Method

Created automatically.

Attributes

None

Operations

ObjectName getSipSubscriptionMBean()

Gets the qualified object name of the SipSubscriptionMBean instance

ObjectName getMapHandlingMBean()

Gets the qualified object name of the MapHandlingMBean instance

ObjectName getMonitoringMBean()

Gets the qualified object name of the MonitoringMBean instance

SipSubscriptionMBean

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

Factory Method

Created automatically.

Attributes

GeneralPendingNotify
PsxSipDomain

This section describes how to configure IM-PSX ANSI-MAP module instances using the Service Broker Administration Console.

To access the IM-PSX ANSI-MAP Configuration screen:

In the Domain Navigation pane, select OCSB > Processing Tier > Interworking Modules.

The list of currently deployed Interworking Modules is displayed.
In the list of the deployed modules, select the module instance that you want to configure.

The module instance configuration screen is displayed in the Configuration pane.

The configuration screen of the IM-PSX ANSI-MAP contains the tabs described in Table 18-8.

Table 18-8 IM-PSX ANSI-MAP Configuration Subtabs

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

Configuring General Parameters

The General tab enables you to specify an alias for an Interworking Module instance.

Table 18-9 describes the configuration parameter in the General tab.

Table 18-9 IM-PSX General Parameter

Name	Type	Description
Alias	STRING	Specifies an internal Service Broker alias given to an IM-PSX instance. This alias is used in the SSU configuration, in the Incoming Routing Rules tab to specify routing rules towards this IM-PSX instance.

Name

Type

Description

Alias

STRING

Specifies an internal Service Broker alias given to an IM-PSX instance.

This alias is used in the SSU configuration, in the Incoming Routing Rules tab to specify routing rules towards this IM-PSX instance.

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

Table 18-10 SIP Subscription Tabs

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

Subtab

Description

General

Enables you to a set up a pending NOTIFY message and define a PSX SIP domain.

For more information, see "General".

Accept Header

Enables you to select allowed values to which a SIP application can set the Accept header.

For more information, see "Accept".

General

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

Table 18-11 describes the configuration parameters on the General subtab.

Table 18-11 General Parameters

Name	Type	Description
Generate Pending NOTIFY	BOOL	Specifies whether or not Service Broker needs to generate a SIP NOTIFY message with Subscription-State set to pending together with an empty body when a new subscription is created and the terminal state is yet unknown. Possible values: True False Default value: True
PSX SIP Domain	STRING	Specifies a 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

Name

Type

Description

Generate Pending NOTIFY

BOOL

Specifies whether or not Service Broker needs to generate a SIP NOTIFY message with Subscription-State set to pending together with an empty body when a new subscription is created and the terminal state is yet unknown.

Possible values:

True
False

Default value: True

PSX SIP Domain

STRING

Specifies a 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

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 a format 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 18-12.

Table 18-12 Accept Header Value Fields

Field	TYPE	Description
Name	STRING	Specifies a format in which a in-dialog and out-of-dialog SIP NOTIFY message body is encoded. This is a read-only field. IM-PSX can support the following formats: application/pidf+xml application/ansi-is41e+ber application/ansi-is41e+xml You can define which of these formats IM-PSX supports.
Allowed	BOOL	Specifies whether IM-PSX supports each of the formats displayed in the Name column. When it is supported, SIP applications can set the format in the Accept header of SIP SUBSCRIBE messages. Possible values: True False Default value: True

Field

TYPE

Description

Name

STRING

Specifies a format in which a in-dialog and out-of-dialog SIP NOTIFY message body is encoded. This is a read-only field.

IM-PSX can support the following formats:

application/pidf+xml
application/ansi-is41e+ber
application/ansi-is41e+xml

You can define which of these formats IM-PSX supports.

Allowed

BOOL

Specifies whether IM-PSX supports each of the formats displayed in the Name column. When it is supported, SIP applications can set the 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 18-13 describes the configuration parameters in the Map Handling tab.

Table 18-13 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 to one of the SCCP addresses configured in the SS7 SSU. The parameter is used only when the To header domain part of a SIP SUBSCRIBE message equals to the PSX domain. Default value: hlr
Location Operation	STRING	Specifies a default ANSI-MAP operation that the IM-PSX sends to an HLR. Possible values: SMSREQ SEARCH Default value: SEARCH
HLR Notify When Available	BOOL	Specifies whether or not an HLR sends SMSNotification to the IM-PSX when a mobile subscriber who was previously unavailable becomes available again. This parameter is set in the SMSReq operation that Service Broker sends to an HLR. Possible values: True The HLR sends an SMSNotification message to IM-PSX when a subscriber becomes available again. The notification contains information about the subscriber's False The HLR does not send a notification when a subscriber becomes available again. Default value: True To enable IM-PSX to forward an SMSNotification to the application server that requested the information, perform the following actions: In the configuration settings of IM-ASF, define the AS to which IM-PSX needs to forward an SMSNotification. Go to the General tab in the OE Configuration screen and set the Subscriber Profile parameter to OlpLssInfoReceiver. In the orchestration profile, in addition to the entry for SUBSCRIBE messages, add an entry for NOTIFY messages.
Search Service ID	STRING	Specifies the identifier of a service of the AS that requests information about a mobile subscriber
MDN NatureOfAddress	STRING	Specifies the NatureOfAddress of the MDN parameter that IM-PSX sets in ANSI-MAP operations. 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: NATIONAL INTERNATIONAL Default value: NATIONAL

Configuring TCAP Parameters

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

Table 18-14 describes configuration parameters in the TCAP subtab.

Table 18-14 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.
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 a 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 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-PSX.

Configuring IM-PSX ANSI-MAP with Java MBeans

Service Broker provides a set of MBeans with attributes and operations for configuring the IM-PSX ANSI-MAP through JMX. The hierarchy of the MBeans is shown in Figure 18-2.

Figure 18-2 IM-PSX MBeans Hierarchy

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

MonitoringGeneralMBean
ThresholdCrossedNotificationRulesMBean
ThresholdCrossedNotificationRuleMBean
StateChangedNotificationRulesMBean
StateChangedNotificationRuleMBean

ImpsxAnsiMBean

ImpsxAnsiMBean is the root MBean for the IM-PSX ANSI-MAP configuration. It provides reference to other configuration MBeans in the hierarchy, and does not expose any specific configuration in addition.

Factory Method

Created automatically.

Attributes

None

Operations

ObjectName getSipSubscriptionMBean()

Gets the qualified object name of the SipSubscriptionMBean instance

ObjectName getMapHandlingMBean()

Gets the qualified object name of the MapHandlingMBean instance

ObjectName getMonitoringMBean()

Gets the qualified object name of the MonitoringMBean instance

SipSubscriptionMBean

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

Factory Method

Created automatically.

Attributes

GeneratePendingNotify
PsxSipDomain

For more information on these attributes, see Table 18-11.

Operations

ObjectName getAccptHeadersMBean()

Gets the qualified ObjectName of the AccptHeadersMBean instance

AcceptHeadersMBean

AcceptHeadersMBean is a set of AcceptHeaderMBean instances, each represents one SIP NOTIFY message body format that IM-PSX supports. These are the formats that SIP applications are allowed to set in the Accept header of SIP SUBSCRIBE messages.

Factory Method

Attributes

DefaultSs7EntityAlias
LocationOperation
HlrNotifyWhenAvailable
SearchServiceID
MdnNatureOfAddress

For more information on these attributes, see Table 18-13.

Operations

None

TcapMBean

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

Factory Method

Created automatically

Attributes

Class4DefaultTimeout
RejectTimeoutInSeconds
ActivateInvokeAlarmInApplicationLayer
ApplicationPartGuardTimer
ResultSplitLength

For more information on these attributes, see Table 18-14.

Operations

None