5 Service Management

This chapter explains the service management section of CCS.

This chapter contains the following topics.

Service Management Module

Domain

Currency Code

Currency

Global Configuration

Exchange Rates

Barred List

Capability

Number Translation List

MFile Generation

Balance Type Mapping

Security

About Voucher Security

Channel

Named Event

Service Management Module

The Service Management screen enables you to configure the service management section of CCS. It contains these tabs:

Accessing the Service Management screen

Follow these steps to open the Service Management screen.

  1. Select the Services menu from the SMS main screen.

  2. Select Prepaid Charging > Service Management.

    Result: You see the Service Management screen.

Configuration sequence

This table lists the configuration sequence required to correctly set up the service management part of CCS.

Note: Same numbers indicate configuration independence within the sequence.

Domain

You use the Domain tab to configure the following types of domains:

  • VWS (Voucher and Wallet Server)

  • DIAMETER

  • Third-party

  • BRM

The tab displays a list of the domains that have been configured. You can configure new domains, and edit, or delete exiting domains.

Topics:

About Domain Configuration Issues

Domain fields

Third-Party domain fields

Creating a Domain

Adding nodes to domains

Adding realms to domains

Editing Domains

Editing domain nodes

Editing domain realms

Deleting domains

Deleting domain nodes or realms

About Domain Configuration Issues

When you add a new domain or edit an existing domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, for any domains that are incorrectly configured. The system automatically updates this list as you resolve the issues by updating the domain configuration. You must resolve all the domain configuration issues before saving the domain.

The following table lists the possible configuration issues, and their resolutions:

Configuration Issue Resolution
Invalid Name Specify a unique name for the domain in the Name field.
Not Enough Checkboxes Select the check boxes in the Manages area for the features you require. You must select at least one check box.
Invalid Maximum Accounts Specify a valid number in the Maximum Accounts field.
Invalid Maximum Queue Messages If specified, the value for Maximum Queue Messages must be greater than the value for Minimum Queue Messages.
Not Enough Domain Nodes For VWS and DIAMETER domains, you must configure at least one domain node in the Nodes / Realms area.
Invalid Username For BCD domains, you must specify a valid user name of at least one character.
Invalid Password For BCD domains, you must specify a valid password of at least one character.

Domain fields

This table describes the domain fields in the BE area of the Domain screen.

Field Description
Name (Required) The unique name of the domain.
Type

(Required) Sets the domain type for this domain. The domain type defines the network element type (such as a Voucher and Wallet Server) for the domain nodes in this domain.

The list of available domain types is populated when applications are installed. The domain type for the Voucher and Wallet Server is always available.

Once you have added a node to a domain, this field becomes non-editable.

For more general information about domain types, see Domain Types.

For information about the domain type to choose for an additional installed application, see the application's technical guide.

Maximum Accounts (Required) Sets the maximum number of subscriber accounts that can be supported by the domain.
Update Username and Password Select to allow a BCD Client to connect to the BRM communication managers.
Username Sets the username to use to connect to the BRM communication managers.
Password Sets the username's password.
Wallet Management Charging

Whether or not wallet management charging functionality is supported for this domain.

'Y’ means wallet management charging functionality is supported by the domain and ‘N’ means it is not.

For more information about wallet functionality, see:

Wallet Management Tracking

Whether or not wallet management tracking functionality is supported for this domain.

'Y’ means wallet management tracking functionality is supported by the domain and ‘N’ means it is not.

Note: Wallet management tracking is only available to UBE domain types.

Voucher Management

Whether or not voucher management (including voucher redemption) is supported for this domain.

‘Y’ means voucher functionality is supported by the domain and ‘N’ means it is not.

For more information about voucher functionality, see Voucher Management.

Third-Party domain fields

This table describes the fields in the Third-Party area of the Domain screen. For details on a particular field, see the technical documentation for the application that provides connectivity with the required network element.

Field Description
Minimum Queue Messages Minimum queue messages value for third-party billing.
Maximum Queue Messages Maximum queue messages allowed before the connection is deemed congested.
Allow Adaption Select if adaption is required for third party billing.
Connection Retry The number of connection retries allowed.
Enable Guidance Select if guidance is required for third-party billing. The guidance cache size field becomes enabled.
Message Timeout Message timeout value for third-party billing.
Guidance Cache Size Guidance cache size for third-party billing.

Creating a Domain

When you add a new domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, warning you about any configuration that is incorrect. The system automatically updates this list as you configure the domain. For more information about configuration issues, see About Domain Configuration Issues.

Follow these steps to add a new domain.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Click New on the Domain tab.

    Result: The New Domain screen displays.

    For information about the fields and check boxes in the New Domain screen, see Domain fields.

  3. In the Name field, enter a unique name for the domain.

  4. From the Type list, select one of the following domain types:

    • UBE

    • A third-party type BE

    • A domain type with a DIAMETER prefix

    • BCD (for BRM)

    The domain type you select determines which fields are enabled. Fields that are disabled, appear grayed out.

    Note: The domain type for the Voucher and Wallet Server is UBE.

  5. Complete the fields as required. For details about the data to enter for the type of domain you want to create, see:

  6. Click Save.

    Result: The new domain is saved, and listed on the Domain tab.

Related topic

Domain

Specifying a UBE Domain

To specify a UBE domain, complete the following fields:

  • Type the number of allowed accounts in the Maximum Accounts field.

  • Select the Manages check boxes for the features you require.

  • Add at least one domain node to this domain. See Adding nodes to domains.

    You can edit or delete domain nodes as required. For information about editing domain nodes, see Editing domain nodes. For information about deleting domain nodes, see Deleting domain nodes or realms.

For more information about the fields and check boxes on the Domain screen, see Domain fields.

Specifying a Third-Party Domain

To specify a third-party domain, complete the following fields:

  • Type the number of allowed accounts in the Maximum Accounts field.

  • Select the Manages check boxes for the features you require.

  • In the Third-Party area, fill in the relevant fields, as described in Third-Party domain fields.

  • Add at least one domain node to this domain. See Adding nodes to domains.

    You can edit or delete domain nodes as required. For information about editing domain nodes, see Editing domain nodes. For information about deleting domain nodes, see Deleting domain nodes or realms.

For more information about the non-third-party fields and check boxes on the Domain screen, see Domain fields.

Specifying a Diameter Domain

To specify a Diameter domain, complete the following fields:

  • Type the number of allowed accounts in the Maximum Accounts field.

  • Select the Manages check boxes for the required features.

  • In the Third-Party area, fill in the Minimum Queue Messages, Maximum Queue Messages and Connection Retry fields, as described in Third-Party domain fields.

  • Add at least one realm to this domain. See Adding realms to domains.

    You can edit or delete realms as required. For information about editing domain realms, see Editing domain realms. For information about deleting domain realms, see Deleting domain nodes or realms.

For more information about the non-third-party fields and check boxes on this screen, see Domain fields.

Specifying a BRM Domain

To specify a BRM domain, complete the following fields:

  • In the Name field, enter BRM

  • From the Type list, select BCD

  • In the Maximum Accounts field, enter the maximum number of accounts in this domain.

  • Select the Update Username and Password check box and enter values for Username and Password, which are used by the BCD Client to connect to the BRM communication managers.

  • (Optional) In the Manages area, select the Charging and Voucher Management check boxes.

