1 Subscriber Management

This chapter explains how to specify subscriber details for service providers.

This chapter contains the following topics.

Subscriber Management Module

Credit Cards

Subscriber Batch

Customer

Closed User Groups

Friends and Family Black List

Friends and Destination Black List

Friends and Destination Prefix Map

Profile Group Fields

UBE Account Balancing

Subscriber Management Module

The Subscriber Management screen lets you configure the subscribers to CCS customers. It contains these tabs:

Note: The Subscriber and Product Type tabs are documented in separate chapters.

Accessing the Subscriber Management screen

Follow these steps to open the Subscriber Management screen.

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

    Note: The services which are available under the Services menu depend on the components which have been installed, and the permissions of the user. The services displayed in this screen shot may not match the services you have available on your system.

  2. Select Prepaid Charging > Subscriber Management.

    Result: You see the Subscriber Management screen.

Credit Cards

The Credit Cards tab enables credit card data to be managed securely. You can perform the following tasks from the Credit Cards tab:

You can also manage a subscriber's credit cards from the Add Subscriber or Edit Subscriber screens. See Subscriber Management - Subscribers for details.

Note: To use the legacy credit card options, the sms.jnlp file must include the application property LegacyCC=True. See SMS Technical Guide for more information.

Topics:

About Auditing Credit Card Changes

Searching for credit cards

Adding credit cards

New Credit Card fields

Editing credit cards

Edit Credit Card fields

Registering subscribers to credit cards

Deleting credit cards

About Auditing Credit Card Changes

The EDR auditing feature keeps track of changes to subscribers credit cards. When EDR auditing is enabled, a user who is updating a subscriber's credit card details is forced to enter a reason for the change in a special Change Reason dialog box; for example, when:

  • Adding a new credit card

  • Editing or deleting an existing credit card

  • Registering or deregistering a credit card

  • Freezing a credit card

The reason for the change, and the user who made the change are reported in the Change Reason, and Operator Name fields in the BE EDR. You can view this information by displaying the BE EDR in the EDR Viewer.

Credit card auditing is enabled by the EDR auditing global configuration option. For more information, see the discussion on EDR auditing in Global Configuration.

Searching for credit cards

Follow these steps to search for existing credit cards.

  1. On the Credit Cards tab, select the credit card masking rule from the Masking rule list. For more information about masking rules, see About Credit Card Security.

  2. Specify the search criteria by entering search values in one or more of the following search fields:

    • Display Number – To search on the credit card display number

    • Calling card ID – To search for credit cards already registered to the subscriber with the specified subscriber ID

    • Tokenised number – To search on a tokenized credit card number

  3. Select the credit card states to search for. The Active and Frozen states are selected by default.

  4. Click Search.

The table displays the first 100 records that match the search criteria. If the credit cards you want are not displayed and the search returns more than 100 records, enter a longer search strings in the search fields, and click Search again.

Adding credit cards

Follow these steps to add a credit card record on the Credit Card tab.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. Click New on the Credit Card tab.

    The New Credit Card screen displays.

  3. Fill in the credit card details. For more information, see New Credit Card fields.

  4. (Optional) Register a subscriber to the credit card. See Registering subscribers to credit cards for details.

    Registered new cards can be in a frozen or an active state. Unregistered new cards must be set to the frozen state.

  5. Click Save.

  6. If EDR auditing is enabled, then the Change Reason dialog displays. Enter the reason for the change in the Change Reason field, and click OK. The reason can be up to 200 characters long.

  7. Click OK.

    You are returned to the Credit Cards tab. To see the card just added, select the relevant search criteria and click Search.

Related topic

Credit Cards

New Credit Card fields

This table describes the function of each field on the New Credit Card screen.

Field Description
Subscriber ID

Displays the ID of the subscriber. If you create a credit card through:

  • A subscriber screen, this field is set automatically and cannot be changed. For more information, see Adding Subscribers, Editing Subscribers, and Deleting subscribers.

  • The Credit Card tab, this field is blank. You can register this credit card to a subscriber immediately by clicking Subscriber, or you can register the credit card at a later date. Once registered, the ID of the selected subscriber displays in this field. For more information, see Registering subscribers to credit cards.

Full Credit Card Number

The full credit card number, with no spaces between the digits.

Note: This field is available only on the New Credit Card screen. All other credit card screens contain the display name and the tokenized number.

Masking Rule The rule used to mask the credit card number. For more information about masking rules, see About Credit Card Security.
Expiry Date The credit card's expiry date. Select the month and year from the month and year lists.
Name on Card (Optional) The name of the account holder as it is written on the credit card.
CVC The three or four digit credit verification code (CVC) that is printed on the credit card. The CVC provides the credit card owner with additional security when making purchases.
Frozen

When selected, the credit card is in a frozen state. When not selected, the state is active.

Registered new cards can be frozen or active. Unregistered new cards can only be frozen.

Note: This field is visible only when you open the New Credit Card screen from the Edit Subscriber, Credit Cards option.

Warning Displays a warning message at the bottom of the screen if the checksum failed.

Related topic

Credit Cards

Editing credit cards

