Oracle® Communications Service Broker Modules Configuration Guide Release 6.1 E29454-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how to set up an IM-SCF CAP Phase 2 interworking module.
The process of IM-SCF CAP phase 2 setup requires the following:
Adding an IM-SCF CAP phase 2 to your Oracle Communications Service Broker deployment. You can add as many modules of type IM-SCF CAP as you need. See "Adding an IM-SCF CAP Phase 2 to the Service Broker Deployment" for more information.
Configuring the IM-SCF CAP phase 2. See "Configuring an IM-SCF CAP Phase 2" for more information.
To add an IM-SCF CAP phase 2:
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 IMSCFCAP2.
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-SCF CAP phase 2 to your deployment, in the Change Center pane, click Commit.
A new module of type IM-SCF CAP phase 2 is now added to your Service Broker deployment. The new module is displayed in the domain navigation pane under the Interworking Modules node.
To configure an IM-SCF CAP phase 2:
In the Change Center, click Lock & Edit.
In the domain navigation pane, under the Interworking Modules node, select the newly added IM-SCF CAP phase 2.
The IM-SCF CAP phase 2 Configuration tab contains the subtabs described in Table 2-1.
Table 2-1 IM-SCF CAP Phase 2 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 define the way that IM-SCF handles calls. For more information, see "Configuring Call Handling Parameters". |
IN Triggering |
Enables you to define the IN triggers that the IM-SCF arms in the underlying session control entity. For more information, see "Configuring IN Triggering Parameters". |
Charging Service |
Enables you to define how IM-SCF sends credit reservation requests and specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC. See "Charging Services" for more information. |
Media Resources |
Enables you to set up the media resources that Service Broker uses to play announcements. For more information, see "Configuring Media Resources Parameters". |
TCAP |
Enables you to set up the TCAP layer of the IM-SCF. For more information, see "Configuring TCAP Parameters". |
Monitoring |
Enables you to define how Runtime MBeans and notifications operate. For more information, see "Configuring Monitoring 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 2-2 describes the configuration parameters on the General subtab.
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. |
The Call Handling subtab enables you to define how IM-SCF handles calls.
Table 2-3 describes configuration parameters on the Call Handling subtab.
Table 2-3 IM-SCF CAP Phase 2 Call Handling Parameters
Name | Type | Description |
---|---|---|
OE Reaction Interval in Seconds |
INT |
Specifies the time period in seconds during which the IM-SCF waits for the OE to respond to SAL messages. When this timer expires, IM-SCF decides how to handle existing session (Continue or Release) according to the configuration settings. Default value: 100 |
Body Encoding Format |
STRING |
Specifies the method that the IM-SCF uses to encode IN parameters in the body of a SAL message. Possible values:
Default value: None In an IN mediation solution, when IM-SCF is coupled with IM-SSF, this parameter must be set to XER. |
RRBCSM Accumulation Mode |
BOOL |
Specifies whether or not IM-SCF arms DPs using a single or multiple RRBCSM requests. Possible values:
|
Activity Test Interval in Seconds |
INT |
Specifies the time interval in seconds between two invocations of ActivityTest operation. This operation is used to check whether or not the call exists. Default value: 0, which means that the ActivityTest is not sent |
Wait for AssistRequestInstructions Waiting Interval in Seconds |
INT |
Specifies the time period in seconds during which the IM-SCF waits for an ARI operation, following an ETC operation to the switch |
Wait for AssistRequestInstructions after EstablishTemporaryConnection |
BOOL |
Specifies whether or not IM-SCF expects a ARI operation, following an ETC operation to the switch. Possible values:
|
Reset Timer Interval in Seconds |
INT |
Specifies the time period, in seconds, from receiving IN operation and till invoking the ResetTimer operation towards the MSC (reset Tssf). Default value: 10 |
UI Reset Timer Interval in Seconds |
INT |
Specifies the time period, in seconds, from receiving IN operation and till invoking the ResetTimer operation towards the MSC (reset Tssf). As opposed to the Reset Timer Interval in Seconds parameter, this parameter is used when IM-SCF is in the middle of interaction with a media resource. Default value: 900 |
gsmSCFAddress |
STRING |
Specifies gsmSCFAddress to be set in an EstablishTemporaryConnection (ETC) operation and InitiateCallAttempt (ICA) operations. gsmSCFAddress represents the address of IM-SCF that initiates the ETC operation. gsmSCFAddress consists of the following:
For more information about the format of gsmSCFAddress, see 3GPP 29.002. |
Wait for Apply Charging Report or Call Information |
INT |
Specifies the time period in seconds during which the IM-SCF waits for ACR or CIR operation. |
The IN Triggering subtab enables you to define IN triggers that the IM-SCF arms in the underlying session control entity and specify additional parameters.
The IN Triggering subtab contains the subtabs described in Table 2-4.
Table 2-4 IN Triggering Subtabs
Subtab | Description |
---|---|
O-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call origination side. For more information, see "Configuring DPs on the Call Origination Side". |
T-BCSM |
Enables you to configure how the IM-SCF arms DPs on the call termination side. For more information, see "Configuring DPs on the Call Termination Side". |
Configuring DPs on the Call Origination Side
The O-BCSM subtab enables you to configure how the IM-SCF arms DPs on the call origination side.
Table 2-5 describes configuration parameters on the O-BCSM subtab.
Name | Type | Description |
---|---|---|
RouteSelectFailure |
STRING |
Specifies how the IM-SCF arms RouteSelectFailure. Possible values:
Default value: INTERRUPTED |
OCalledPartyBusy |
STRING |
Specifies how the IM-SCF arms oCalledPartyBusy. Possible values:
Default value: INTERRUPTED |
ONoAnswer |
STRING |
Specifies how the IM-SCF arms oNoAnswer. Possible values:
Default value: INTERRUPTED |
OAnswer |
STRING |
Specifies how the IM-SCF arms oAnswer. Possible values:
Default value: INTERRUPTED |
ODisconnect |
STRING |
Specifies how the IM-SCF arms oDisconnect. Possible values:
Default value: INTERRUPTED |
OAbandon |
STRING |
Specifies how the IM-SCF arms oAbandon. Possible values:
Default value: NOTIFY_AND_CONTINUE |
ODisconnect Leg |
STRING |
Specifies a leg on which the oDisconnect DP is armed. Possible values:
Default value: 1,2 |
Configuring DPs on the Call Termination Side
The T-BCSM subtab enables you to configure how the IM-SCF arms DPs on the call termination side.
Table 2-6 describes configuration parameters on the T-BCSM subtab.
Name | Type | Description |
---|---|---|
TBusy |
STRING |
Specifies how the IM-SCF arms tBusy. Possible values:
Default value: INTERRUPTED |
TNoAnswer |
STRING |
Specifies how the IM-SCF arms tNoAnswer. Possible values:
Default value: INTERRUPTED |
TAnswer |
STRING |
Specifies how the IM-SCF arms tAnswer. Possible values:
Default value: INTERRUPTED |
TDisconnect |
STRING |
Specifies how the IM-SCF arms tDisconnect. Possible values:
Default value: INTERRUPTED |
TAbandon |
STRING |
Specifies how the IM-SCF arms tAbandon. Possible values:
Default value: NOTIFY_AND_CONTINUE |
TDisconnect Leg |
STRING |
Specifies a leg on which the tDisconnect DP is armed. Possible values:
Default value: 1,2 |
You can configure IM-SCF to monitor session duration and charge sessions. IM-SCF provides the following capabilities:
Credit reservation requests generation
IM-SCF sends these requests to IM-OCF through the OE. IM-OCF translates credit reservation requests to Diameter CCRs, which are then forwarded to a billing application.
Session monitoring and charging
You can specify whether a session is monitored by IM-SCF or by an MSC. In the former case, IM-SCF generates an ApplyCharging message based on the Granted-Service-Unit AVP of the CCA received from a billing application. IM-SCF sends this ApplyCharging message to an MSC. Then the MSC applies charging. If the session is monitored by IM-SCF, IM-SCF applies charging on its own.
Quota reauthorization
You can specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
To set up IM-SCF charging services, you use the Charging Services tab. This tab contains the subtabs described in Table 2-7.
Table 2-7 Charging Services Subtabs
Subtab | Description |
---|---|
General |
Enables you to specify how IM-SCF sets up and sends credit reservation requests to the OE. See "General" for more information. |
Reauthorization Triggers |
Enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC. See "Reauthorization Triggers" for more information. |
The General subtab enables you to specify how IM-SCF sets up and sends credit reservation requests to the OE. The OE forwards these requests to application-facing IMs as defined in the orchestration logic.
Table 2-8 describes the configuration parameters that you need to specify for credit reservation requests.
Name | Type | Description |
---|---|---|
Service Monitoring Type |
STRING |
Specifies the component that monitors session duration. Possible values:
Default value: None |
Tccd Timeout |
INT |
Specifies the maximum time, in seconds, that IM-SCF waits for a credit reservation response after sending a credit reservation request. If the timeout expires, IM-SCF releases the call. To disable the timeout timer, enter a negative value. |
First Credit Reservation Request |
STRING |
Specifies when IM-OCF sends the first CCR to a billing application. This request is generated by IM-SCF and sent to IM-OCF through the OE. Possible values:
Default value: ON_INITIAL_EVENT |
First Credit Granted Notification |
STRING |
When the Service Monitoring parameter is set to "External" and session duration is monitored by an MSC, the First Credit Granted Notification parameter specifies when IM-SCF sends an ApplyCharging message to the MSC. Possible values:
Default value: ON_INITIAL_EVENT |
Start Charging Phase |
STRING |
Specifies when IM-SCF starts charging a session. Possible values:
Default value: ON_ANSWER |
Requested Duration |
INT |
Specifies the value to which IM-OCF needs to set the CC-time AVP in a CCR sent to a billing application. |
Requested Volume |
INT |
Specifies the value to which IM-OCF needs to set the CC-Total-Octets AVP in a CCR sent to a billing application. |
Requested Service Units |
INT |
Specifies the value to which IM-OCF needs to set the CC-Service-Specific-Units AVP in a CCR sent to a billing application. |
Service Identifier |
INT |
Specifies the value to which IM-OCF needs to set the Service-Identifier AVP in a CCR sent to a billing application. |
The Reauthorization Triggers subtab enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
Table 2-9 describes configuration parameters on the Reauthorization Triggers subtab.
Table 2-9 Reauthorization Triggers Parameters
Name | Type | Description |
---|---|---|
Name |
STRING |
A unique identifier for the trigger. |
Trigger Type |
STRING |
Specifies the trigger for reauthorization of granted quota. Possible values:
|
Mode |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Updated trigger.
Default value: DYNAMIC |
Table 2-10 describes the preconfigured triggers on the Reauthorization Triggers subtab.
Table 2-10 Reauthorization Triggers
Name | Type | Description |
---|---|---|
Info Received |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Info Received trigger. Possible values:
Default value: Dynamic |
Session Alerted |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Alerted trigger. Possible values:
Default value: Dynamic |
Session Connected |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Connected trigger. Possible values:
Default value: Dynamic |
Session ReInvite Complete |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session ReInvite Complete trigger. Possible values:
Default value: Dynamic |
Session Reinvited |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Reinvited trigger.
Default value: Dynamic |
Session Update Complete |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Update Complete trigger.
Default value: Dynamic |
Session Updated |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Updated trigger.
Default value: Dynamic |
Using the Media Resources tab, you configure media resources that Service Broker uses to play announcements. In addition, you define how Service Broker translates the string URL of the announcement received from an application to an integer required by an SS7 MRF.
The Media Resources tab contains the subtabs described in Table 2-11.
Table 2-11 Media Resources Subtabs
Subtab | Description |
---|---|
General |
Enables you to configure media resources that IM-SCF uses to play announcements. See "General" for more information. |
Announcements |
Enables you to configure how the IM-SCF translates announcement URLs to announcement IDs. See "Announcements" for more information. |
Table 2-12 describes the parameters that define MRFs that the IM-SCF uses to play announcements.
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 in order to play announcements. The alias has the format of a SIP URI: sip: name1.name2@domain_name. For example: sip:ocsb.mrf@processing_domain1. If a name contains numbers, you can specify a generic alias that fits a range of aliases by using the question mark character (?) as a wildcard character. A question mark can be substituted by any number. For example, if you set the Alias parameter to mrf.1234????@oracle, this alias fits any alias in the range from mrf.12340000@oracle to mrf.12349999@ oracle. |
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. To use a pre-defined media resource to play announcements, set:
In this case, Service Broker ignores the following parameters:
|
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:
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:
Default value: ISDN |
Numbering Qualifier |
STRING |
Specifies the numbering qualifier of the media resource address. Possible values:
Default value: NONE |
Number Screening |
STRING |
Specifies the numbering screening of the media resource address. Possible values:
Default value: UNDEFINED |
Presentation Restriction |
STRING |
Specifies the presentation restriction of the media resource address. Possible values:
Default value: UNDEFINED |
Operation Type |
STRING |
Possible values:
Default value: internal |
Answer Indication |
BOOL |
Specifies how to set the ServiceInteractionIndicatorTwo.bothway ThroughConnectionInd parameter in ETC and CTR operations in order to specify whether IM-SCF needs to request opening of the voice channel in both directions or in one direction only. Possible values:
|
Note:
When an internal media resource is used (CTR), the Address Digits, Nature of Address and Address Numbering Plan Indicator parameters can be set to 'None' in order to instruct the network's session control entity to connect its pre-configured media resource.An application can request Service Broker to play an announcement by sending to Service Broker a SIP INFO message that contains an MSCML representation of a PlayAnnouncement operation. This message contains the URL of the announcement to be played. Because an SS7 MRF requires an integer to identify the announcement rather than a string value, Service Broker translates the URL to an announcement ID before sending a request to the MRF.
Using the Announcements subtab, you define to which announcement ID Service Broker translates each URL as described in Table 2-13.
Table 2-13 Announcement URLs to Announcement IDs Translation Parameters
Name | Type | Description |
---|---|---|
Name |
STRING |
Specifies the name of the announcement. |
MRF Alias |
STRING |
Specifies the alias of the MRF for which Service Broker translates the URL specified in the General Announcement ID parameter to the ID defined in the Specific Announcement parameter. The alias has the format of a SIP URI: sip: name1.name2@domain_name. For example: sip:ocsb.mrf@processing_domain1. If a name contains numbers, you can specify a generic alias that fits a range of aliases by using the question mark character (?) as a wildcard character. A question mark can be substituted by any number. For example, if you set the Alias parameter to mrf.1234????@oracle, this alias fits any alias in the range from mrf.12340000@oracle to mrf.12349999@ oracle. You define parameters of the MRF in the General subtab of the Media Resources tab. |
General Announcement ID |
STRING |
Specifies the URL of the announcement that Service Broker translates to the integer representing the announcement ID and specified in the Specific Announcement parameter. |
Specific Announcement |
INT |
Specifies the announcement ID to which Service Broker translates the value specified in the General Announcement ID. |
The TCAP subtab enables you to set up parameters of the IM TCAP layer.
Table 2-14 describes configuration parameters on the TCAP subtab.
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: 10000 |
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. |
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. |
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:
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. |
The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-SCF. 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.