For more information about the fields and check boxes on the Domain screen, see Domain fields.

Adding nodes to domains

Follow these steps to add a node to a domain.

  1. From either the New Domain or Edit Domain screen, click New.

    Result: The New Domain Node screen appears.

  2. Type a unique name for the node in the Name field.

  3. Select the Node Number from the drop down list (the node number must be unique). This is a required field for UBE domains, and optional for third-party domains.

    Notes:

    • Where there is more than one node for a domain, the primary node has the lower number.

    • UBE is the domain type for a Voucher and Wallet Server.

  4. Type the IP address for the node in the Address field.

    Note: This field is automatically populated if you select a Node Number. You can edit this address if required.

  5. Type the client port address in the Client Port field.

  6. Type the internal port address in the Internal Port field.

  7. If this is a third-party domain, enter values for the following fields. See the relevant third-party billing technical documentation for more information:

    • Minimum Weight

    • Maximum Weight

    • Stable Weight

    • Unstable Weight

    Note: These fields appear grayed out for UBE domain nodes.

  8. Click Save.

    Result: The new node is saved and then listed in the Nodes / Realms area of the New or Edit Domain screen.

Related topic

Domain

Adding realms to domains

Follow these steps to add a realm to a diameter domain.

  1. From either the New Domain or Edit Domain screen, click New.

    Result: The New Domain Realm screen appears.

  2. Type a unique name for the realm in the Name field.

  3. Type the identity of the realm in the Identity field.

    Example: realm1.telcoexample.com

  4. (Optional) Enter a value in the Stable Weight field. Defaults to 1.

  5. Click Save.

    Result: The new realm is saved and then listed in the Nodes / Realms area of the New or Edit Domain screen.

Related topic

Domain

Editing Domains

When you edit a domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, warning you about any configuration that is incorrect. The system automatically updates this list as you edit the domain configuration. For more information about configuration issues, see About Domain Configuration Issues.

Follow these steps to edit a domain.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the domain to edit from the table in the Domain tab.

  3. Click Edit.

    Result: The Edit Domain screen appears.

  4. Change the following fields as required:

    • Domain name in the Name field

    • Maximum number of accounts in the Maximum Accounts field

    • Wallet Management Charging

    • Voucher Management check box.

    See Domain fields for a description of these fields and check boxes.

  5. If this is a non-UBE domain, you may also change the following fields as required. If the domain is:

    • BCD:

      • Update Username and Password check box

      • Username

      • Password

    • third-party:

      • Minimum Queue Messages

      • Maximum Queue Messages

      • Connection Retry

      • Allow Adaptation check box

      • Message Timeout

      • Enable Guidance check box and Guidance Cache Size

    • DIAMETER:

      • Minimum Queue Messages

      • Maximum Queue Messages

      • Connection Retry

    For details, see the relevant BCD, third-party billing or Diameter technical documentation.

    Note: UBE is the domain type for a Voucher and Wallet Server.

  6. Depending on the type of domain:

  7. Click Save.

    Result: The domain changes are saved and reflected in the Domain tab table.

Related topic

Domain

Editing domain nodes

Follow these steps to edit a domain node.

  1. From the table in the Nodes / Realms area in either the New Domain or Edit Domain screen, select the node you want to update and click Edit.

    Result: The Edit Domain Node screen appears.

  2. Update the following fields as required:

    • Node address in the Address field

    • Client port address in the Client Port field

    • Internal port address in the Internal Port field

  3. If this is a third-party domain, update the following fields as required. See the relevant third-party billing technical documentation for more information:

    • Minimum Weight

    • Maximum Weight

    • Stable Weight

    • Unstable Weight

    Note: These fields appear grayed out for UBE domain nodes.

  4. Click Save.

    Result: The node is saved.

Related topic

Domain

Editing domain realms

Follow these steps to edit a domain realm.

  1. From the table in the Nodes / Realms area of either the New Domain or Edit Domain screen, select the realm you want to update and click Edit.

    Result: The Edit Domain Realm screen appears.

  2. Update the following fields as required:

    • Identity

    • Stable Weight

  3. Click Save.

    Result: The realm is saved.

Related topic

Domain

Deleting domains

Follow these steps to delete a domain.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the domain to delete from the table in the Domain tab.

  3. Click Delete.

    Result: The Delete Confirmation screen appears.

  4. Click OK.

    Result: The domain is deleted from the Domain tab table.

Related topic

Domain

Deleting domain nodes or realms

Follow these steps to delete a node or a realm from a domain.

  1. From the table in the Nodes / Realms area of either the New Domain, or Edit Domain screen, select the node or realm that you want to delete, and click Delete.

    Result: The delete confirmation screen appears.

  2. Click Apply.

    Result: The node or realm is marked for deletion. It is then deleted from the database when you click Save in the Edit or New Domain screen.

    Note: To be able to save the domain in the Domain screen, the domain must have at least one node or realm configured.

Related topic

Domain

Currency Code

The Currency Code tab enables you to view, create, edit and delete the currency codes that are available in the system.

Topics:

Adding a Currency Code

Editing a Currency Code

Deleting a Currency Code

Adding a Currency Code

Follow these steps to add a new currency code.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On the Currency Code tab, click New.

    Result: You see the New Currency Code screen.

  3. Enter the three-letter currency code in the Code field.

  4. Enter a description of the currency code in the Description field.

  5. Click Save.

Related topic

Currency Code

Editing a Currency Code

Follow these steps to edit an existing currency code.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the currency code to edit from the table on the Currency Code tab.

  3. Click Edit.

    Result: You see the Edit Currency Code screen.

  4. If required, change the three-letter currency code in the Code field.

  5. If required, change the description of the currency code in the Description field.

  6. Click Save.

Related topic

Currency Code

Deleting a Currency Code

Follow these steps to delete an existing currency code.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the currency code to delete from the table on the Currency Code tab.

  3. Click Delete.

    Result: The Delete Confirmation prompt appears.

  4. Click OK to delete the record from the database.

    Result: The record is deleted and the Currency prompt is displayed.

  5. Click OK.

Related topic

Currency Code

Currency

The Currency tab enables you to:

  • Configure the default system currency

  • View currencies which have been set up in the system

When setting up the system for the first time, it is important to set the default currency before configuring the rest of the system (and after configuring the VWSs).

For each new currency entered into the system, a rate of exchange between the new currency and the system currency must be set. This exchange rate is set on the Exchange Rates tab of the Service Management screen.

Topics:

Currency entry components

Recharging Credit Cards - required components

Currency details

Announcements

Recharges 1-5

Recharges 6-9

Editing a currency

Deleting a currency

Currency entry components

When adding a new currency to CCS, a number of inter-related components must be completed before the new currency can be used.

These components are configurable from the New Currency and Edit Currency screens, and are as follows:

  • Configure Announcements

  • Configuring Recharge Options 1-5

  • Configuring Recharge Options 6-9

Recharging Credit Cards - required components

The following currency components are required for recharging credit cards.

  • Configuring Recharge Options 1-5

  • Configuring Recharge Options 6-9

The actual recharge options are defined in the Product Type tab, Creditcard Recharge Rules.

Each caller has a maximum of nine recharge options per currency available. The announcement entry and set are selected for each option. The option announcements work as follows:

Caller options The system will play the balance announcement...
1 followed by the “Press * to cancel” as defined by the announcement set selected in the One option section.
2 followed by the “Press * to cancel” as defined by the announcement set selected in the Two options section.
3 followed by the “Press * to cancel” as defined by the announcement set selected in the Three options section.
4 followed by the “Press * to cancel” as defined by the announcement set selected in the Four options section.
5 followed by the “Press * to cancel” as defined by the announcement set selected in the Five options section.
6

as defined by the announcement set selected in the Five options and on section.

Plus the recharge announcement set selected in the Recharge option six section followed by the “Press * to cancel”

7

as defined by the announcement set selected in the Five options and on section.

Plus the recharge announcement set selected in the Recharge options 6-7 section followed by the “Press * to cancel”

8

as defined by the announcement set selected in the Five options and on section.

Plus the recharge announcement set selected in the Recharge options 6-8 section followed by the “Press * to cancel”

9

as defined by the announcement set selected in the Five options and on section.

Plus the recharge announcement set selected in the Recharge options 6-9 section followed by the “Press * to cancel”

Example announcements

A caller has six options for their account.

The first announcement, defined in the Five options and on field, is configured to play the following:

"Your balance is x Big_Currency and y Small_Currency

To recharge by Recharge_Option_1 Big_Currency, press 1

To recharge by Recharge_Option_2 Big_Currency, press 2

To recharge by Recharge_Option_3 Big_Currency, press 3

To recharge by Recharge_Option_4 Big_Currency, press 4

To recharge by Recharge_Option_5 Big_Currency, press 5"

The next announcement, defined in the Recharge option six field, will play the following:

"To recharge by Recharge_Option_6 Big_Currency, press 6

Press * to cancel."

If Big_Currency is dollars and Small_Currency is cents, the announcements played would be like this:

"Your balance is two dollars and twenty five cents

To recharge by five dollars press 1

To recharge by ten dollars press 2

To recharge by twenty dollars press 3

To recharge by fifty dollars press 4

To recharge by one hundred dollars press 5"

"To recharge by two hundred dollars, press 6

Press * to cancel.”

Currency details

All configuration options must be completed to finalize a currency so it can be used. However, the configuration can be saved at any point by clicking Save.

To configure a currency as a default currency for the system, configure the currency here, and then set it as the default in the Global Configuration screen.

Follow these steps to add currency details for a new currency.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On the Currency tab, click New.

    Result: The New Currency screen displays with the Currency options.

  3. Enter the symbol that represents the main unit of the currency in the Big Symbol field (for example, for euros).

  4. Enter the symbol that represents the subunit of the currency in the Little Symbol field (for example, c for cents).

  5. Select the currency name from the Name drop down box.

    Note: Only valid currency names are available from the list.

    Result: The Currency Code field is populated by the system. This shows the currency code that identifies the currency.

  6. Enter the separator used to separate the main unit from the subunit of the currency in the Separator field.

    Examples: In the currency of:

    • Euros - the separator is a comma (for example, 3,20)

    • Dollars - the separator is a decimal point (for example, $4.00)

  7. Enter the ratio of subunits to main units of currency in the Base field.

    Example: 100 cents per euro = a ratio of 100.

  8. Click Save.

  9. Configure the Announcements.

  10. Configure the announcements for Recharge options 1-5.

  11. Configure the announcements for Recharge options 6-9.

Related topic

Currency

Announcements

Follow these steps to add the confirmation prompt announcement for a new currency.

  1. Select the Configure Announcements option in the New Currency screen.

    Result: You see the Configure Announcements option, displaying the Confirmation Prompt configuration.

  2. Select from the Confirmation Prompt section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller when prompting for caller confirmation of a recharge

  3. Click Save.

Recharges 1-5

Follow these steps to add the announcements for recharge options 1-5 for a new currency.

  1. Select the Recharge options 1-5 option in the New Currency screen.

    Result: You see the Recharge options 1-5, displaying announcements for currency Recharge one to five, plus more than five.

  2. Select from the One option section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have one recharge option

  3. Select from the Two options section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have two recharge options.

  4. Select from the Three options section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have three recharge options.

  5. Select from the Four options section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have four recharge options.

  6. Select from the Five options section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have five recharge options.

  7. Select from the Five options and on section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have more than five recharge options.

  8. Click Save.

Recharges 6-9

Follow these steps to add the announcements for recharge options 6-9 for a new currency.

  1. Select the Recharge options 6-9 option from the New Currency screen.

    Result: You see the Recharge options 6-9, displaying announcements for currency recharge six to nine.

  2. Select from the Recharge option six section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have six recharge options.

    This will include the announcements set from Five options and on.

  3. Select from the Recharge options 6-7 section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have seven recharge options.

    This will include the announcements set from Five options and on.

  4. Select from the Recharge options 6-8 section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have eight recharge options.

    This will include the announcements set from Five options and on.

  5. Select from the Recharge options 6-9 section:

    • The Announcement Set from the Set drop down box

    • The Announcement Entry from the Entry drop down box that is to be played to a caller if they have nine recharge options.

    This will include the announcements set from Five options and on.

  6. Click Save.

Editing a currency

Follow these steps to edit the details of an existing Currency record.

To configure a Currency as a Default Currency for the system, configure the Currency here, and then set it as the default in the Global Configuration screen.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record o edit from the Currency tab table.

  3. Click Edit.

    Result: The Edit Currency screen displays, showing the Currency options.

  4. Edit the currency details as described in Currency details.

    Warning: You cannot change the Base once set.

  5. Click Save.

Related topic

Currency

Deleting a currency

Follow these steps to delete an existing currency configuration record.

To remove a currency as a default currency for the system, see the Global Configuration screen.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to delete from the Currency tab table.

  3. Click Delete.

    Result: You see the Delete Confirmation prompt.

  4. Click OK to delete the record from the database.

    Result: The record is deleted and the Currency prompt displays.

  5. Click OK.

Related topic

Currency

Global Configuration

You set the following global configuration on the Global Configuration tab in the Service Management window:

Adding or editing a language map

Language maps determine what language the system currency is announced in.

Follow these steps to add a new, or edit an existing language map.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the Global Configuration tab, click Edit.

    Result: You see the Edit Global Configuration screen.

  3. Select the Language Menu Option Mapping option.

    Result: The screen displays the Language menu option mapping section.

  4. To add a new mapping:

    • Click Insert

    To edit an existing mapping:

    • Select the Language item to change from the table

    • Click Edit

    Result: You see the Edit/Insert screen.

  5. Select the Language from the drop down list.

  6. For a new mapping, enter the key mapping number in the Key Mapping field.

    Warning: This cannot be changed once saved.

  7. Click Save to update the table.

  8. Click Save to the details to the database.

Related topic

Global Configuration

Deleting a language map

Follow these steps to delete a language map.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the Global Configuration tab, click Edit.

    Result: You see the Edit Global Configuration screen.

  3. Select the Language Menu Option Mapping option.

    Result: The screen displays the Language menu option mapping section.

  4. Select the Language item to delete from the table.

  5. Click Delete.

  6. Click Save to the details to the database.

Related topic

Global Configuration

Exchange Rates

The Exchange Rates tab allows you to view, add, edit and delete the Exchange Rates that are available in the system.

Account balances are stored in the System Currency, then converted to the user’s selected Currency by the indirect rate of exchange set in this tab.

Topics:

Adding an exchange rate