Follow these steps to edit a credit card record.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. Click the Credit Card tab, and select the credit card to edit from the table on the tab. For information about searching for credit cards, see Searching for credit cards.

  3. Click Edit.

    The Edit Credit Card screen displays and shows a list of all the registration records for the credit card. For information about the displayed fields, see Edit Credit Card fields.

  4. (Optional) Change the following details as required:

    • Expiry date details

    • Name on card

    • CVC number

    • Freeze or make active the credit card state

  5. (Optional) To register a subscriber to the credit card, click Register. See Registering subscribers to credit cards.

  6. (Optional) To deregister a subscriber from the credit card:

    1. Select the subscriber from the table and click Deregister.

    2. Click Deregister to confirm.

    Note: You cannot deregister the primary subscriber.

  7. (Optional) To freeze a subscriber's primary wallet:

    1. Select the subscriber and click Freeze Wallet.

    2. Click Freeze.

    3. If EDR auditing is enabled, then the Change Reason dialog displays. Enter the reason for the change in the Change Reason field, and click OK.

  8. If the Registration State is Pending, and you want to confirm the subscriber's registration to the credit card, click Confirm.

  9. If there is more than one subscriber registered to a frozen credit card, register the primary subscriber by selecting the required subscriber, and then clicking Primary.

  10. Click Save.

  11. If EDR auditing is enabled, then the Change Reason dialog displays. Enter the reason for the change in the Change Reason field, and click OK. The reason can be up to 200 characters long.

  12. Click OK.

Related topic

Credit Cards

Edit Credit Card fields

This table describes the function of each field on the Edit Credit Card screen.

Field Description
Display Number The credit card number (prefix + padding + suffix), as specified by the associated masking rule. For more information about masking rules, see About Credit Card Security.
Tokenised Number The tokenized credit card number.
Expiry Date The credit card's expiry date. Select the month and year from the month and year lists.
Name on Card (Optional) The name of the account holder as written on the credit card.
CVC The three or four digit credit verification code (CVC) that is printed on the back of the credit card. The CVC provides the credit card owner with additional security when making purchases.
Frozen

When selected the credit card is in a frozen state. When not selected the state is active.

You can unfreeze a credit card only if it is registered.

Registered Subscribers

This table displays the:

  • Subscriber ID

  • Registration state – The registration state (Primary, Secondary, Pending, or New) of the registered subscriber

  • Primary wallet state – The registered subscriber's primary wallet state

Registering subscribers to credit cards

Follow these steps to register a subscriber to a credit card from the New Credit Card screen or the Edit Credit Card screen.

  1. Do one of the following:

    • From the New Credit Card screen, click Subscriber.

    • From the Edit Credit Card screen, click Register.

    The Register Subscriber to Credit Card screen appears.

  2. Enter one or more initial digits of the subscriber number in the Subscriber ID field.

  3. Select:

    • Exact Match to search for the matching subscriber.

    • Prefix Match to search for all subscribers with IDs that match the entered prefix.

  4. Click Search.

    The search returns a maximum of 100 records.

  5. From the search results table, select the subscriber you want to register to the credit card and click Register.

  6. If EDR auditing is enabled, the Change Reason dialog displays. In the Change Reason field, enter the reason for the change and click OK.

    The reason can be up to 200 characters long.

Related topic

Credit Cards

Deleting credit cards

Follow these steps to delete credit card records.

  1. Search for the credit card to delete. See Searching for credit cards.

  2. Select the credit card to delete, and then click Delete.

  3. If EDR auditing is enabled, the Change Reason dialog displays. Enter the reason for the change in the Change Reason field, and click OK. The reason can be up to 200 characters long.

  4. Click Delete.

    The credit card is removed from the results list.

    Note: A credit card is removed from the database only if it is in the primary state. When you delete a frozen credit card, it is moved to a deleted state, but it is not removed from the database.

Related topic

Credit Cards

Subscriber Batch

The Subscriber Batch tab lets you view, add, modify and delete batches of subscribers.

Tip: It is also possible to work with subscribers using the ccsAccount command line tool. For more information about this tool, see CCS Technical Guide.

Topics:

Finding subscriber batches

Adding subscriber batches

Subscriber Batch Fields

Editing subscriber batches

Deleting account batches

Finding subscriber batches

To find specific subscriber batches in the Subscriber Batch tab:

  1. Enter the first few characters of the subscriber ID and select a batch state.

  2. Click Search.

    Result: The table displays the first 100 records which match the search criteria. Results include creation date. If the subscriber batch you want is not displayed and more than 100 records were returned, enter a longer search string and click Search again.

Adding subscriber batches

Follow these steps to add a new subscriber batch.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Subscriber Batch tab in the Subscriber Management screen, click New.

    Result: You see the New Subscriber Batch screen.

  3. Fill in the fields, as described in New subscriber batch fields.

    Once you have filled in all the fields, the Save button becomes active.

  4. Click Save.

    Result: If successful, you see a message confirming the subscriber batch has been created.

  5. Click OK.

Related topic

Subscriber Batch

Subscriber Batch Fields

This table describes the function of each field.

Field Description
Batch Size The number of subscribers in the batch.
Subscriber List Filename

Name of the file containing the list of subscribers to use when creating the batch.

Each line of the file can include either one subscriber or a range of them. Comments are ignored.

Example: Subscriber List file content.

# this is a comment

482345932

482464935-482464945

Result Filename The name of the file to create for the batch.
Charging Domain

