21 Setting Up IM-OCF Ro

This chapter describes how to set up an IM-OCF Ro interworking module.

About IM-OCF Setup

The process of IM-OCF setup requires the following:

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

Adding an IM-OCF to the Service Broker Deployment

To add an IM-OCF:

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

A new module of type IM-OCF 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-OCF

To configure an IM-OCF:

In the Change Center, click Lock & Edit.

In the domain navigation pane, under the Interworking Modules node, select the newly added IM-OCF.

The IM-OCF configuration pane contains the subtabs described in Table 21-1.

Table 21-1 IM-OCF Configuration Subtabs

Subtab	Description
Call Handling	Enables you to define how the IM-OCF Ro handles calls. See "Configuring Call Handling Parameters" for more information.
Diameter Credit Control Application	Enables you to configure parameters specific to the IM-OCF Ro DCCA interface. See "Configuring Diameter Credit Control Application Parameters" for more information.
Async Announcement Manager	Enables you to set up how IM-OCF Ro triggers the MRF to play announcements. See "Configuring Asynchronous Announcement Manager Parameters" for more information.
Monitoring	Enables you to define how Runtime MBeans and notifications should operate. See "Configuring Monitoring Parameters" for more information.
Degraded Mode	Enables you to set up how a session is charged when an online charging server is not available. See "Configuring the Degraded Mode" for more information.

Configuring Call Handling Parameters

The General tab enables you to set up how IM-OCF Ro handles sessions. Table 21-2 describes configuration parameters in the General subtab.

Table 21-2 IM-OCF Ro Call Handling General Parameters

Name	Type	Description
Termination-Cause AVP on SAL BYE	STRING	Specifies how to set a CCR Termination-Cause AVP when session is disconnected by an internal Service Broker SAL BYE message. Possible values: DIAMETER_LOGOUT DIAMETER_SERVICE_NOT_PROVIDED DIAMETER_BAD_ANSWER DIAMETER_ADMINISTRATIVE DIAMETER_LINK_BROKEN DIAMETER_AUTH_EXPIRED DIAMETER_USER_MOVED DIAMETER_SESSION_TIMEOUT Default value: DIAMETER_LOGOUT Service Broker ignores this parameter when the Diameter-based orchestration mode is enabled. For more information about this mode, see the discussion on setting up orchestrated charging mediation in Oracle Communications Service Broker Online Mediation Controller Implementation Guide.
Termination-Cause AVP on SAL CANCEL	STRING	Specifies how to set a CCR Termination-Cause AVP when session is disconnected by an internal Service Broker SAL CANCEL message. Possible values: DIAMETER_LOGOUT DIAMETER_SERVICE_NOT_PROVIDED DIAMETER_BAD_ANSWER DIAMETER_ADMINISTRATIVE DIAMETER_LINK_BROKEN DIAMETER_AUTH_EXPIRED DIAMETER_USER_MOVED DIAMETER_SESSION_TIMEOUT Default value: DIAMETER_SERVICE_NOT_PROVIDED Service Broker ignores this parameter when the Diameter-based orchestration mode is enabled. See Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information about this mode.
Termination-Cause AVP on SAL Final Error Response	STRING	Specifies how to set a CCR Termination-Cause AVP when session is disconnected by an internal Service Broker SAL final error response message. Possible values: DIAMETER_LOGOUT DIAMETER_SERVICE_NOT_PROVIDED DIAMETER_BAD_ANSWER DIAMETER_ADMINISTRATIVE DIAMETER_LINK_BROKEN DIAMETER_AUTH_EXPIRED DIAMETER_USER_MOVED DIAMETER_SESSION_TIMEOUT Default value: DIAMETER_SERVICE_NOT_PROVIDED Service Broker ignores this parameter when the Diameter-based orchestration mode is enabled. See Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information about this mode.
Send CCR On Threshold Indication	BOOL	Indicates whether the IMOCF should send CCR if received a SAL message that indicates a threshold has been reached. Service Broker ignores this parameter when the Diameter-based orchestration mode is enabled. See Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information about this mode. The default value is FALSE.

Configuring Diameter Credit Control Application Parameters

The Diameter Credit Control Application tab enables you to configure parameters related to the IM-OCF Ro Diameter Credit Control Application (DCCA) interface. The Diameter Credit Control Application tab contains subtabs described in Table 21-3.