Editing an exchange rate

Deleting exchange rates

Adding an exchange rate

Follow these steps to add a new Exchange Rate record.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the Exchange Rates tab, click New.

    Result: The New Exchange Rate screen appears with the default System Currency displayed in the System Currency field.

  3. Select the Currency to convert the System Currency to from the Currency drop down box. The list will display all available Currencies that are set up on the Currency tab.

  4. Type the value which the System Currency will be multiplied by to establish the Currency value in the Indirect Rate of Exchange field.

    The indirect rate of exchange is the value of 1 unit of System Currency in the selected Currency.

    Example: If the Indirect Rate of Exchange is set to 4, 1 unit of the System Currency will result in 4 of the configured Currency units. Consequently if an Account Balance is 100 Zloty, and the Exchange Rate to Euros is set at 0.22, the Account Balance will be converted to 22 Euros.

  5. Click Save.

Related topic

Exchange Rates

Editing an exchange rate

Follow these steps to edit an existing Exchange Rate.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the Exchange Rates tab, select the Exchange Rate to edit.

  3. Click Edit.

    Result: The Edit Exchange Rate screen appears.

  4. Enter the value which the System Currency will be multiplied by to establish the Currency value in the Indirect Rate of Exchange field.

    The indirect rate of exchange is the value of 1 unit of System Currency in the selected Currency.

    Example: If the Indirect Rate of Exchange is set to 4, 1 unit of the System Currency will result in 4 of the configured Currency units. Consequently if an Account Balance is 100 Zloty, and the Exchange Rate to Euros is set at 0.22, the Account Balance will be converted to 22 Euros.

  5. Click Save.

Related topic

Exchange Rates

Deleting exchange rates

Follow these steps to delete an existing Exchange Rate record.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the Exchange Rates tab, select the Exchange Rate to delete.

  3. Click Delete.

    Result: The Delete Confirmation prompt appears.

  4. Click OK to delete the record from the database.

    Result: The record is deleted and you see the Exchange Rate successfully deleted message.

  5. Click OK.

Related topic

Exchange Rates

Resource Limits

The Resource Limits screens enable the service provider's resource limits to be specified. These limits prevent a service provider from using more than the specified number of:

  • Product types

  • Voucher types

All configuration options must be completed to finalize a resource limit; however the configuration can be saved at any point by clicking Save.

Notes:

  • All service providers must have resource limits configured for them.

  • Resource limits can only be set for existing service providers. Service providers are added as ACS customers in the ACS Customers screen. For more information about adding new service providers, see ACS User's Guide.

Topics:

Resource Limits tab fields

Configuration options summary

Editing Resource Limits

Limits

Business Prefix

Sets

Call Barring

Number Translations

Bypass Numbers

Profile Group Limitations

Deleting resource limits

Resource Limits tab fields

The Resource Limits tab contains display-only fields, showing the limits and the current usage of the resource. The following table shows where you set the value in each limit field.

Field Where Set

Maximum Product Types

Maximum Voucher Types

Edit Resource Limits screen, Limits option.

Global Business Prefix

Account Number Prefix

Edit Resource Limits screen, Business Prefix option.

Configuration options summary

This table lists all the resource limits configuration options and their functionality.

Note: The service provider is also known as the customer in ACS.

Option Description
Limits Sets the resource limits for a service provider that prevent the service provider from using more than the specified number of product types, voucher types and rate tables.
Business Prefix

Sets:

  • The global business prefix that a subscriber enters at the beginning of a dialed telephone number to ensure that the call charge is logged against the primary business wallet of their account

  • The account number prefix for a service provider. When you create a new subscriber, the first two digits of the subscriber card number are automatically set to the specified account number prefix. You must specify a unique value in the range of 10 to 99, or leave blank if you do not want to use a specified account number prefix.

Sets Sets which public resource sets are available to a service provider.
Call Barring Sets the numbers that are allowed or barred at service provider level.
Number Translations Sets number translation mappings for the service provider, and displays them in the Short Codes list. The service short codes are mapped to termination numbers. When the short code is dialed, the call is routed to the termination number.
Bypass Numbers Sets the bypass numbers that are allowed or barred at service provider level. A bypass number is a number that has a discount applied to it. The discount that applies to bypass numbers is set in the Bypass Discount panel.
Profile Group Limitations

Sets default limits for LNSTRING and LOPREFIX profile group fields. The limits set for the product type will override the limits set here.

For more information about setting product type limits, see Subscriber Profile Limitations.

For information on setting each resource limit, see Editing Resource Limits.

Editing Resource Limits

Follow these steps to edit an existing resource limit.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Click Edit on the Resource Limits tab.

    The Edit Resource Limits screen displays.

  3. Select the required options and edit the details of the record. See:

  4. Click Save.

Related topic

Resource Limits

Limits

Follow these steps to add limits to Resource Limits for a service provider.

  1. Select the customer from the Service Provider drop down box.

  2. From the Resource Limits tab of the Resources screen, click Edit.

    The configurable limits display in the Edit Resource Limits screen. For more information, see Resource Limits tab fields.

  3. In the relevant fields, set the maximum number of the following resources that the service provider may use:

    • Product types

    • Voucher types

    Tip: It is not possible to set the resources allowed to a value lower than the number of resources already used, as displayed on the Resource Limits tab. To reduce the numbers that the service provider may use in the case where the maximum number has been reached, you must first reduce the number that the service provider uses.

  4. Click Save.

Related topic

Resource Limits

Business Prefix

Follow these steps to configure the Global Business Prefix number for the service provider.

  1. Select Business Prefix in the left hand menu in the Edit Resource Limits screen.

    The Business Prefix option fields display.

  2. (Optional) Specify the global business prefix by entering the digits and special characters for the prefix in the Global Business Prefix field. You can include any of the following allowed values in the prefix: 0-9, #, and *.

    The subscriber must enter this prefix at the beginning of a dialed telephone number to enable the call to be charged to their business wallet instead of their personal wallet.

    You must include the Business Prefix Branch feature node in the control plan to enable the global business prefix feature. For more information about control plans, see the CPE User's Guide. For more information about the Business Prefix Branch feature node, see Feature Nodes Reference Guide.

  3. (Optional) Specify the prefix that will be prepended to a subsriber's card ID by entering the two digit prefix in the Account Number Prefix field. Specify a value between 10 and 99 that is unique to this service provider, or leave blank if you do not want to use account number prefixes.

  4. Click Save.

Related topic

Resource Limits

Sets

Follow these steps to configure private reusable data set limits for service providers.

  1. Select the Sets option from the left hand menu in the Edit Resource Limits screen.

    The Sets option displays, and shows a list of all the public data sets.

  2. In the Allocation Public Geography Sets section, select the check box for each geography set that you want to make available to the service provider.

    You create geography sets on the Geography tab of the ACS Configuration screen.

  3. In the Allocate Public Announcement Sets section, select the check box for each announcement set that you want to make available to the service provider.

    You create announcement on the Announcements tab of the ACS Configuration screen.

  4. In the Allocate Public Holiday Sets section select the check box for each holiday set that you want to make available to the service provider.

    You create holiday sets on the Holidays tab of the ACS Configuration screen.

  5. Click Save.

    For more information about the ACS Configuration screen, see ACS User's Guide.

Related topic

Resource Limits

Call Barring