List of domains on which wallets for this subscriber batch can be stored.

This drop down list is populated by the domains configured on the Domain tab on the Service Management screen.

Tracking Domain

List of available domains for fraud tracking and promotional balance types.

This drop down list is populated by the domains configured on the Domain tab on the Service Management screen.

Note: The tracking domain must be a VWS domain and will be available if the charging domain is not a VWS domain.

Product Type

List of available product types.

This drop down list is populated by the product types configured on the Product Type tab on the Subscriber Management screen.

Wallet Currency

The currency the wallet created with these subscribers should use.

This drop down list is populated by the currencies configured on the Currency tab on the Service Management screen.

Maximum Concurrent Accesses Sets the default total number of accesses that can be supported against the subscriber at any one time.
Use Subscriber ID When selected, the card number range fields are grayed out and the subscriber ID is used to provide the card number.
Allocate in Range The starting and ending points for the card number range.
Encryption File

The context string to be used for encryption.

This can have different values, depending on your setup.

Acceptable values for the supported DES encryption method include a PIN length that should be a number between 4 and 20.

Add PINS to accounts

When selected, the card number has an associated PIN generated from the selected Encryption Method and PIN Length fields.

When not selected there is no PIN associated with the card number.

Encryption Method

The pluggable authentication module which will be used for generation of encrypted of PINs for this batch.

The module is used to generate random PINs of the length specified (PIN Length), and then encrypt them for storing in the database.

Creation Date Indicates the creation date of the batch.
PIN Length The length of the PIN that will be generated for accounts in this batch. This is the actual length of the non encrypted PIN and must be a minimum of 4 digits to a maximum of 20 digits.
Subscriber ID to Wallet Reference

Subscriber ID and related wallet reference.

Example: 123456 ref1334

Editing subscriber batches

Follow these steps to edit an existing subscriber account batch.

Tip: By editing a subscriber batch, you will change the batch state. Changing the batch state enables you to activate subscriber batches.

Note: The Subscriber Batch tab and Edit Subscriber Batch tab have a creation date read-only value which preserves the creation date when a batch is edited.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

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

  3. Click Edit.

    Result: You see the Edit Subscriber Batch screen.

  4. You can only change the Batch State field. Changing the batch state to active activates the subscriber batch.

  5. Click Save.

Related topic

Subscriber Batch

Deleting account batches

Follow these steps to delete an existing subscriber batch.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. In the table on the Select Batch tab, 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.

Related topic

Subscriber Batch

Customer

This screen enables you to add, modify or delete customers.

The Customer screen displays the customers that have been set up for the service provider.

Once you have set up customers, you can assign subscriber accounts to a specific customer.

Topics:

Finding customers

Adding customers

Editing customers

Deleting customers

Finding customers

To find a specific customer in the Customer tab, enter the first few characters of the customer's name, and click Search.

Result: The grid will display the first 100 records which begin with the characters searched for. If the required customer is not displayed and more than 100 records were returned, enter a longer search string and click Search again.

Adding customers

Follow these steps to add a new customer for a service provider.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Customer tab, click New.

    Result: You see the New Customer screen.

  3. In the Name field, enter the name of the new customer.

  4. The name must be completed. Customer names must be unique for the service provider. Special characters and case do not make a distinction between names. For example, Super Savers is the same as Super saver's.

  5. In the Description field, enter the description of the new customer.

  6. In the Reference field, enter a reference for the new customer.

  7. Click Save.

Related topic

Customer

Editing customers

Follow these steps to edit an existing customer.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Customer tab, select the customer record to edit.

    Tip: If the required customer is not displayed, you can try searching for them as described in Finding customers.

  3. Click Edit.

    Result: You see the Edit Customer screen.

  4. Edit the details as described in Adding customers.

  5. Click Save.

Related topic

Customer

Deleting customers

Follow these steps to delete an existing customer.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Customer tab, select the customer to delete.

    Tip: If the required customer is not displayed, you can try searching for them as described in Finding customers.

  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 you see the Customer prompt.

  5. Click OK.

Related topic

Customer

Closed User Groups

The Closed User Groups tab lets you define groups of users (Closed User Groups), that use an alternative tariff plan when both the calling and the called numbers are part of the same group. The alternative tariff plan normally reduces the rate of calls or provides free calls.

A CUG has the following membership rules:

  • A CUG is defined for a specific service provider, therefore only the subscribers of that service provider may belong to that CUG.

  • Subscribers may be members of more than one CUG.

A CUG Feature node must be included in the control plan to determine whether the calling and the called numbers are in the same CUG.

Closed user groups may also contain Virtual Members. Virtual members are defined as single numbers or number ranges. An MSISDN calling a number that resides in any virtual member range in any CUG in which that MSISDN is also a member is deemed to be making a closed user group call, and can be billed accordingly.

Tip: You can also define CUG membership through the Subscriber screens.

Topics:

Adding closed user groups

Closed User Group fields

Editing closed user groups

Deleting closed user groups

Adding closed user groups

