1 Subscriber Management
This chapter explains how to specify subscriber details for service providers.
This chapter contains the following topics.
Friends and Destination Black List
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.
-
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.
-
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
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.
-
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.
-
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
-
-
Select the credit card states to search for. The Active and Frozen states are selected by default.
-
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
Click New on the Credit Card tab.
The New Credit Card screen displays.
-
Fill in the credit card details. For more information, see New Credit Card fields.
-
(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.
-
Click Save.
-
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.
-
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
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:
|
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
Editing credit cards
Follow these steps to edit a credit card record.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
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.
-
(Optional) Change the following details as required:
-
Expiry date details
-
Name on card
-
CVC number
-
Freeze or make active the credit card state
-
-
(Optional) To register a subscriber to the credit card, click Register. See Registering subscribers to credit cards.
-
(Optional) To deregister a subscriber from the credit card:
-
Select the subscriber from the table and click Deregister.
-
Click Deregister to confirm.
Note: You cannot deregister the primary subscriber.
-
-
(Optional) To freeze a subscriber's primary wallet:
-
Select the subscriber and click Freeze Wallet.
-
Click Freeze.
-
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.
-
-
If the Registration State is
Pending
, and you want to confirm the subscriber's registration to the credit card, click Confirm. -
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.
-
Click Save.
-
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.
-
Click OK.
Related topic
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:
|
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.
-
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.
-
-
Enter one or more initial digits of the subscriber number in the Subscriber ID field.
-
Select:
-
Exact Match to search for the matching subscriber.
-
Prefix Match to search for all subscribers with IDs that match the entered prefix.
-
-
Click Search.
The search returns a maximum of 100 records.
-
From the search results table, select the subscriber you want to register to the credit card and click Register.
-
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
Deleting credit cards
Follow these steps to delete credit card records.
-
Search for the credit card to delete. See Searching for credit cards.
-
Select the credit card to delete, and then click Delete.
-
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.
-
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
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
To find specific subscriber batches in the Subscriber Batch tab:
-
Enter the first few characters of the subscriber ID and select a batch state.
-
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Subscriber Batch tab in the Subscriber Management screen, click New.
Result: You see the New Subscriber Batch screen.
-
Fill in the fields, as described in New subscriber batch fields.
Once you have filled in all the fields, the Save button becomes active.
-
Click Save.
Result: If successful, you see a message confirming the subscriber batch has been created.
-
Click OK.
Related topic
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:
|
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
In the table on the Subscriber Batch tab, select the record to edit.
-
Click Edit.
Result: You see the Edit Subscriber Batch screen.
-
You can only change the Batch State field. Changing the batch state to active activates the subscriber batch.
-
Click Save.
Related topic
Deleting account batches
Follow these steps to delete an existing subscriber batch.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
In the table on the Select Batch tab, select the record to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK to delete the record from the database.
Related topic
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
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Customer tab, click New.
Result: You see the New Customer screen.
-
In the Name field, enter the name of the new customer.
-
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 asSuper saver's
. -
In the Description field, enter the description of the new customer.
-
In the Reference field, enter a reference for the new customer.
-
Click Save.
Related topic
Editing customers
Follow these steps to edit an existing customer.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
Click Edit.
Result: You see the Edit Customer screen.
-
Edit the details as described in Adding customers.
-
Click Save.
Related topic
Deleting customers
Follow these steps to delete an existing customer.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK to delete the record from the database.
Result: The record is deleted and you see the Customer prompt.
-
Click OK.
Related topic
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
Follow these steps to add a Closed User Group (CUG) and its members.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
For each member that you want to add, enter the subscriber MSISDN in the MSISDN field, and click Add.
-
For each virtual CUG member that you want to add, perform the following steps:
-
Select either Single number, Range, or Pattern.
-
Depending on your previous selection, specify the virtual member number, number range, or prefix and length.
-
Click Add.
-
-
When you have completed adding members to the CUG, click Save.
Related topic
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).
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
Click Edit. The Edit Closed User Group dialog opens.
For more information about the closed user group fields, see Closed User Group fields.
-
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.
-
-
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.
-
-
Click Save.
Related topic
Deleting closed user groups
Follow these steps to delete an existing closed user group (CUG).
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
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.
-
Click Delete.
The Delete Confirmation prompt displays.
-
Click OK to delete the record from the database.
The record is deleted and the Closed User Groups prompt displays.
-
Click OK.
Related topic
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
Follow these steps to edit the numbers in the friends and family black list.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Friends and Family Black List tab, click Edit.
Result: You see the Edit F&F Black List Numbers screen.
-
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.
-
To delete a number, select the number to remove from the list and click Delete.
Result: The number is removed from the list.
-
Click Save.
Related topic
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
Follow these steps to edit the numbers in the Friends and Destination Black List.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Friends and Destination Black List tab, click Edit.
Result: You see the Edit F&D Black List Numbers screen.
-
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.
-
To delete a number, select the number to remove from the list and click Delete.
Result: The number is removed from the list.
-
Click Save.
Related topic
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
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Friends and Destination Prefix Map tab, click New.
Result: You see the New Prefix Announcement Mapping screen.
-
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.
-
Click Save.
Related topic
Editing Friends and Destination Prefix Mappings
Follow these steps to edit an existing Friends and Destination Prefix Announcement Mapping.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
In the grid on the Friends and Destination Prefix Map tab, select the record you want to edit.
-
Click Edit.
Result: You see the Edit Prefix Announcement Mapping screen.
-
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.
-
Click Save.
Related topic
Deleting Friends and Destination Prefix Mappings
Follow these steps to delete an existing Friends and Destination Prefix Announcement Mapping.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
In the table on the Friends and Destination Prefix Map tab, select the record to delete.
-
Click Delete.
-
Result: You see the Delete Confirmation prompt.
-
Click OK to delete the record from the database.
-
Result: The record is deleted and you see the F&D Prefix Map prompt.
-
Click OK.
Related topic
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:
|
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the Profile Group Fields tab, click New Group.
Result: You see the New Profile Tag Group screen.
-
In the Name field, enter the name for this profile tag group.
-
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.
-
-
Click Save.
Related topic
Editing profile tag groups
Follow these steps to edit an existing Profile Tag Group.
-
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 to edit.
-
Click Edit Group.
Result: You see the Edit Profile Tag Group screen.
-
Edit the Name for the profile tag group.
Note: The Permission Name field is not editable.
-
Click Save.
Related topic
Adding a new profile group field
Follow these steps to add a profile group field to a profile group.
-
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.
-
Click New.
Result: You see the New Profile Group Field screen.
-
Select
Profile Field
from the Field Type drop down list.Result: You see the Profile Field options in the New Profile Group Field screen:
-
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.
-
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.
-
In the DisplayName field, type the name you want to give to the field.
-
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.
-
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.
-
-
Click Save.
Related topic
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.
-
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.
-
Click New.
Result: You see the New Profile Group Field screen.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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 to edit.
-
In the table, select the row to edit.
-
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:
-
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.
-
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.
-
-
Click Save.
Deleting profile groups and fields
Follow these steps to delete an existing Profile Group or Profile Field.
-
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.
-
To delete the group and all its associated fields, click Delete Group.
-
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.
-
Click OK to delete the record from the database.
Result: The record is deleted. A confirmation prompt is displayed.
-
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
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 |
---|---|
![]() |
Refreshes the table with migrations of the states which correspond to the selected check boxes. The states for each check box are:
|
![]() |
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. |
![]() |
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. |
![]() |
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:
|
![]() |
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. |
![]() |
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. |
![]() |
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:
|
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:
|
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the UBE Account Balancing tab, click New.
Result: You see the New Account Balance Domain Migration screen.
-
Enter data in the fields to configure this record.
For more information about the fields on this screen, see UBE Account Balancing fields.
-
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.
-
When you have completed configuring the migration, click Save.
Result: The Confirmation Dialog prompt shows the migration details. and asks for the confirmation.
-
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
Editing migrations
Follow these steps to edit an existing migration.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the UBE Account Balancing tab, click Edit.
Result: You see the Edit Account Balance Domain Migration screen.
-
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.
-
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.
-
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.
-
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
Reviewing domain records
Follow these steps to review the wallets and subscribers on the source and target domains in a migration.
-
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.
-
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.
-
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
On the UBE Account Balancing tab, click Edit.
Result: You see the Edit Account Balance Domain Migration screen.
-
View the details of the record.
For more information about the fields in this screen, see UBE Account Balancing fields.
-
When you have completed viewing the details, click Cancel.
Result: The Edit Account Balance Domain Migration screen is closed without saving any changes.
-
With the migration still selected, click Report.
Result: The Report screen appears showing the migration report.
-
To export the report, perform one of the following actions:
-
Enter the filename into the field
-
Click Browse and select a destination file.
-
-
Click Save.
Result: The report will be exported to the specified file.
Example: For an example of an exported report, see Example exported report.
-
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.
-
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.
-
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.
-
-
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
-
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.
-
In the Subscriber Management screen, select the service provider from the Service Provider list.
-
In the table on the UBE Account Balancing tab, select the record to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click Yes to delete the record from the database.
Related topic