This manages allowed/ barred lists for service providers.

Allowed/barred lists can also be set at these levels:

  • System-wide

  • Product type (see the New or the Edit Product Type screen Call Barring option)

  • Subscriber account (see the New or the Edit Subscriber screen, Call Barring option)

Follow these steps to configure call barring for customers.

  1. Select the Call Barring option from the left hand menu in the Edit Resource Limits screen.

    The Call Barring option displays, showing the Allowed/Barred List configuration for the service provider.

  2. Select whether the listed numbers will be allowed or barred from the List Type drop down list in the Service Allowed/Barred List section.

    Note: All numbers in the list are allowed, or all numbers are barred, according to the list type. It is not possible to have some allowed and some barred numbers in the list.

  3. Select the Ignore check box if you want the service to ignore the allowed/barred list.

  4. Edit the number list in the Service Provider Allowed/Barred List section. To:

    • Add numbers to the list:

      • In the New Number field, enter the number

      • Click Add.

    • Delete numbers from the list:

      • Select the number in the Number List field

      • Click Delete.

  5. If required, repeat step 4 until the number list is complete.

  6. Click Save.

Related topic

Resource Limits

Number Translations

This manages number translation lists for service providers.

You can also set number translations at these levels:

  • Global

  • Product type

  • Subscriber account

Follow these steps to configure the number translation list limits for the service provider.

  1. Select the Number Translations option from the left hand menu in the Edit Resource Limits screen.

    The Number Translations option displays, listing the configured short codes.

  2. Edit the number list in the Short Codes section.

    To add a number to the list:

    1. In the In field, enter the service short code to translate.

    2. In the Out field, enter the termination number that the short service code translates to.

    3. Click Add.

    To delete a number from the list:

    1. Select the number in the Number List table.

    2. Click Delete.

  3. Repeat step 2 until all the codes are included.

  4. Click Save.

Related topic

Resource Limits

Bypass Numbers

Follow these steps to configure the bypass numbers at a service provider level.

Tip: Bypass Numbers can also be configured at the following levels:

  • Global

  • Product type

  1. Select the Bypass Numbers option from the left hand menu in the Edit Resource Limits screen.

    The Bypass Numbers option displays, showing the bypass numbers configuration for the service provider.

  2. Select the List Type from drop down box in the Service Provider Bypass Numbers section.

    Note: The list type determines whether the listed bypass numbers are all barred, or all allowed.

  3. Select the Ignore check box if the service is to ignore the number list.

  4. Edit the number list in the Service Provider Bypass Numbers section.

    To add a number to the list:

    1. Enter a bypass number in the New Number field

    2. Click Add.

    To delete a number from the list:

    1. Select the number from the Number List

    2. Click Delete.

  5. Repeat step 4 until the number list is complete.

  6. Click Save.

Related topic

Resource Limits

Profile Group Limitations

Follow these steps to configure the service provider-level limits for LNSTRING and LOPREFIX profile field types.

Tip: You can override the limits set here by setting the profile field type limits for the product type.

  1. Open the Profile Group Limitations group in the Edit Resource Limits screen, and select the profile field that you want to set limits for.

    The Profile Group Limitations option displays the configuration for the selected field.

  2. Select the Ignore Limitations check box if required:

    • When selected, the limits are ignored and the system default resource limits are used.

    • When not selected, the limits set here are used.

  3. In the Max Number of Entries field, if present, type the maximum number of prefixes that may be included in the Number List. Defaults to 100 if no value is specified.

    Note: This field is only available for LOPREFIX type fields.

  4. In the Min Number Length field type the minimum numeric value for the Profile Group Field. Defaults to zero if no value is specified.

  5. In the Max Number Length field type the maximum numeric value for the profile group field. Defaults to 255 if no value is specified.

  6. Select the Limitation Prefix Tree Type from the drop down list. If you select:

    • Allowed – The profile group field value must match an entry in the Number List.

    • Barred – The profile group field value must not match an entry in the Number List.

  7. Edit the Number List.

    To add a number to the list:

    1. Enter a required number in the New Number field.

    2. Click Add.

    To delete a number from the list:

    1. Select the number from the Number List, select the number.

    2. Click Delete.

  8. Repeat step 7 until the number list is complete.

  9. Click Save.

Related topic

Resource Limits

Deleting resource limits

Customers must have resource limits. You can only change the values, not delete them.

Related topic

Resource Limits

Barred List

The Barred List tab enables you to view, add or delete numbers that are either allowed or barred from use.

This list manages allowed/ barred lists system wide.

You can also set barred allowed lists at these levels:

Topics:

Adding numbers to the barred list

Adding numbers to the barred list

Follow these steps to edit the service allowed/barred numbers list.

  1. From the Barred List tab, click Edit.

    Result: You see the Edit Service Allowed/Barred Numbers List screen.

  2. In the Service Allowed/Barred List section, select the List Type from the drop down list. This determines whether the listed numbers will be allowed or barred.

    Note: All numbers in the list are allowed, or all numbers are barred, according to the list type. It is not possible to have some allowed and some barred numbers in the list.

  3. If you want the service to ignore the allowed/barred list, select the Ignore check box.

  4. To edit the Number List:
    • Add a number:

      • Enter the number to add in the New Number field

      • Click Add

    • Delete a number:

      • Select the number to remove from the list

      • Click Delete

  5. If required, repeat step 4 until all the numbers are listed.

  6. Click Save.

Related topic

Barred List

Capability

The Capability tab allows you to define global capabilities. You can specify the default control plan for the capability, the service trigger, called party number, and the EDR type to output.

Capabilities are associated with control plans in the Product Type screen. See Control Plans.

The default capabilities are VOICE_MO (originating) and VOICE_MT (terminating).

Topics:

Capability fields

Adding a capability

Editing a capability

Deleting balance type mapping

Capability fields

This table describes the function of each field.

Field Description
Name

The name given to this capability definition.

The name is used as the identifier in the Control Plans option in the Product Type screen.

Service

The service name that triggers this capability.

Service names are defined in /IN/service_packages/ACS/etc/acs.conf

For more information about configuring service names, see ACS Technical Guide.

CdPN (Called Party Number on New and Edit screens) The called party number used when matching the capability definition. (Optional.)
Default Control Plan

The default control plan invoked by this capability definition. The default control plan is run when the calling party number is not a known subscriber.

The control plan drop down list displays all the control plans a subscriber can use.

Tip: This list can be shortened by using the Search By field and then Search.

Search By

Use initial characters of the control plan name or combine with % (match on any number of characters), or _ (match on a single character).

Examples:

Search for e%SMS will find all control plan names beginning with e and containing SMS.

Search for e_han%SMS will find all control plan names beginning with e, containing the string han in positions 3 to 5, and containing SMS.

The list can be further restricted by entering a maximum number of names to show in the Max Rows field.

Statistics Category

In license reports, calls on this capability will be reported against the service specified in this field.

For more information about License reports, see License.

Statistics Protocol In license reports, calls on this capability will be reported against the protocol specified in this field.
Bearer Capability The bearer capability (InitialDP itc field (information transfer capability)) used when matching the capability definition. (Optional.)
CDR Type The regular call EDR type to use for the capability.
In-Session Notifications You can select an in-session notifications trigger for the call capability, if required. The trigger defines the control plan to invoke, and the associated session data to pass to it to handle in-session notifications reported by the charging system.