Follow these steps to add a Closed User Group (CUG) and its members.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Closed User Groups tab, click New.

    The New Closed User Group dialog displays. For information about the fields on this screen, see Closed User Group fields.

  3. For each member that you want to add, enter the subscriber MSISDN in the MSISDN field, and click Add.

  4. For each virtual CUG member that you want to add, perform the following steps:

    1. Select either Single number, Range, or Pattern.

    2. Depending on your previous selection, specify the virtual member number, number range, or prefix and length.

    3. Click Add.

  5. When you have completed adding members to the CUG, click Save.

Related topic

Closed User Groups

Closed User Group fields

This table describes the function of each field in the New and Edit Closed User Group dialogs.

Field Description
Name Unique name for this closed user group. After saving a new closed user group you can view, but not edit the closed user group name.
Tariff Plan The tariff plan to apply to phone calls between members of this closed user group.
Members

Lists the subscriber accounts who are part of this closed user group. You create a member by adding the subscriber's MSISDN to the list of members.

Tip: Subscribers can be members of more than one CUG.

Virtual Members Lists the virtual members of the CUG. You create virtual members by providing a single number, a start and end number, or a prefix and a number length.

Editing closed user groups

Follow these steps to edit an existing closed user group (CUG).

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Closed User Groups tab, select the CUG to edit.

    Tip: You can search for a specific CUG or MSISDN by entering the details in the Name and MSISDN fields on the tab, and clicking Search.

  3. Click Edit. The Edit Closed User Group dialog opens.

    For more information about the closed user group fields, see Closed User Group fields.

  4. Edit the list of members as required. To:

    • Add a new member, enter the MSISDN in the MSISDN field, and click Add.

    • Delete an existing member, select the member's MSISDN in the Members list and click Delete.

  5. Edit the list of virtual members as required. To:

    • Add a new entry, enter either the number, number range, or prefix and length for the virtual member entry, and then click Add.

    • Delete an entry from the Virtual Members list, select the entry in the list and click Delete.

  6. Click Save.

Related topic

Closed User Groups

Deleting closed user groups

Follow these steps to delete an existing closed user group (CUG).

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Closed User Groups tab, select the CUG to delete.

    Tip: You can search for a specific CUG or MSISDN by entering the details in the Name and MSISDN fields on the tab, and clicking Search.

  3. Click Delete.

    The Delete Confirmation prompt displays.

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

    The record is deleted and the Closed User Groups prompt displays.

  5. Click OK.

Related topic

Closed User Groups

Friends and Family Black List

Friends and Family Black List numbers are numbers that may not be added to a subscriber’s friends and family list (using the Friends and Family IVR configuration service).

The Friends and Family (F&F) Black List tab displays all F&F black list entries. Up to 100 numbers may be added, each up to 32 digits long.

Note: Friends and Family discounts are also configured in a subscriber's product type. For details, see FF White List.

Topics:

Editing the F&F Black List

Editing the F&F Black List

Follow these steps to edit the numbers in the friends and family black list.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Friends and Family Black List tab, click Edit.

    Result: You see the Edit F&F Black List Numbers screen.

  3. To add a black listed number, enter the number in the New Number field and click Add.

    Result: The number is added to the friends and family black list for this service provider.

  4. To delete a number, select the number to remove from the list and click Delete.

    Result: The number is removed from the list.

  5. Click Save.

Related topic

Friends and Family Black List

Friends and Destination Black List

Subscribers may not use prefixes contained in the friends and destination black list when setting their Friends and Destination prefix using the Friends and Destination IVR configuration service.

The Friends and Destination (F&D) Black List tab displays all F&D black list entries. Up to 100 prefixes may be added, each up to 32 digits long.

Topics:

Adding numbers to the Black List

Adding numbers to the Black List

Follow these steps to edit the numbers in the Friends and Destination Black List.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Friends and Destination Black List tab, click Edit.

    Result: You see the Edit F&D Black List Numbers screen.

  3. To add a black listed number, enter the number in the New Number field and click Add.

    Result: The number is added to the friends and destination black list for this service provider.

  4. To delete a number, select the number to remove from the list and click Delete.

    Result: The number is removed from the list.

  5. Click Save.

Related topic

Friends and Destination Black List

Friends and Destination Prefix Map

The friends and destination prefix map entries are used to configure the announcements corresponding to a particular friends and destination prefix. These announcements are played to the caller when using the friends and destination IVR configuration service.

You can create groups of prefixes (for example, by region) by mapping all the prefixes in the group to the same announcement. These prefix groups can then be used to apply a discount to multiple destinations instead of to a single number prefix.

Tip: You can order prefixes by prefix or by mapped announcement by clicking on the column title on the Friends and Destination Prefix Map tab.

Note: Up to 100 prefix maps can be added.

Topics:

Friends and Destination Prefix Map fields

Adding Friends and Destination Prefix Mappings

Editing Friends and Destination Prefix Mappings

Deleting Friends and Destination Prefix Mappings

Friends and Destination Prefix Map fields

This table describes the function of each field.

Field Description
Prefix The prefix for the friends and destination destination number.
Announcement Set The ACS announcement set which contains the announcement which should be played for this prefix.
Announcement Entry

The announcement which should be played for this prefix.

Note: Prefixes which use the same announcement entry will be grouped together.

For more information about ACS announcements, see ACS User's Guide.

Adding Friends and Destination Prefix Mappings

Follow these steps to add a new Friends and Destination Prefix Announcement Mapping.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Friends and Destination Prefix Map tab, click New.

    Result: You see the New Prefix Announcement Mapping screen.

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

    For more information about the fields on this screen, see Friends and Destination Prefix Map fields.

  4. Click Save.

