Skip Headers
Oracle® Communications Service Broker Modules Configuration Guide
Release 6.1

Part Number E29454-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

30 Setting Up IM-PSX ANSI Plugin

This chapter describes how to set up an IM-PSX ANSI Plugin interworking module.

About IM-PSX ANSI Plugin

IM-PSX ANSI Plugin is a network-facing module that enables Oracle Communications 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.

About IM-PSX ANSI Plugin Setup

The process of IM-PSX ANSI Plugin setup requires the following:

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

  2. Configuring the IM-PSX ANSI Plugin. See "Configuring an IM-PSX ANSI Plugin" for more information.

Adding an IM-PSX ANSI Plugin to the Service Broker Deployment

To add an IM-PSX ANSI Plugin:

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

    • 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 ANSI Plugin to your deployment, in the Change Center pane, click Commit.

    A new module of type IM-PSX ANSI Plugin 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 ANSI Plugin

To configure an IM-PSX ANSI Plugin:

  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 ANSI Plugin.

    The IM-PSX ANSI Plugin configuration pane contains the tabs described in Table 30-1.

    Table 30-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 30-2 describes the Alias parameter in the General tab.

Table 30-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 30-3 describes the configuration parameters on the Session Handling tab.

Table 30-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 30-4 describes the configuration parameters in the TCAP tab.

Table 30-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: 10000 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.

Default value: 1000 seconds


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 Service Broker Monitoring" in "Monitoring Service Broker Using Runtime MBeans" in Oracle Communications Service Broker System Administrator's Guide.