Adding a capability

Follow these steps to add a new Capability definition.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On the Capability tab, click New.

    Result: You see the New Capability screen.

  3. Configure this record by entering data in the fields on this screen.

    For more information about the fields on this screen, see Capability fields.

  4. Click Save.

    Warning: You must restart the SLEE in order for the changes to take effect. For more information about restarting the SLEE, see SLEE Technical Guide.

Related topic

Capability

Editing a capability

Follow these steps to edit a Capability definition.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On table on the Capability tab select the record to edit and click Edit.

    Result: You see the Edit Capability screen.

  3. Edit the fields to reflect the required changes.

    For more information about the fields on this screen, see Capability fields.

  4. Click Save.

    Warning: The SLEE will need to be restarted in order for the changes to take effect.

Related topic

Capability

Deleting a capability

Follow these steps to delete an existing Capability definition.

Warning: Caution should be used when deleting existing capabilities as the system may become unstable if a capability is deleted that is used by a configured service, such as CCS_BPL.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to delete from the table on the Capability tab.

  3. Click Delete.

    Result: The Delete Confirmation displays.

  4. Click OK.

    Results:

    • The record is deleted from the database.

    • The Capability confirmation prompt displays.

  5. Click OK.

    Warning: The SLEE will need to be restarted in order for the changes to take effect.

Related topic

Capability

Number Translation List

The Number Translation List tab enables you to view, add, edit and delete the service short codes that are mapped to specific termination numbers within the CCS service.

In this tab, the numbers which are displayed in the In column are service short codes which are mapped to the termination numbers displayed in the Out column. Incoming calls use the service short codes, which are then routed to the outgoing termination numbers.

This manages number translation lists system-wide.

The translation list exists at three other levels, in the order they are set. These are:

  • Level 1 Service Provider

  • Level 2 Product Type

  • Level 3 Subscriber account Level

These are checked in the order they are placed in the control plan.

Topics:

Editing numbers in the translation list

Editing numbers in the translation list

Follow these steps to edit the numbers on the Number Translation List.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. From the Number Translation List tab, click Edit.

    Result: You see the Edit Service Short Codes/Number Translation List screen.

  3. In the Service Short Codes section, edit the Number List as required. To:

    • Add a number pair:

      • In the In field, enter the service short code you want to map to a termination number

      • In the Out field, enter the termination number you want to translate the short service code to

      • Click Add

    • Delete a number pair:

      • In the Number List table, select the number

      • Click Delete.

  4. If required, repeat step 3 to add/delete more numbers in the Number List.

  5. Click Save.

Related topic

Number Translation List

MFile Generation

MFiles are used to store data which is not changed very often (for example, tariffs). MFiles are compiled on the Voucher and Wallet Server nodes to provide a fast lookup for a subset of the data in the E2BE database. You can generate a separate CCS Rating MFile and CCS Product Catalogue MFile for each service provider. This enables you to manage MFiles separately for each service provider. You generate MFiles from the MFile Generation tab.

Note: All the relevant tariff information must be established before the MFile Generation tab is available.

For more information about MFiles, see VWS Technical Guide.

Topics:

MFile distribution process

MFile Fields

Adding an MFile

Editing an MFile

Deleting an MFile

MFile distribution process

This topic describes the MFile distribution process.

  1. Through the New or Edit MFile Generation screen, the administrator updates the details contained in the MFile and clicks Save.

    Result: The data and an update request are transferred to the VWS nodes.

  2. When the update request arrives on the VWS, ccsMFileCompiler:

  3. Creates a new MFile from the updated data in the E2BE database

  4. Sends a request to the beServer to reload the MFile

  5. Then ccsMFileLoader:

  6. Reloads the new MFile

  7. Updates the E2BE database to indicate that the new MFile has been reloaded

MFile Fields

This table describes the function of each field.

Field Description
Domain

The Voucher and Wallet Server pair you will send the MFile to.

This field is populated by the Domain tab.

This field cannot be edited once it is initially saved.

Description The description of the MFile.
Request Date

The date the MFile was last requested to run.

Note: This field is only available on the Edit MFile screen.

Type

Whether the MFile is for:

  • Rating

  • Named event catalogue

Adding an MFile

Follow these steps to add a new MFile for a selected service provider.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. From the MFile Generation tab, click New.

    Result: You see the New MFile Configuration screen.

  3. Configure this record by entering data in the fields on this screen.

    For more information about the fields on this screen, see MFile Fields.

  4. Click Save.

    Result: ccsMFileCompiler on the VWS nodes within the chosen domain builds up a new MFile and notifes the VWS processes.

Related topic

MFile Generation

Editing an MFile

Follow these steps to edit an existing MFile generation record.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the table on the MFile Generation tab, select the MFile generation record to edit.

  3. Click Edit.

    Result: You see the Edit MFile Configuration screen.

  4. In the Description field, update the description of the MFile.

    For more information about the fields in this screen, see MFile Fields.

  5. Click Save.

Related topic

MFile Generation

Deleting an MFile

Follow these steps to delete an existing MFile generation record.

Note: There must be a current MFile when the Voucher and Wallet Servers are restarted.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the table on the MFile Generation tab, select the MFile to delete.

  3. Click Delete.

    Result: You see the Delete Confirmation prompt.

  4. Click OK.

    Result: You see the MFiles confirmed delete prompt.

  5. Click OK.

Related topic

MFile Generation

Balance Type Mapping

The Balance Type Mapping tab is used for:

  • Mapping third-party balance types to Convergent Charging Controller balance types (for example, from ECE balance types to Convergent Charging Controller balance types)

  • Filtering wallet recharges for wallets distributed across a third-party charging domain and a VWS tracking domain

Balance type mapping allows the feature nodes that operate against Balance Types to function for third-party balance types as well as those on the VWS.

Note: If balance type mapping is not defined for a Balance Type, wallet recharges are sent to the VWS by default.

Topics:

Balance type mapping fields

Scenarios

Adding balance type mapping

Editing balance type mapping

Deleting balance type mapping

Balance type mapping fields

This table describes the function of each field.

Field Description
Balance Type

List of available balance types. This list is restricted to chargeable balance types.

When you select None, Convergent Charging Controller uses the balance type mapping configuration for filtering wallet recharges through the charging and/or tracking domain. See Scenarios.

Third-Party Resource

The third-party balance ID to map to the Convergent Charging Controller balance type.

This text field accepts letters, digits, and spaces.

Third-Party Resource Scale

The scaling factor for converting balance values between Convergent Charging Controller balance types and third-party balance types.

For example, if Convergent Charging Controller uses hundredths of seconds for time balances, but the BRM equivalent uses seconds, the scaling factor converts the BRM seconds to the Convergent Charging Controller hundredths of seconds.

Note: This field accepts:

  • Positive and negative numbers. A negative number means to apply sign inversion to the calculated value.

  • Number values up to 10000.

  • Numbers with up to 5 decimal places.

Domain Type List of available non-VWS domain types. This field associates the balance type mapping configuration with the specified domain.

Scenarios

This table describes the results of voucher redemptions in different balance type mapping scenarios.

Voucher Type Result
Subscriber applies a split domain voucher type

Given a subscriber who has a wallet in both the VWS and BCD domains and a balance type that has balances defined in both domains:

When the voucher is applied to the subscriber's wallet, the balances in both domains are modified at the same time.