Related topic

Friends and Destination Prefix Map

Editing Friends and Destination Prefix Mappings

Follow these steps to edit an existing Friends and Destination Prefix Announcement Mapping.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. In the grid on the Friends and Destination Prefix Map tab, select the record you want to edit.

  3. Click Edit.

    Result: You see the Edit Prefix Announcement Mapping screen.

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

    For more information about the fields in this screen, see Friends and Destination Prefix Map fields.

  5. Click Save.

Related topic

Friends and Destination Prefix Map

Deleting Friends and Destination Prefix Mappings

Follow these steps to delete an existing Friends and Destination Prefix Announcement Mapping.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. In the table on the Friends and Destination Prefix Map tab, select the record to delete.

  3. Click Delete.

  4. Result: You see the Delete Confirmation prompt.

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

  6. Result: The record is deleted and you see the F&D Prefix Map prompt.

  7. Click OK.

Related topic

Friends and Destination Prefix Map

Profile Group Fields

The Profile Group Fields tab lets you define and manage subscriber profile groups and fields dynamically. You can:

  • Specify a set of Profile Groups

  • Specify the fields to include in each group

Two types of profile group fields may be specified:

  • BPL tasks (defined on the Task Management screen)

  • Profile Fields (defined on the Profile Details tab in the ACS Configuration screen)

You can view and edit the Profile Group field values, and execute the BPL tasks on the Edit Subscriber screen.

Note: Some other applications, for example Messaging Manager, will configure profile group fields on installation. Refer to the appropriate guide for information about specific profile group fields.

For more information about setting up BPL tasks, see Task Management.

Profile tags

The tag names for profile fields are defined on the Profile Tag Details tab in the ACS Configuration screen.

This table describes the supported data types for profile tags.

Profile Field Tag Type Description
BOOLEAN

A single value:

  • True

  • False

BYTE A single digit integer (signed).
DATE A date.
INTEGER An integer value (signed).
LNSTRING

A limited numeric string. Valid characters are 0-9.

Note: The limits for LNSTRING field values may be set for the Product Type (in the Product Type screen) and/or Service Provider (in Service Management, Resource Limits screen).

LOPREFIX

A limited ordered prefix tree. This is made up of a limited list of numbers.

Note: The limits for LOPREFIX field values may be set for the Product Type (in the Product Type screen) and/or Service Provider (in Service Management, Resource Limits screen).

NSTRING Numeric string. Valid characters are 0-9.
OPREFIX An ordered prefix tree comprising an ordered list of numbers.
PREFIX A prefix tree comprising a list of numbers.
STRING A non limited ASCII string.
ZONE

A set of shape definitions for the area covered by the zone. Shapes may be circular or rectangular and are defined by their coordinates.

Note: You can set up and populate zone tags but they may only be used if the Location Capabilities Pack (LCP) is installed.

Configuring Zone Profile Tags

You can define a set of zones that can be used to determine the location of a subscriber.

To define a zone, you must first define the zone profile group field using a ZONE profile tag.

ZONE profile tags are configured in ACS. The LCP ZONE profile tags, Home and Work, are all configured at installation. All other zone profile tags are user defined and must conform to the configuration shown in this table.

Profile Tag Name Profile Tag Type Profile Tag Parent Profile Tag Comment
LCP ZONES Profile Block 4128769 NA Configured during installation.
Home ZONE 4128770 4128769 Configured during installation.
Work ZONE 4128771 4128769 Configured during installation.
ZoneName ZONE

An integer value in the range:

4128772 to 4194305

4128769

User defined.

Warning: The parent profile tag must be set to 4128769 (the profile tag value for LCP ZONES).

For more information about profile tags, see ACS User's Guide.

User access

Users can access profile group fields and profile group BPLs from the Profile Groups option in the Edit Subscriber screen, provided the users have sufficient privileges.

You manage user access to profile groups, profile fields, and BPLs through the User Templates defined in the SMS User Management screen. It can be set for all fields and BPLs in the profile group, or for selected fields and BPLs. The required level of access privilege for each individual field or BPL must be added manually to the template.

This table describes the privileges that may be assigned to each profile field and BPL.

Privilege Description
Read/Only The field's value (if present) will be visible to the user through the screens, but they will not be able to edit, create, or delete it.
Read/Modify The field's value (if present) will be visible to the user through the screens, and they will be able to edit it, but they will not be able to create or delete it.
Create/Delete The field's value (if present) will be visible to the user through the screens, and they will be able to edit, create and delete it.
Execute This BPL will be visible to the user through the screens, and they will be able to execute it.

Note: For information about creating and maintaining user Templates, see SMS User's Guide.

Adding profile tag groups

Follow these steps to add a new profile tag group.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Profile Group Fields tab, click New Group.

    Result: You see the New Profile Tag Group screen.

  3. In the Name field, enter the name for this profile tag group.

  4. The Permission Name field displays the permission name for this group. It is used when configuring the user template in ACS.

    To set the permission name to the standard name, ensure the Auto Populate Permission Name check box is selected.

    The standard format is:

    <Service Provider>-<Profile Tag Group Name>

    To set the Permission Name to something other than the standard name:

    • Clear the Auto Populate Permission Name check box

    • In the Permission Name field, enter the name for this profile tag group.

  5. Click Save.

