32 Configuring IM-PSX ANSI Plugin

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

About IM-PSX ANSI Plugin

IM-PSX ANSI Plugin is a network-facing module that enables Service Broker to handle messages which existing IMs do not support. Unlike other network-facing IMs that communicate with TCAP users (such as CAP, INAP, WIN, or MAP), IM-PSX ANSI Plugin communicates with TCAP directly.

Configuring IM-PSX ANSI Plugin with the Administration Console

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

To access the IM-PSX ANSI Plugin 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-PSX Plugin configuration pane contains the tabs described in Table 32-1.

Table 32-1 IM-PSX ANSI Plugin Configuration Tabs

Tab	Description
General	Enables you to configure the alias of the IM-PSX ANSI Plugin address specified in the SS7 SSU configuration. See "Configuring General Parameters" for more information.
Session Handling	Enables you to configure how IM-PSX ANSI Plugin handles sessions that IM-PSX ANSI Plugin sends to, and receives from, a network. See "Configuring Session 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 enables you to configure the alias for the IM-PSX ANSI Plugin address defined in the SS7 SSU configuration.

Table 32-2 describes the Alias parameter in the General tab.

Table 32-2 IM-PSX ANSI Plugin General Parameter

Name	Type	Description
Alias	STRING	Specifies the alias of the IM's SS7 address.

Configuring Session Handling Parameters

The Session Handling tab enables you to configure how IM-PSX ANSI Plugin handles sessions that it sends to, and receives from, a network.

Table 32-3 describes the configuration parameters on the Session Handling tab.

Table 32-3 Session Handling Parameters

Name	Type	Description
Generate Pending NOTIFY	BOOL	Specifies whether or not Service Broker generates a SIP NOTIFY message when IM-PSX ANSI Plugin receives a SIP SUBSCRIBE message. Possible values: True False Default value: False
Expires Header Value	INT	Specifies the value to which IM-PSX ANSI Plugin sets the Expires header when the session is initiated by a network entity. Default value: 1000
Content Type Upon No Indication	STRING	Specifies the default content type if the content type is not specified. Default value: application/tcap-component-portion+xml+ber
AS Name Address	STRING	Specifies the address of the AS that IM-PSX ANSI Plugin sets in the RequestURI and To headers.
Default SS7 Entity Alias	STRING	Specifies an SS7 entity to which IM-PSX ANSI Plugin sends a 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.
Max Parameter Length in Tcap Component in Bytes	INT	Specifies the maximum length of the parameter value in Tcap Component, in bytes that the AS sends to IM-PSX ANSI Plugin. Default value: 512
Plugin Class Name	STRING	Specifies the class name of the plugin that encodes parameters of a TCAP message to XER. If you do not specify the class name, IM-PSX ANSI Plugin forwards parameters of a TCAP message as a byte array.
Plugin Protocol Name	STRING	Specifies the name of the protocol of the plugin, if the plugin for converting parameters of a TCAP message to XER is used.

Configuring TCAP Parameters

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

Table 32-4 describes the configuration parameters in the TCAP tab.

Table 32-4 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 message. The timer starts when sending an INVOKE message 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 message. The timer starts when sending an INVOKE message for class 1-3 operations.

Name

Type

Description

Class4 Default Timeout in Seconds

INT

Specifies the time period in seconds that the IM waits for a possible REJECT message. The timer starts when sending an INVOKE message 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 message. The timer starts when sending an INVOKE message for class 1-3 operations.

Configuring Monitoring Parameters

The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-PSX ANSI Plugin. For more information, see "Configuring Monitoring with the Administration Console".

Configuring IM-PSX ANSI Plugin with Java MBeans

Service Broker provides a set of MBeans with attributes and operations for configuring the IM-PSX ANSI Plugin through JMX. Figure 32-1 shows the hierarchy of the IM-PSX ANSI Plugin MBeans.

Figure 32-1 IM-PSX ANSI Plugin MBeans Hierarchy

The following sections provide reference information for the IM-PSX ANSI Plugin 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 and described in "Configuring Monitoring with Java MBeans":

MonitoringGeneralMBean
ThresholdCrossedNotificationRulesMBean
ThresholdCrossedNotificationRuleMBean
StateChangedNotificationRulesMBean
StateChangedNotificationRuleMBean

ImpsxAnsiPluginMBean

ImpsxAnsiPluginMBean is the root MBean for the IM-PSX ANSI Plugin 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 getGeneralMBean()

Gets the qualified object name of the GeneralMBean instance

ObjectName getSessionHandlingMBean()

Gets the qualified object name of the SessionHandlingMBean instance

ObjectName getTcapMBean()

Gets the qualified object name of the TcapMBean instance

ObjectName getMonitoringMBean()

Gets the qualified object name of the MonitoringMBean instance

GeneralMBean

GeneralMBean enables you to configure the alias for the IM-PSX ANSI Plugin address defined in the SS7 SSU configuration.

Factory Method

Created automatically

Attributes

Alias

For more information on these attributes, see Table 32-2.

Operations

None

SessionHandlingMBean

SessionHandlingMBean enables you to configure how IM-PSX Plugin handles sessions that IM-PSX ANSI Plugin sends to, and receives from, a network.

Factory Method

Created automatically

Attributes

GeneratePendingNotify
ExpiresHeaderValue
ContentTypeUponNoIndication
AsNameAddress
DefaultSs7EntityAlias
MaxParameterLengthInTcapComponentInBytes
PluginClassName
PluginProtocolName

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

Operations

None

TcapMBean

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

Factory Method

Created automatically

Attributes

Class4DefaultTimeout
RejectTimeoutInSeconds

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

Operations

None