Subscriber applies a VWS domain voucher type

Given a subscriber who has a wallet in both the VWS and BCD domains and a voucher that has balances only in the VWS domain:

When the voucher is applied to the subscriber's wallet, only balances in the VWS domain are modified.

typeSubscriber applies BCD domain voucher type

Given a subscriber who has a wallet in both the VWS and BCD domains and a voucher type that has balances in the BCD wallet domain:

When the voucher is applied to the subscriber's wallet, only the balances in the BCD domain are modified.

This table describes the results of actions by a screen user who wants to associate a chargeable balance type with a domain.

Scenario Result
Create a new mapping between a chargeable balance type and a domain When the user selects a chargeable balance type and a domain type and clicks the Save button, the balance type will be associated with the domain type.
Creating a new mapping between a chargeable balance type and a non-VWS domain When the user selects a chargeable balance type and a non-VWS domain and clicks the Save button, the balance type will be associated with the domain type.

Adding balance type mapping

Follow these steps to add a new balance type mapping.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On the Balance Type Mapping tab, click New.

    Result: You see the New Balance Type Mapping Configuration screen.

  3. Configure this record by entering data in the fields on this screen.

    For more information about these fields, see Balance type mapping fields.

  4. Click Save.

Related topic

Balance Type Mapping

Editing balance type mapping

Follow these steps to edit an existing balance type mapping.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to edit from the table on the Balance Type Mapping tab.

  3. Click Edit.

    Result: You see the Edit Balance Type Mapping Configuration screen.

  4. Edit the fields to reflect the required changes.

    For more information about this screen, see Balance type mapping fields.

  5. Click Save.

Related topic

Balance Type Mapping

Deleting balance type mapping

Follow these steps to delete an existing balance type mapping.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to delete from the table on the Balance Type Mapping tab.

  3. Click Delete.

    Result: The Delete Confirmation displays.

  4. Click OK.

Related topic

Balance Type Mapping

Security

The Security tab allows you to configure the security for vouchers.

About Voucher Security

Authentication rules are used to ensure voucher security. Authentication rules must be created before they can be used for voucher batches.

For more information about vouchers, see Voucher Manager User's Guide.

The CB-10 voucher security features enable you to define authentication rules for CB-10 HRN SHA256, CB-10 HRN SHA512 and CB-10 HRN AES256 encryptions. Specify the encryption method when creating voucher batches and redeeming vouchers.

Ensure the following are installed and activated on your system to be visible on your screens:

  • CB-10 voucher security features

  • CB10 HRN SHA256 authentication module

  • CB10 HRN SHA512 authentication module

  • CB10 HRN AES256 authentication module

Note: CB-10 voucher security will only be available to you if you have an appropriate license. For more information about activation, see CCS Installation and Removal Guide.

Security fields

This table describes the function of each field.

Note: The S, R1, R2, and R3 fields apply to CB10 HRN and SDK-developed PAMs only and will only be visible in the screens if the CB-10 Voucher Security features have been activated. For more information about how these fields are related to each other, and how they are used in CB-10 authentication rules, see CB-10 field relationship diagram.

Field Description
Name Name for the authentication rule. Maximum length 50 characters.
PAM

Pluggable Authentication Module name.

This field is populated by the system with the PAMs which have been enabled on this platform.

Note:

  • To review the licenses which have been activated on your platform, see CCS Installation and Removal Guide.

  • The full list of PAMs is a combination of a fixed list of product-provided PAMs plus any SDK-developed PAMs that have been installed.

Number Length

Voucher number length. This field is non-editable and is calculated for a PAM of CB10 HRN SHA256 or CB10 HRN SHA512 as the sum of S+R1+R2+R3.

PIN Length Voucher PIN length (digits). This field is available only for existing vouchers and is non-editable.
Salt

This field applies to DES rule definition only. This field is available only for existing vouchers and is non-editable.

S Length of the serial number (the number must be between 0 and 20).
R1 Length of the first redundancy layer (must be between 0 and 20). A higher number provides a greater level of security.
R2 Length of the second redundancy layer (must be between 0 and 20). A higher number provides a greater level of security.
R3 Length of the third redundancy layer (must be set to 0, 1 or 2). A higher number provides a greater level of security.

Authentication rules

Authentication rules are used by the voucher batch creation and voucher redemption processes. The authentication rule associated with a voucher batch determines which encryption algorithm to use when generating the voucher numbers in the batch. Following encryption algorithms are supported:

  • CB10 HRN SHA256

  • CB10 HRN SHA512

  • CB10 HRN AES256

Note: You cannot edit or delete an authentication rule that is used to create a voucher batch. Voucher batches created in previous versions of the product can continue to use the old rules they were created with. Old authentication rules are not available for new voucher batches.

CB-10 HRN Creation

The CB10 HRN creation provided by the CB10 HRN authentication module generates voucher numbers using the:

  • CB-10 HRN private keys (K1, K2 and K3) for the service provider

  • S, R1, R2 and R3 security parameters defined for the authentication rule

The CB-10 HRN creation algorithm does not support voucher PINs and therefore the PIN length is always set to 0.

A unique set of CB-10 HRN private keys (K1, K2 and K3) is required for each service provider. These keys are generated in one of the following ways:

  • Generated automatically when a new service provider is created

  • Generated or regenerated for service providers who existed before the CB-10 HRN authentication was activated using the Generate button for one of the CB10 HRN SHA or AES PAM modules

Note: If a voucher batch is already created for a service provider using the CB-10 creation algorithm then you cannot:

  • Regenerate the K1, K2, and K3 private keys for the selected service provider

  • Edit the associated authentication rule

CB-10 HRN SHA Hashing

CB-10 HRN private keys are created when:

  • a new service provider is created

  • a Generate button is clicked for a CB10 or SDK PAM Authentication module and the service provider does not have any CB-10 vouchers created yet

Clicking a Generate button also generates hash/encryption keys for the specific PAM Authentication module that are used for hashing/encrypting the CB10 or SDK-created HRN. Generate buttons are disabled if the service provider already has a voucher batch created using the specific PAM Authentication module.

For example, after a voucher batch is created for a service provider using an authentication rule specifying a PAM of CB10 HRN SHA256, you cannot change or update the hash key for CB10 HRN SHA256.

PAMs that use SHA hashing can specify the number of hash iterations to apply, the default is 1 iteration.

Decryption to retrieve the HRN is not supported for SHA-based PAMs as the SHA operation is not reversible.

CB-10 HRN AES Encryption

Similar to CB-10 HRN SHA hashing, AES encryption keys are created when the Generate button for the CB10 HRN AES256 PAM or a SDK-developed PAM using AES Encryption is clicked.

Once a service provider has a voucher batch created with Authentication Rules using the PAM, the Generate button for the PAM is no longer enabled.

PAMs that use AES encryption do not use iterations and in this case the Iterations field for the Authentication Rule is set to 1.

Because AES-256 is a symmetric encryption algorithm, its encrypted value can be decrypted. If the capability of decrypting voucher private secrets is required those vouchers must be created using an Authentication rule that specifies either a PAM of CB10 HRN AES256 or an SDK-developed PAM that supports decryption.

Generating CB-10 HRN keys and SHA/AES hash/encryption keys