Related topic

Profile Group Fields

Editing profile tag groups

Follow these steps to edit an existing Profile Tag Group.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Profile Group Fields tab, select the Group you want to edit.

  3. Click Edit Group.

    Result: You see the Edit Profile Tag Group screen.

  4. Edit the Name for the profile tag group.

    Note: The Permission Name field is not editable.

  5. Click Save.

Related topic

Profile Group Fields

Adding a new profile group field

Follow these steps to add a profile group field to a profile group.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

    On the Profile Group Fields tab, select the Group you want from the drop down list.

  2. Click New.

    Result: You see the New Profile Group Field screen.

  3. Select Profile Fieldfrom the Field Type drop down list.

    Result: You see the Profile Field options in the New Profile Group Field screen:

  4. In the Group Order field, set the number of the line this field should be displayed in.

    Lower numbers are closer to the top of the screen.

    Tip: The combination of group and sub order determines how profile group fields are displayed on the Edit Subscriber screen.

  5. In the Sub Order field, set the number which defines where this field is displayed relative to other fields in its group.

    Lower numbers are closer to the left.

  6. In the DisplayName field, type the name you want to give to the field.

  7. From the Profile Tag Name drop down list, select the profile tag this field will be in.

    This list is populated from the profile tags defined on the ACS Configuration screen.

  8. The Permission Name field displays the permission name for this field. It is used when configuring the user template in ACS.

    If you want to set the permission name to the standard name, ensure the Auto Populate Permission Name check box is selected.

    The standard format is:

    ServiceProvider-ProfileGroup-DisplayName

    If you want to set the permission name to something other than the standard name:

    • Deselect the Auto Populate Permission Name check box,

    • In the Permission Name field, enter the name for this profile group field.

  9. Click Save.

Related topic

Profile Group Fields

Adding BPL fields

Follow these steps to add a BPL to a profile group.

Note: You will only be able to use this functionality if you have the Task Management license.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

    On the Profile Group Fields tab, select the Group you want from the drop down list.

  2. Click New.

    Result: You see the New Profile Group Field screen.

  3. Select Business Process Logic from the Field Type drop down list.

    Result: You see the Business Process Logic options in the New Profile Group Field screen.

  4. In the Group Order field, set the number of the line this field should be displayed in.

    Lower numbers are closer to the top of the screen.

    Tip: The combination of group and sub order determines how profile group fields are displayed on the Edit Subscriber screen.

  5. In the Sub Order field set the number which defines where this field is displayed relative to other fields in its group.

    Lower numbers are closer to the left.

  6. From the BPL drop down list, select the BPL to include in the profile group.

    This list is populated from the BPL tasks defined in the Task Management screen. For more information about setting up BPL tasks, see Task Management.

    Tip: The Permission Name field is for reference only. It displays the permission name for this BPL which is used when configuring the User Template in ACS.

  7. Click Save.

Editing a profile group field

Follow these steps to edit an existing profile group field or BPL for a profile group.

Note: The Field Type, Profile Tag Name and Permission Name fields are not editable.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Profile Group Fields tab, select the Group you want to edit.

  3. In the table, select the row to edit.

  4. Click Edit Field.

    Result: You see the Edit Profile Group Field screen. The screen fields differ depending on whether you are changing a Business Process Logic or Profile Field:

  5. Edit the Group Order and Sub Order for the profile group field.

    Tip: The combination of group and sub order determines how profile group fields are displayed on the Edit Subscriber screen.

  6. If required, edit the profile group field details.

    • For BPLs, you can select a different BPL from the drop down list.

    • For profile tags, you can enter a new display name.

  7. Click Save.

Deleting profile groups and fields

Follow these steps to delete an existing Profile Group or Profile Field.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the Profile Group Fields tab, select the Group you want from the drop down list.

  3. To delete the group and all its associated fields, click Delete Group.

  4. To delete a specific field from the group, in the table, select the row containing the field to delete and click Delete.

    Result: You see the Delete Confirmation prompt.

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

    Result: The record is deleted. A confirmation prompt is displayed.

  6. Click OK.

UBE Account Balancing

The UBE Account Balancing tab enables you to move wallets from one VWS domain to another. This may be used to:

  • Redistribute wallets and buckets after a hardware upgrade or the addition of more Voucher and Wallet Servers

  • Move wallets and buckets off a VWS that is being decommissioned

For more information about wallets, see Subscriber Accounts and Wallets.

For more information about domains, see Domains.

Topics:

Migration states

UBE Account Balancing buttons

UBE Account Balancing fields

Adding migrations

Editing migrations

Reviewing domain records

Viewing migration details

Saving unmigrated accounts to input file

Example exported report

Deleting subscriber account migrations

Migration states

This table describes the possible states a migration can have.

State Row Color Description
P White Pending
N Light yellow Priority (run Next regardless of insertion order)
H White On Hold (pending but marked to not run yet)
S Light orange Paused (Stopped by the user)
C Orange Canceled
F Red Failure (all or some wallets not moved successfully; they were either not on the source VWS VWS or did not have one of the specified wallet states)
M Blue Migrated
I Yellow Incomplete (Maximum Wallets reached before the end of the batch)
R Green Running