Table 21-3 IM-OCF Diameter Credit Control Application Subtabs

Subtab	Description
AVPs	Enables you to specify Attribute-Value Pairs (AVPs) to be set in CCRs. See "Configuring AVPs" for more information.
General	Enables you to set up a DCCA dialect and enables monitor call duration. For more information, see "Configuring General Parameters".

Subtab

Description

AVPs

Enables you to specify Attribute-Value Pairs (AVPs) to be set in CCRs.

See "Configuring AVPs" for more information.

General

Enables you to set up a DCCA dialect and enables monitor call duration.

For more information, see "Configuring General Parameters".

Configuring AVPs

The AVPs subtab enables you to specify Attribute-Value Pairs (AVPs) to be set in CCRs. Table 21-4 describes the AVPs that you can specify.

Table 21-4 IM-OCF DCCA AVPs Subtab Parameters

Name	Type	Description
Destination-Host AVP	STRING	Specifies the value to set in a CCR Destination-Host AVP. The Destination-Host AVP combined with the Destination-Realm AVP defines a Diameter destination node that communicates with the IM-OCF Ro. The IM-OCF Ro sends messages to the address you specify for the Diameter destination node. An alternative way to specify a Diameter destination node is to set the Destination-Realm AVP field with an alias of a Diameter destination node, which you define in the Diameter SSU Outbound Destination (see the discussion on configuring outbound destinations in the Diameter SSU in Oracle Communications Service Broker Signaling Server Units Configuration Guide for more information). In this case, the Destination-Host AVP is ignored.
Destination-Realm AVP	STRING	Specifies the value to set in a CCR Destination-Realm AVP. The Destination-Realm AVP combined with the Destination-Host AVP defines a Diameter destination node that communicates with the IM-OCF Ro.The IM-OCF Ro sends messages to the address you specify for the Diameter destination node. An alternative way to specify a Diameter destination node is to set the Destination-Realm AVP field with an alias of a Diameter destination node, which you define in the Diameter SSU Outbound Destination (see the discussion on configuring outbound destinations in the Diameter SSU in Oracle Communications Service Broker Signaling Server Units Configuration Guide for more information.). In this case, the Destination-Host AVP is ignored. If you leave this field blank, the IM-OCF works in the degraded mode.
Service-Context-Id AVP	STRING	Specifies the value to set in a CCR Service-Context-Id AVP. Default value: 32260@3gpp.org
User-Name AVP	STRING	Specifies the value to set in a CCR User-Name AVP.
Ro Node-Functionality AVP	INT	Specifies the value to set in a CCR Node-Functionality AVP. Possible values: S_CSCF P-CSCF I-CSCF MRFC MGCF BGCF AS Default value: AS

Configuring General Parameters

The General subtab enables you to set up a DCCA dialect and enable monitor call duration. Table 21-5 describes the parameters you can configure.

Table 21-5 IM-OCF DCCA General Subtab Parameters

Name	Type	Description
DCCA Dialect Plugin	STRING	Specifies the DCCA dialect that IM-OCF Ro uses. Possible values: STANDARD_DCCA Standard DCCA dialect BRM Oracle Communications Billing and Revenue Management DCCA dialect

Name

Type

Description

DCCA Dialect Plugin

STRING

Specifies the DCCA dialect that IM-OCF Ro uses.

Possible values:

STANDARD_DCCA

Standard DCCA dialect
BRM

Oracle Communications Billing and Revenue Management DCCA dialect

Configuring Asynchronous Announcement Manager Parameters

You can set up IM-OCF Ro to trigger an MRF to play announcements. Using the Async Announcement Manager tab, you can specify the alias of the MRF that plays announcements. In addition, you set up the rules that define the announcement to be played and the way how the MRF plays this announcement. For example, you can define that the MRF plays an announcement to a calling party when the time granted for the call is over, and the mobile subscriber is located in the home network.

You set up the Announcement Manager by configuring parameters on the subtabs described in Table 21-6.

Service Broker ignores the Announcement Manager configuration when the Diameter-based orchestration mode is enabled. See Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information about this mode.

Table 21-6 IM-OCF Ro Async Announcement Manager Subtabs