Follow these steps to generate or regenerate CB-10 HRNGEN private keys, SHA hash keys and AES keys for a service provider.

  1. Select the customer from the Service Provider drop down box.

  2. On the Security tab, click Generate for one of the following:

    • CB10 HRN SHA256 Key Generation

    • CB10 HRN SHA512 Key Generation

    • CB10 HRN AES256 Key Generation

    • SDK Display Name Key Generation

  3. Note:Display Name is the chosen name for a PAM plugin developed with the SDK. The buttons are visible on the tab if the CB-10 Voucher Security features are activated. Generate buttons are disabled if a voucher is already created for the service provider using the associated voucher authentication PAM module.

    Result: You see the appropriate Key Generation completed message box appear.

  4. Click OK.

Rule priority

When redeeming vouchers the different encryption algorithms are matched against the voucher HRN (hidden resource number) based on the length of the HRN. If the length of the HRN cannot be uniquely matched to an encryption algorithm, then an attempted match is made against each authentication rule in turn. The priority given to each authentication rule is determined by the order in which they appear in the table in the tab.

Changing rule priority

Follow these steps to change the order of priority for an authentication rule.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the table on the Voucher Security tab, select the authentication rule to move.

  3. Click:

    • Up - to move the rule up one row and raise its priority

    • Down - to move the rule down one row and lower its priority

  4. Click Save.

Adding an authentication rule

Follow these steps to add a new authentication rule.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. On the Security tab, select the Voucher Security tab, then click New.

    Result: You see the New Authentication Rule screen.

  3. Configure this record by entering data in the fields on this screen.

    For more information about the fields on this screen, see Security fields.

    Notes:

    • To use the selected PAM, you must first complete key generation. See Generating CB-10 HRN keys and SHA/AES hash/encryption keys.

    • Different fields will be enabled depending on which authentication module you select and in the case of an SDK-developed authentication module how that module has been configured.

  4. Click Save.

Related topic

About Voucher Security

Editing an authentication rule

Follow these steps to edit an authentication rule.

Note: You will not be able to edit a rule for which there is an associated voucher batch.

  1. Select the Service Provider from the drop down box.

  2. Select the rule to edit from the table on the Voucher Security tab.

  3. Click Edit.

    Result: You see the Edit Authentication Rule screen.

  4. Edit the fields to reflect the changes you need to make.

    For more information about the fields on this screen, see Security fields.

    Note: Different fields will be enabled depending on which authentication module you select.

  5. Click Save.

Related topic

About Voucher Security

Deleting an authentication rule

Follow these steps to delete an existing authentication rule.

Note: You will not be able to delete a rule for which there is an associated voucher batch.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. In the table on the Voucher Security tab, select the authentication rule to delete.

  3. Click Delete.

    Result: You see the Delete Confirmation prompt.

  4. Click OK.

Related topic

About Voucher Security

Channel

The Channel tab allows you to configure the promotion channels for the Balance Recharge event in Promotion Manager.

Channel fields

This table describes the function of each field.

Field Description
Channel

The name of the promotional channel.

The following global channels are preconfigured upon installation:

  • ATM

  • Any

  • MPOS

  • Other

  • Voucher

Description A description of the channel
Global If selected, the channel is global, rather than specific to the selected service provider.

Adding a Channel

Follow these steps to add a new channel.

  1. Select the Service Provider from the drop down box.

  2. On the Channel tab, click New.

    Result: You see the New Channel screen.

  3. Configure this record by entering data in the fields on this screen.

    For more information about the fields on this screen, see Channel fields.

  4. Click Save.

Related topic

Channel

Editing a Channel

Follow these steps to edit an existing channel.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to edit from the table on the Channel tab.

  3. Click Edit.

    Result: You see the Edit Channel screen.

  4. Edit the fields to reflect the changes you need to make.

    For more information about the fields on this screen, see Channel fields.

  5. Click Save.

Related topic

Channel

Deleting a Channel

Follow these steps to delete an existing channel.

  1. Select the service provider from the Service Provider list in the Service Management screen.

  2. Select the record to delete from the table on the Channel tab.

  3. Click Delete.

    Result: The Delete Confirmation displays.

  4. Click OK.

    Results: The record is deleted from the database.

Related topic

Channel

Named Event

The Named Event tab allows you to set up and maintain activities, other than calls, that may incur a charge. The values you specify here are the base values for the events, and may be overridden by values specified in a Named Event Catalogue.

The event may be sending a short text message, a product type swap, a credit transfer, or a connection to recharge facilities. The named events can be changed by the Named Event feature node for that event in the control plan.

Event subscription

A named event catalogue event subscription is a named event that allows a subscriber to ‘subscribe’ to an unlimited use of a particular service without being charged during the subscribed period.

As such it will be possible to define a subscribable named event that is charged on first use and sets up a subscription to allow future uses in the subscription period to be charge free.

When this named event is used, an automatic subscription to the service is created which will then follow a normal life cycle.

If the subscription is already active, the user will not pay for the named event until the subscription expires.

Note: Event Subscription is not available if the UBE domain does not have ‘Charging Management’ configured or when there is no UBE domain configured.

Balance type cacades

Events can be configured to be billed across multiple balance types in a pro-rata fashion.

Example: If the Cash cost for an event is $10 and the Time cost is 120 seconds, and you only have a cash balance of $5, then the event would use your remaining $5, and then 60 seconds to pay for the rest of the event.

Named Event table

This table describes the content of each table column on the Named Event tab.

Field Description
Named Event The name of the named event.
Change User Name of the user who created or modified the event.
Change Date Date of creation or modification of event.

Adding named event set

Follow these steps to add a new named event set.

  1. On the Named Event tab, click New Set.

    Result: The New Named Event Set screen appears.

  2. In the Name field, type the name of the new named event.

  3. Click Save.

Related topic

Named Event

Editing named event sets

Follow these steps to edit an existing named event set.

  1. On the Named Event tab, select the named event to edit from the Event Set drop down box.

  2. Click Edit Set.

  3. Modify the Name as required.

  4. Click Save.

Related topic

Named Event

Deleting named event sets

Follow these steps to delete an existing named event set.

  1. On the Named Event tab, select the named event set to delete from the Event Set drop down box.

  2. Click Delete Set.

    Result: You see the Delete Confirmation prompt.

  3. Click OK to delete the record from the database.

    Result: The record is deleted and you see the Named Events prompt.

  4. Click OK.

Related topic

Named Event

Adding named events

Follow these steps to add a new named event to a named event set.

  1. On the Named Event tab, select the required Event Set from the drop down box.

  2. Click New.

  3. Configure this record by entering data in the fields on this screen.

  4. Click Save.

Related topic

Named Event

Editing named events

Follow these steps to edit an individual named event in a selected named event set.

  1. On the Named Event tab, select the Event Set from the drop down box.

  2. In the table on the tab, select the record to edit.

  3. Click Edit.

  4. Edit the details as required.

  5. Click Save.

Related topic

Named Event

Deleting named events

Follow these steps to delete an existing named event.

Note: When you delete a named event, the named event is automatically removed from any named event catalogues to which it has been allocated.

  1. On the Named Event tab, select the Event Set from the drop down box.

  2. Select the record to delete.

  3. Click Delete.

    Result: You see the Delete Confirmation prompt.

  4. Click OK to delete the record from the database.

    Result: You see record deleted confirmation message.

  5. Click OK.

Related topic

Named Event