Tip: Highlighted migrations are shown in dark blue. Table text is always black.

UBE Account Balancing buttons

This table describes the function of each field.

Field Description
Refresh button

Refreshes the table with migrations of the states which correspond to the selected check boxes. The states for each check box are:

  • Complete: M, C, I and F

  • Running: R

  • Pending: N, P, H, S, I and F

Priority button

Changes the state of a selected migration to the priority (N) state.

Tip: Disabled if the selected migration has any of these states: N, C, R or M.

Restart button

Changes the state of a selected migration to the pending (P) state.

Tip: Disabled if the selected migration has any of these states: P, C, R or M.

Pause button

Changes the state of a selected migration to the paused (S) state.

Tip: Disabled if the selected migration is not in the Running (R) state.

Notes:

  • After the Pause button is clicked, the system takes up to 5 seconds to react to the change. Any migrations started before the pause is recognized are completed.

  • If the selected migration is in the Paused (P) state, this button turns into the Hold button.

Hold button

Changes the state of a selected migration to the On Hold (H) state.

The Pause button turns into the Hold button if the selected migration is in the Paused (P) state.

Cancel button

Changes the state of a selected migration to the canceled (C) state. A report on which wallets were migrated is compiled and saved.

Tip: Disabled if the selected migration has any of these states C, R, M, F, S or I.

Report button

Opens a Report screen displaying the report. For more information about what you can do with the Report screen, see Saving unmigrated accounts to input file.

Tip: Disabled if there is no report for the selected migration.

UBE Account Balancing fields

This table describes the function of each field in the UBE Account Balancing tab and the New/Edit Migration screen.

Field Description
Source Domain

The name of the VWS domain the wallets are being moved from.

Can only be changed if state is P, N or H.

Target Domain

The name of the VWS domain the wallets are being moved to.

Can only be changed if state is P, N or H.

Batch ID The ID of the subscriber batch the wallets belong to. This field is required for moving subscriber accounts which were generated in a batch.
Start Date

The day the migration started. For second attempts or continuation when in Incomplete (I) state, this is reset to the latest start time.

Shows blank if the migration has not been started.

Ed Date/Progress

If the migration is complete (states M or F), or interrupted (states C, I or S), this field shows the date the migration finished.

If the migration has not started, this field is blank.

If the migration is in progress (state R) this field shows the progress of the migration as a percentage of the wallets which have successfully been migrated.

State The state of the migration. For more information about migration states, see Migration states.
Input File

Input filename. Shows blank if the migration has no input file.

Note: This file is the same as Input File below.

Subscribers to migrate

Defines the criteria which will be used to determine which subscriber accounts will be moved. One of the radio buttons is selected.

Can only be changed if state is P, N or H.

Range Start

If the subscriber range option is selected, this field defines the lowest subscriber account number in the range to move.

Cannot be edited after it is first saved.

Range End

If the subscriber range option is selected, this field defines the highest subscriber account number in the range to move.

Cannot be edited after it is first saved.

Account Batch

The ID of the batch of subscriber accounts to move. This field is populated by the Subscriber Batch tab. For more information about subscriber batches, see Subscriber Batch.

This field can only be edited if:

  • State is P, N or H

  • the migration was not first saved with a range or input file

Input File

The file which lists the subscriber accounts to migrate. This field is displayed in the UBE Account Balancing tab as Input File.

Cannot be edited after it is first saved.

Product Type

The product type of the wallets to migrate.

This field is populated by the Product Type field. For details, see Subscriber Management - Product Type.

This field can only be edited if:

  • State is P, N or H

  • The migration was not first saved with a range or input file.

Wallet States to migrate

Each selected wallet state indicates that the migration should include wallets which are in this state. If this option is selected, at least one check box must be selected. For more information about wallet states, see VWS Technical Guide.

Can only be changed if state is P, N or H.

Maximum Wallets

The maximum number of wallet move requests to send in one set of requests. If this value is set to less than the number of wallets which need migrating, the migration will stop after this number of wallets and change to the Incomplete (I) state.

Optional. If not set, not limit is applied.

Can only be changed if state is P, N, H, I, F or S.

Throttle

The maximum number of wallet move requests to send to the VWS Voucher and Wallet Servers in one second. Optional. Value can be between 1 and 9999.

Note: The actual maximum is the lowest of this number and the throttle parameter in the ccsDomainMigration configuration. For more information about ccsDomainMigration, see CCS Technical Guide.

Can only be changed if state is P, N, H, I, F or S.

Save the remaining subscribers to a file

The filename of the file which stores the details of any subscriber account which is not successfully moved.

Tip: This file can be used as an Input File for a rerun of the migration.

Only enabled if state is P, N, H, I, F or S.

Adding migrations

Follow these steps to add a migration.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the UBE Account Balancing tab, click New.

    Result: You see the New Account Balance Domain Migration screen.

  3. Enter data in the fields to configure this record.

    For more information about the fields on this screen, see UBE Account Balancing fields.

  4. You can check the number of wallets and subscribers on the source and target domains, using the Check Accounts button. For more information about how to use this feature, see Reviewing domain records.

  5. When you have completed configuring the migration, click Save.

    Result: The Confirmation Dialog prompt shows the migration details. and asks for the confirmation.

  6. Click Confirm.

    Results:

    • The migration record details are saved to the database, the migration is started, and the New Account Balance Domain Migration screen is closed.

    • If the migration is successful, the details in the SMF database are updated. After the screen data is refreshed (for example, by clicking Refresh), the migration is shown as having a Migrated (M) state.

    • If the migration has errors all changes are rolled back, and the migration is shown as having a Failure (F) state.