Subtab	Description
General	Enables you to specify the alias of the MRF that plays announcements. See "Configuring General Parameters" for more information.
Async Announcements	Enables you to set up the rules that define announcements to be played as well as to specify how the MRF plays these announcements. See "Configuring Async Announcements" for more information.

Subtab

Description

General

Enables you to specify the alias of the MRF that plays announcements.

See "Configuring General Parameters" for more information.

Async Announcements

Enables you to set up the rules that define announcements to be played as well as to specify how the MRF plays these announcements.

See "Configuring Async Announcements" for more information.

Configuring General Parameters

The General subtab enables you to specify the alias of the MRF that plays announcements. Table 21-7 describes the parameter you can configure.

Table 21-7 Async Announcement Manager General Parameter

Name	Type	Description
MRF Alias	STRING	Specifies the alias of the MRF that IM-OCF Ro uses to play announcements. The alias has the format of a SIP URI: sip: name1.name2@domain_name. For example: sip:ocsb.mrf@processing_domain1.

Name

Type

Description

MRF Alias

STRING

Specifies the alias of the MRF that IM-OCF Ro uses to play announcements.

The alias has the format of a SIP URI: sip: name1.name2@domain_name. For example: sip:ocsb.mrf@processing_domain1.

Configuring Async Announcements

The Async Announcements subtab enables you to set up rules for playing announcements. In addition, you set up the rules that define the announcement to be played and the way how the MRF plays this announcement.

The subtab contains the table in which each row represents a single rule. Table 21-8 describes the parameters you can configure.

Table 21-8 Async Announcement Manager Announcements Parameters

Name	Type	Description
Name	STRING	Specifies the unique identifier of the rule.
Enabled	BOOL	Specifies whether or not the announcement is enabled. Possible values: TRUE FALSE Default value: TRUE
Reason Type	STRING	Specifies the parameter that IM-OCF Ro checks in the CCA message received from the online charging server. When the value of the specified parameter matches the range that you defined using the Lower Limit and Upper Limit parameters, IM-OCF triggers the MRF to play the announcement. Possible values: ANY GRANTED_TIME RESULT_CODE SAL_ERROR Default value: ANY Note: When you set Reason Type to ANY, IM-OCF Ro always triggers the MRF to play the announcement.
Lower Limit	INT	Specifies the lower limit of the range for the parameter that you specified in Reason Type. When the value of the specified parameter is greater than the value set in Lower Limit and less than the value set in Upper Limit, IM-OCF Ro triggers the MRF to play the announcement. To configure IM-OCF Ro to trigger the MRF to play the announcement, regardless of the value of the lower limit, set this parameter to -1. Note: IM-OCF does not use the Lower Limit parameter if you set Reason Type to ANY.
Upper Limit	INT	Specifies the upper limit of the range for the parameter that you specified in Reason Type. When the value of the specified parameter is greater than the value set in Lower Limit and less than the value set in Upper Limit, IM-OCF Ro triggers the MRF to play the announcement. To configure IM-OCF Ro to trigger the MRF to play the announcement, regardless of the value of the upper limit, set this parameter to -1. Note: IM-OCF does not use the Upper Limit parameter if you set Reason Type to ANY.
Network	STRING	Specifies the location of the mobile subscriber required for triggering the MRF to play the announcement. Possible values: ANY HOME_ZONE HOME_NETWORK ROAMING Alternatively, you can specify the ID of a specific MSC that serves the mobile subscriber.
Service Side	STRING	Specifies the IM-OCF Ro's service side required for triggering the MRF to play the announcement. Possible values: BOTH ORIG TERM Default value: BOTH
Call State	STRING	Specifies the call state when IM-OCF Ro triggers the MRF to play the announcement. Possible values: PRECALL Note: A PRECALL announcement can be played at a call initiation and alerting phases only. MIDCALL POSTCALL Default value: PRECALL
Priority	INT	Specifies the order in which the MRF plays different announcement when the conditions of multiple rules are met.
Announcement Code	INT	Specifies the identifier of the announcement that the MRF plays.
Threshold	INT	Specifies how much time, in seconds, prior to the end of quota, IM-OCF Ro triggers the MRF to play the announcement. IM-OCF uses the Threshold parameter only for the announcements whose Call State parameter is set to MIDCALL. Note: Setting the Threshold parameter to any positive value when Call State set to PRECALL or POSTCALL causes an error.