Related topic

UBE Account Balancing

Editing migrations

Follow these steps to edit an existing migration.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the UBE Account Balancing tab, click Edit.

    Result: You see the Edit Account Balance Domain Migration screen.

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

    For more information about the fields in this screen, see UBE Account Balancing fields.

  4. You can check the number of wallets and subscribers on the source and target domains, using the Check Accounts button. For more information about how to use this feature, see Reviewing domain records.

  5. When you have completed changing the details, click Save.

    Note: The Save button is not available if the migration has a migrated (M) state.

    Result: The Confirmation Dialog prompt shows the migration details and asks for confirmation to make the changes.

  6. Click Confirm.

    Results:

    • The migration record changes are saved to the database, the migration is restarted, and the Edit Account Balance Domain Migration screen is closed.

    • If the migration is successful, the details in the SMF database are updated. After the screen data is refreshed (for example, by clicking Refresh), the migration is shown as having a Migrated (M) state.

    • If the migration has errors all changes are rolled back, and the migration is shown as having a Failure (F) state.

Related topic

UBE Account Balancing

Reviewing domain records

Follow these steps to review the wallets and subscribers on the source and target domains in a migration.

  1. On the New Account Balance Domain Migration, or the Edit Account Balance Domain Migration screen, select the source and target UBE domains and click Check Accounts.

    Result: You will see the details in the Accounts Summary screen.

  2. The Source UBE Wallet Count table shows the number of wallets in each state which are on the source Voucher and Wallet Server.

    The Source UBE Subscriber Count table shows the number of subscribers linked to wallets in the source Voucher and Wallet Server. The subscribers are grouped by product type.

    The Target UBE Wallet Count table shows the number of wallets in each state which are on the destination Voucher and Wallet Server.

    The Target UBE Subscriber Count table shows the number of subscribers linked to wallets in the target Voucher and Wallet Server. The subscribers are grouped by product type.

  3. When you have finished reviewing the details, click Close.

    Result: The Accounts Summary screen will close and you will be returned to the New or Edit Account Balance Domain Migration screen.

Viewing migration details

Follow these steps to view the details of an existing migration.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. On the UBE Account Balancing tab, click Edit.

    Result: You see the Edit Account Balance Domain Migration screen.

  3. View the details of the record.

    For more information about the fields in this screen, see UBE Account Balancing fields.

  4. When you have completed viewing the details, click Cancel.

    Result: The Edit Account Balance Domain Migration screen is closed without saving any changes.

  5. With the migration still selected, click Report.

    Result: The Report screen appears showing the migration report.

  6. To export the report, perform one of the following actions:

    • Enter the filename into the field

    • Click Browse and select a destination file.

  7. Click Save.

    Result: The report will be exported to the specified file.

    Example: For an example of an exported report, see Example exported report.

  8. When you have finished looking at the report, click Close.

    Result: The Report screen will close.

Saving unmigrated accounts to input file

Follow these steps to save a list of unmigrated account MSISDNs to a file. This file can then be used as an Input file for a rerun of the migration.

  1. On the UBE Account Balancing tab, select the migration to save the file for, and click Edit.

    Result: The Edit Account Balance Domain Migration screen appears showing the migration details.

  2. Specify the name of the file to write the report to. Perform one of the following actions:

    • Click Select and browse to the file to write the report to

    • Enter the name of the output file.

  3. Click Save.

    Result: The details of the migration report are saved to the file specified in step 2.

    Example: This text shows an example of an export of unmigrated MSISDNs:

    971559101709

    971559101701

    971559101702

    971559101703

    971559101704

    971559101705

    971559101706

    971559101707

    971559101708

  4. Click Cancel.

    Result: The Edit Account Balance Domain Migration screen closes.

Example exported report

This text shows an example of an exported report. It can be used as an input file to run another migration.

State: Migrated

Source UBE: 11

Target UBE: 88

Batch: 84

Allowed Wallet States: PDSFT

Migration Start: 20080610102746

Migration End: 20080610102813

Migrations Completed: 42/50 (84%)

Subscribers Not Migrated:

4416030026 Primary: Wrong state

4416030027 Primary: Wrong state

4416030028 Primary: Wrong state

4416030029 Primary: Wrong state

4416030030 Primary: Doesn't exist in source domain

4416030031 Primary: Doesn't exist in source domain

4416030032 Primary: Doesn't exist in source domain

4416030033 Primary: Doesn't exist in source domain

Shared wallet subscribers also migrated:

None

Wallet Id failed deletion on source UBE:

None

Deleting subscriber account migrations

Follow these steps to delete an existing subscriber account migration record.

  1. In the Subscriber Management screen, select the service provider from the Service Provider list.

  2. In the table on the UBE Account Balancing tab, select the record to delete.

  3. Click Delete.

    Result: You see the Delete Confirmation prompt.

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

Related topic

UBE Account Balancing