Configuring Monitoring Parameters

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

Configuring the Degraded Mode

In Online Mediation Solution Controller, Service Broker relies upon an external online charging server (OCS) to apply charges for the use of network services.

When an online charging server is unavailable, IM-OCF Ro switches to degraded mode. This mode enables IM-OCF Ro to continue a session and charge a mobile subscriber during the time when the charging server is temporarily unavailable.

IM-OCF Ro waits a specified period of time for a response from the server after sending an accounting request. If the server does not respond, IM-OCF Ro switches to the degraded mode.

After IM-OCF Ro switches to degraded mode, IM-OCF Ro handles the session in this mode until the session is terminated even if the online charging server becomes available. IM-OCF Ro sends charging information gathered during the session once the session is complete and the OCS is back online.

In the degraded mode, IM-OCF Ro communicates with the Service Broker local charging server. The local online charging server assumes the role of the external charging server. This means that the local charging server can receive Credit Control Requests (CCRs) from, and send Credit Control Answers (CCAs) to, IM-OCF Ro.

To gather this information, IM-OCF Ro writes charging data records (CDRs). IM-OCF Ro replays the CDRs to the online charging server after this server becomes available again. Then the server actually charges the mobile subscriber.

See "Administrating Degraded Mode" in Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information.

You use the Degraded Mode tab to configure the parameters of this mode as described in Table 21-9.

Table 21-9 Degraded Mode Parameters

Name	Type	Description
On OCF Failure	STRING	Specifies the behavior of IM-OCF Ro when the OCF fails. Possible values: ALWAYS_REFUSE Degraded mode is disabled. If the OCF fails, IM-OCF Ro refuses to grant the service. USE_LOCAL_REFUSE Degraded mode is enabled. IM-OCF Ro writes CDRs. If a local OCF or CDR writing fails, IM-OCF Ro refuses to grant the service. USE_LOCAL_GRANT Degraded mode is enabled. IM-OCF Ro writes CDRs. If a local OCF or CDR writing fails, IM-OCF Ro grants the service. Note: This setting is overridden by the OCF AVPs 'Credit Control Failure Handling' and 'Realtime Required'. Default value: USE_LOCAL_REFUSE
CDR Mode	STRING	Specifies how IM-OCF Ro writes CDRs. Possible options: NORMAL IM-OCF Ro begins to write CDRs when IM-OCF Ro switches to the degraded mode. HISTORY Like in the Normal mode, IM-OCF Ro begins to write CDRs when IM-OCF Ro switches to the degraded mode. In addition, IM-OCF stores all CDRs that IM-OCF previously sent to the OCS. ALWAYS IM-OCF Ro always writes CDRs. Default value: NORMAL
CDR Writer Impl	STRING	Specifies the full path of the bundle that implements the CDR writer functionality. This is a preset parameter. Do NOT change the value of this parameter.
CDR Writer Service	STRING	Specifies the full path of the CDR writer service. This is a preset parameter. Do NOT change the value of this parameter.
Degraded Mode Timer	INT	Specifies the period of time, in milliseconds, that IM-OCF Ro waits for a response from the online charging server. If the online charging server does not respond within the specified period of time, IM-OCF Ro switches to the degraded mode.
Local-OCF Alias	STRING	Specifies the alias of the local online charging server. This alias is mapped to the destination host and destination realm of the local online charging server as defined in the configuration of Diameter SSU outbound routing rules. See the discussion on configuring outbound destinations in the Diameter SSU in Oracle Communications Service Broker Signaling Server Units Configuration Guide.
Local-OCF External Protocol	STRING	Specifies the protocol that IM-OCF Ro uses to communicate with the local online charging server.
Degraded Mode Error Codes	STRING	Specifies the error codes that trigger IM-OCF Ro to enable the degraded mode. You can type several error codes separated by comma.

Configuring Redirection

Charging IMs handling Diameter responses from online charging systems can perform session redirection based on criteria in Credit Control Answers (CCA). Configure the default IM redirection behavior in the IM configuration node Redirection tab.

See the discussion on redirection in Oracle Communications Service Broker Online Mediation Controller Implementation Guide for more information on using session redirection.