GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

All information herein is either public information or is the property of and owned solely by Gemplus S.A. who shall have and keep the sole right to file patent applications or any other kind of intellectual property protection in connection with such information. Nothing herein shall be construed as implying or granting to you any rights, by license, grant or otherwise, under any intellectual and/or industrial property rights of or concerning any of Gemplus’ information. This document can be used for informational, non-commercial, internal and personal use only provided that: •

The copyright notice below, the confidentiality and proprietary legend and this full warning notice appear in all copies.

•

This document shall not be posted on any network computer or broadcast in any media and no modification of any part of this document shall be made.

Use for any other purpose is expressly prohibited and may result in severe civil and criminal liabilities. The information contained in this document is provided “AS IS” without any warranty of any kind. Unless otherwise expressly agreed in writing, Gemplus makes no warranty as to the value or accuracy of information contained herein. The document could include technical inaccuracies or typographical errors. Changes are periodically added to the information herein. Furthermore, Gemplus reserves the right to make any change or improvement in the specifications data, information, and the like described herein, at any time. Gemplus hereby disclaims all warranties and conditions with regard to the information contained herein, including all implied warranties of merchantability, fitness for a particular purpose, title and non-infringement. In no event shall Gemplus be liable, whether in contract, tort or otherwise, for any indirect, special or consequential damages or any damages whatsoever including but not limited to damages resulting from loss of use, data, profits, revenues, or customers, arising out of or in connection with the use or performance of information contained in this document. Gemplus does not and shall not warrant that this product will be resistant to all possible attacks and shall not incur, and disclaims, any liability in this respect. Even if each product is compliant with current security standards in force on the date of their design, security mechanisms' resistance necessarily evolves according to the state of the art in security and notably under the emergence of new attacks. Under no circumstances, shall Gemplus be held liable for any third party actions and in particular in case of any successful attack against systems or equipment incorporating Gemplus products. Gemplus disclaims any liability with respect to security for direct, indirect, incidental or consequential damages that result from any use of its products. It is further stressed that independent testing and verification by the person using the product is particularly encouraged, especially in any application in which defective, incorrect or insecure functioning could result in damage to persons or property, denial of service or loss of privacy. © Copyright 2002 - 2003 Gemplus S.A. All rights reserved. Gemplus, the Gemplus logo, GemXplore, and GemXPresso are trademarks and service marks of Gemplus S.A. and are registered in certain countries. All other trademarks and service marks, whether registered or not in specific countries, are the property of their respective owners. GEMPLUS, B.P. 100, 13881 GEMENOS CEDEX, FRANCE. Tel: +33 (0)4.42.36.50.00 Fax: +33 (0)4.42.36.50.90 Printed in France.

Document Reference: DOC108468A2 June 17, 2003

Contents About This Guide

v

Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Contact our Hotline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Chapter 1

Introduction

1

Value-Added Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 The Role of GemXplore Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 2

Submitting a Service Request

7

Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Submitting a Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Defining the Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Changing the Request Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Logging Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 The Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Activate ADN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Activate FDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Delete Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Delete STK Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Download Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Download STK Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Lock Java Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Send SMS Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Switch ADN/FDN Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Unlock Java Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Update ACC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Update ADN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Update BDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Update CBMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Update FDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Update FPLMN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Update HPLMN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Update IMSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

iii

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update LP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Update MSISDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Update ONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Update PLMN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Update SDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Update SMSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Update SPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Update SST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Update STK Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Update STK Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Update URS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Chapter 3

Monitoring Service Requests

55

The Stages in a Request Submission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Searching For Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Defining Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 The Request Management Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Deleting a Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Acknowledging Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Checking the Details of a Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Checking the Card Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Chapter 4

Managing Campaigns

67

Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Campaign Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Scenario List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Creating a Campaign Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Viewing and Updating a Campaign Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Deleting Campaign Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Scheduling a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Monitoring Campaigns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 The Campaign Monitor Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Displaying the Details of a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Pausing a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Restarting a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Aborting a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Purging a Campaign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Chapter 5

Setting Up a Subscriber Account

81

Creating a New Subscriber Account With Internet Access . . . . . . . . . . . . . . . . . . . . . . 82 Creating a New Subscriber Record Without Internet Access . . . . . . . . . . . . . . . . . . . . 84 Modifying or Deleting a Subscriber Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Importing a List of Subscribers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Appendix A

Installing the WIR program

87

Running the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

iv

About This Guide

GemXplore Suite version 1.3.1 is a platform and Customer Care Interface for managing value-added services for mobile phones. This guide describes how to change the contents or functionality of subscriber SIM cards through the Customer Care Interface of GemXplore Suite. Card management is achieved by submitting service requests to the cards, either over-the-air (OTA) or using a Wired Internet Reader (WIR) connected to your PC. The guide also describes how to monitor the progress of the service requests and how to set up new subscriber accounts within GemXplore Suite. This guide does not deal with the administration of the GemXplore Suite platform - that information is covered in the Administrator’s Guide.

Audience This guide is intended to be read by Customer Care Agents responsible for managing subscriber services. Agents should be familiar with the concepts of an OTA platform, SIM cards, SMS (Short Message Service) protocols, and the GSM network, though these concepts are summarized in “Chapter 1 - Introduction”.

What’s New GemXplore Suite version 1.3.1 offers a new Campaign Management feature, which allows a chain of value added services to be applied to a targeted set of of cards specified in the campaign.

For More Information For more information on administrative or development details of GemXplore Suite version 1.3.1, refer to the following documents: Document

Description

Technical Overview

Provides an introduction to the architecture of the GemXplore Suite platform.

GemXplore Suite Documentation

v

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Document

Description

Installation and Migration Guide

Describes the prerequisites and procedures for installing the GemXplore Suite platform and channel drivers, and for migrating from version 1.3.

Network Administrator’s Guide

Explains how to start the GemXplore Suite platform and keep it connected to other systems.

Administrator’s Guide

Describes the administration tasks that are performed within the management interface to manage the GemXplore Suite platform.

Customer Care Agent’s Guide (this guide)

Explains how to use the Customer Care Interface to change the functionality of subscribers’ SIM cards.

Customizer’s Guide

Describes how to add new services to GemXplore Suite, how to integrate native libraries, and how to internationalize the interface. Also describes the product parameters.

Integrator’s Guide

Provides details of GemXplore Suite methods and parameters so that other applications can communicate with the platform.

Developer’s Guide

Gives information on expanding the GemXplore Suite functionality by developing new Framework products.

Glossary

Provides a list of terminology and abbreviations.

GemXplore Suite Documentation (continued)

Contact our Hotline If you don’t find the information you need in this manual, or if you find errors, contact the Gemplus hotline by phone, fax, or email. In your email, please include the document reference number, your job function, and the name of your company. (You will find the document reference number at the bottom of the legal notice on the inside front cover.)

Corporate and EMEA Hotline: +33 (0)4 42 36 50 50 Hot Fax: +33 (0)4 42 36 50 98 Email: [email protected]

Americas Hotline: 1 (877) 436-7233 Hot Fax: 1 (215) 390-1586 Email: [email protected]

From our Web Site http://www.gemplus.com

vi

1 Introduction

GemXplore Suite version 1.3.1 is a platform for managing value-added services for mobile phones. This guide describes how to change the contents or functionality of subscriber SIM cards through the Customer Care Interface (CCI) of GemXplore Suite. This chapter introduces the main concepts and terminology in order to make the functions described in the rest of the guide more understandable.

Value-Added Services As mobile phones become more capable, phone users are offered more sophisticated services on their phones. These “value-added services” may be, for example, new logos and games, information delivery such as local cinema billings, or personal banking services. To accomplish this functionality, the SIM card in the mobile phone contains its own simple operating system, a small amount of memory (typically 16 - 64 KB), configuration files and various other files. Each service that should be performed by the phone is programmed into an applet that resides in the SIM card’s memory. The card can hold many applets at once. To deliver a new value-added service to the subscriber (a “subscriber” is a mobile phone customer), the Customer Care Agent needs to download (send) an applet or part of an applet to the subscriber’s phone, where it will be stored on the SIM card with the other applets. For example, if the subscriber requests the capability to check stock market statistics, the applet that enables this is downloaded to the subscriber’s phone and the subscriber can immediately make use of the new service. Similarly, an applet can be deleted from the subscriber’s SIM card if necessary. Applets that are already on the card can be activated or deactivated. Information stored on the card in the files can be modified so that, for example, the subscriber’s language preference can be changed, or the subscriber’s list of phone numbers can be edited. All these updates to the subscriber’s phone (that is, to the SIM card) can be accomplished “over-the-air”, which means using the Short Message Service Centre (SMSC) to send the information to the phone in the same way as short text messages are sent to people’s phones. Alternatively, if the subscriber walks into the retail office with the mobile phone, the SIM card can be inserted in a Wired Internet Reader (WIR) connected to the Customer Care Agent’s PC and updated on the spot. The WIR can also be used to prepare cards for distribution, for example to company sales people.

1

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

The Role of GemXplore Suite The management of value-added services on the subscribers’ mobile phones is achieved using GemXplore Suite. Its databases contain records of all SIM cards, of all subscribers, and of all applets that can be downloaded to the cards, and it provides the platform for all operations affecting the SIM cards’ contents. GemXplore Suite has a Web-based interface that you can access using any Web browser. Your access is password-controlled, and you can log on remotely, as with any website, or on an intranet. The following figure shows the information route between the Customer Care Agent and the subscribers’ phones.

Customer Care Agent: Download applets Monitor progress Create subscriber account Manage and monitor campaigns

GemXplore Suite host and Web server

Card DB Customer Care Interface (CCI)

Framework DB

GemXplore Suite 1.3.1

WIR

Subscriber

Applet DB

Status

Service Requests

SMSC (Short Message Service Centre)

Subscribers

Figure 1 - Managing Value-Added Services Through GemXplore Suite As the Customer Care Agent, you change the contents of a subscriber’s SIM card by creating a “service request” in GemXplore Suite. That is, you request that a service is performed on the card. (Do not confuse this with the “value-added services” provided by the card.) A service request consists of a destination (which card or cards to modify), a type of service, and some standard parameters. GemXplore Suite processes the service request and sends it to the SMSC, which transmits it over-the-air to the mobile phone. The mobile phone acts on the request and sends back a status message, either “Succeeded” or “Failed”.

2

Introduction

The subscriber’s SIM card is thus modified almost immediately, depending on factors such as the amount of message traffic passing through GemXplore Suite and the SMSC at the time. In each system, the request is placed in a queue and dealt with according to the priority given it, so the request can take a few seconds or several minutes to complete. After submitting the service request, you can monitor its progress in GemXplore Suite. If a request appears not to have succeeded for some reason, you can check up on its status and view any problems that arose. GemXplore Suite offers a broad selection of services for performing different operations on the card. Most services add some content to a card, for example they download an applet or add some records to a list. Changes to a card’s contents are mirrored in the GemXplore Suite card database, where a complete record is held of every SIM card in the subscriber domain. In this way, you can check the contents of any card before or after modifying it in some way. You can send the same request over-the-air to several cards at the same time if necessary. If you are using a WIR, however, you can update only one card at a time. The only setting up procedure required for the cards is to link the subscriber’s phone number (the MSISDN) to the SIM card serial number (the ICCID) when the card is first issued. This is done through the CCI too and is described in this guide. At the same time, you can also create an internet account for the subscriber so that the subscriber can, via the internet, perform some simple tasks on his or her own phone, such as downloading new games or logos. This guide gives step-by-step instruction on all the procedures mentioned above: •

“Chapter 2 - Submitting a Service Request”: How to submit a request to one or more SIM cards

•

“Chapter 3 - Monitoring Service Requests”: How to check up on the requests you’ve recently sent

•

“Chapter 5 - Setting Up a Subscriber Account”: How to link a card number to a subscriber phone number, and how to open an internet account for the subscriber

•

Managing a Campaign: How to create a campaign scenario, schedule a campaign, and monitor the campaigns progress.

This guide does not include information on how a subscriber accesses his or her account through the internet. Note that the use of a WIR is optional. To prepare your WIR for use with GemXplore Suite, you first need to install an applet on your PC - see “Appendix A - Installing the WIR program” for instructions on doing this.

Cards In order to understand what the various services are actually doing to the SIM cards, it is helpful to know a little about the structure of the cards. SIM cards can basically be divided into two types: “native” cards and Java-enabled cards. The native cards (which are non-Java-enabled) usually run STK (SIM ToolKit), which is a protocol that enables the card to accept commands and reply to them. GemXplore Suite supports both types, including the following cards manufactured by Gemplus:

3

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

•

STK cards: GemXplore 98, U-Choose

•

Java cards: GemXplore Xpresso V3, UICC/USIM cards

Although the two types of card have similar capabilities, their internal data structure is somewhat different, as summarized by this figure:

STK card

Java card

Java package

STK applet Configuration files and system files STK Service

STK Service

Configuration files and script files

Java applet

Java applet

Java applet instances

Figure 2 - Card Structures An STK card contains several applets, each of which can contain several services. Each service can contain several configuration files and script files. Note that the applet also contains its own configuration files. You can update an STK applet or an STK service by sending new versions of the corresponding configuration files. (An STK service contains the code that handles a branch of the main menu displayed by the mobile phone when it is switched on.) A Java card contains several Java packages, each of which can contain several Java applets. These applets generate “instances” - this is a programming term, but in this case simply means that the applet can be subdivided into further useful functions. The above descriptions are simplified. SIM cards also contain various other files and resources that are not relevant to this user’s guide.

4

Introduction

Error Messages Just occasionally while you are using GemXplore Suite you may see an error message, showing you that something did not work. For example:

Figure 3 - Error Message (example) In this case, the best option is to try one more time. If the operation fails again with the same message, consult your Administrator or Network Administrator. Most error messages are due either to part or all of the program not being activated or to a network problem.

Prerequisites To access GemXplore Suite, you need the following: •

An internet browser: Microsoft Internet Explorer version 5.0 or later or Netscape version 6 or later

•

The URL (address) of the GemXplore Suite website

•

A valid login name and password (which the GemXplore Suite administrator has given you).

5

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

6

2 Submitting a Service Request

This chapter describes how to change the contents or functionality of a subscriber’s SIM card by sending a service request to that card. You will usually send the request over the air. If the subscriber’s mobile phone is switched on, the SIM card will be updated immediately the request is sent (within a normal delay, of course, depending on system use, network traffic and so on). If the phone is not switched on, GemXplore Suite will continue trying to send the request until the mobile phone is switched on and receives it or until the request times out. However, if you have a Wired Internet Reader (WIR) connected to your terminal, you can insert the card in the WIR to modify it. If your PC is not yet set up for this, first see “Appendix A - Installing the WIR program”. Each service request has three parts: –

A request destination, where you specify which SIM card (mobile phone) or cards to send the request to

–

The type of service and the details of the service

–

Service request options, such as whether the request should be sent immediately or not

For service requests sent over the air, you can choose to send a request to many cards at once (as described in “Defining the Destination”).

Logging In At your PC or UNIX terminal, log in to the Customer Care Interface of GemXplore Suite as follows: 1. Open a Web browser and enter the URL defined for GemXplore Suite. (Ask your administrator for this URL if you do not know it.) If you are accessing GemXplore Suite on an intranet, it may look something like this: http://:/CCI But if you are using an SSL connection on the internet, it may look something like this: https:///CCI

7

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Once you have connected to GemXplore Suite, you see the GemXplore Suite Login window.

Figure 4 - GemXplore Suite Login Window 2. Type your account name and password in the two fields and click Login. Note: If you try to log in unsuccessfully three times, your account becomes locked. You must then ask your administrator to unlock the account. If you’ve logged in successfully, you see the Customer Care Interface Welcome window:

Figure 5 - Customer Care Interface Welcome Window

8

Submitting a Service Request

This window is your starting point for all actions in GemXplore Suite: •

User management allows you to set up an account for a subscriber to submit requests, as described in “Chapter 5 - Setting Up a Subscriber Account”

•

Card management lets you see what’s currently on each SIM card - see “Checking the Card Content” in the next chapter for details.

•

Request management includes submitting requests, as described in this chapter, and monitoring them, as described in the next chapter.

Submitting a Request To submit a service request, follow these steps: 1. On the Customer Care Interface Welcome window, click Request management. (Or click Request at the top of any other window in the CCI.) 2. Click Request -> Request submission in the left frame of the screen. You now see a window with three tabs along the top, for entering the Destinations, the Service, and the request Options. You can fill in these three pages in any order.

Figure 6 - Request Submission Window 3. Fill in the Destinations page to specify which card or cards should receive the service request. This window is the same for any type of request - see “Defining the Destination” later for details.

9

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

4. Click the Service tab and select a service from the drop-down list on the Service page. The list of services offered may not be exactly as shown below (it depends on the user profile set up for you by your administrator).

Figure 7 - Service Drop-down List 5. In the window that appears at the bottom of this page, fill in the information required for the service. This window changes depending on which service you choose. For details of how to fill in the window, look up the service in the section “The Services” later in this chapter. Note: Free text can be entered for billing information. However, text entered cannot contain a comma or a new line character. 6. Enter billing information in the Billing information field. 7. Before submitting a request, you may want to check the request Options and, if necessary, change them - these are described in “Changing the Request Options”. In particular, if you want to use the WIR, you must select this on the Options page. 8. After providing all details for the service request, click the Destinations tab and click Submit request to send the request. If you sent the request over the air, you should see the following:

This means the request is now being processed by GemXplore Suite. You can check the progress of the request using the Request Monitoring function as described in “Chapter 3 - Monitoring Service Requests”. If, for any reason, you want to stop the request before it is processed, you can delete it as described in “The Request Management Window” in the next chapter. If you are using a WIR, the card is changed immediately as described next.

Using the WIR 9. If you chose the WIR option, you may see a Security Warning window when you click Submit request to send the request. This is a standard security message that you must confirm in order to use the WIR facility with GemXplore Suite. Click

10

Submitting a Service Request

Grant always - you will never see this message again. (If you click Grant this session, you will see this message the next time you use GemXplore Suite too.) 10. If prompted to insert the card in the WIR, do it now. (If the card was already inserted, you do not see a message.) 11. Enter the PIN code for the card when prompted and press Enter. If the card is successfully changed, you see the following message and can now remove the card:

Defining the Destination On the Destinations page, you specify one or several cards by entering their card numbers - these are usually MSISDNs (which are normally the phone numbers), but can be other types of identification. You can mix identification types if you are specifying several destinations. If you need to make changes to a great many cards at once, you can save the list of cards in a file and import the list - see “Saving a Destination List”. For each destination card, fill in the fields as described here. Field

Description

Destination type

The type of card number entered in the Destination Card field. Select one from the drop-down list. The default is MSISDN: MSISDN (Mobile Station Integrated Services Digital Network number) - This is usually the phone number of the card. IMSI (International Mobile Subscriber Identity) - The unique number identifying a GSM subscriber. ICCID (Integrated Circuit Card Identifier) - The physical card identifier. The SIM serial number that is normally printed on the exterior of each card by the supplier.

Destination card

The numeric value that identifies the card. For example, if you selected MSISDN as the Destination Type, you would enter the subscriber’s phone number here. A phone number must be entered exactly as it was defined, with or without spaces, when setting up the subscriber’s account (as described in “Chapter 5 - Setting Up a Subscriber Account”).

Table 1 - Request Destination Fields

11

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

After specifying each card, click Add to add the card to the destination list in the lower part of the window. You can remove a card from this list if necessary using the Delete button.

Note that multiple destinations are permitted only for over-the-air requests. If you are changing the card’s content using a WIR connected to your terminal, you can specify only one card.

Saving a Destination List If you have specified several destination cards, you can avoid repetition by saving the list for later use as follows: 1. Click Import/Export destination list. You see the following window:

Figure 8 - Import/Export Destination List 2. Click Export on the right side of the window and follow the instructions to save your destinations list as an XML file. To use the list later instead of entering all the card details again: 1. In the Destinations page, click Import/Export destination list. 2. Click Browse. Locate the file and click Open. 3. Click Import. The list of cards from the file is added to any that are already defined in the window.

12

Submitting a Service Request

Destination List Format: Note that the XML file of destinations can be edited using any text editor, if you need to do this. For a batch of very many cards on which you may need to perform several services, you can create a list of their destination parameters in an XML file according to the following format rules and import the list for each service. Several cards are normally defined in the file, each card definition enclosed between and . xxxxx is the value of the Destination card field:

For an example of the file format, create a list using the Export function and open it with a text editor.

Changing the Request Options

Figure 9 - Request Parameters Page The request options describe certain attributes of the request, such as its priority level and what time it should be sent to the card. The starting values for this page are stored in the Default Options window. You can change these if necessary - see “Changing the Default Request Options” - or you can change the option values each time you send a request on this Options page. Note that, if the request is to be sent to several cards at the same time, the same option values are used for all destinations.

13

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Request Parameters These options concern the timing and delivery of the request. Field

Description

Priority

The level of importance - Low, Normal, or High. The priority affects the delivery time. If a request is sent as High priority, it will be placed in the queue above the Normal requests. If it is sent as Low priority, it will be dealt with once there are no more High or Normal priority requests to process.

Guarantee of execution

Checking this option means that, if the GemXplore Suite platform falls over for any reason, the request will not be lost a backup ensures that the request is placed in the queue again once the platform is up and running. Note, however, that using this option every time may slightly affect system performance.

Request acknowledgment

If this is selected, the service request remains visible in the “Request Management Window” until you acknowledge it. If you do not select this option, the request will be removed from the window as soon as it is completed. Caution: If you do not have the request monitoring capability (configured when your administrator set up your account), do not select this option, as there would be no way to remove the request from the “Request Management Window” before it is eventually purged.

Validity type and Validity period

A time limit for delivery to the subscriber’s phone can be set here. If the service can not be delivered within the defined period, it will be marked “Expired” and no further attempts will be made to deliver it. If no Validity period is set, GemXplore Suite will continue to attempt to deliver the request, unless a separate timeout period (defined by the administrator) is eventually reached. If you select Absolute Validity type, specify in Validity period a specific date and time limit for delivery. Do this by clicking the calendar button to the right of the field: adjust the time (if necessary) and then select a date. To remove a validity period, click the X button to the right of the calendar. If you select Relative Validity type, enter a number of hours, minutes, and seconds. For example, to specify that the request must be completed within two days of the processing date, you can enter 48 in the hours box.

Processing date

If you do not want the request to be processed immediately, specify here the date and time that the request should be processed. To do this, click the calendar button, adjust the time if necessary, and select a date. Until the request is processed, it will be marked CREATED in the Request management window. If you leave the field blank, the request will be processed immediately. You can remove a date by clicking the X button to the right of the calendar.

Originating address

The official phone number of the network operator who is authorized to send messages. This number is often included in messages from the operator to the subscriber.

Table 2 - Request Options

14

Submitting a Service Request

Field

Description

Originating address TON

The Type Of Number of the originating address.

Originating address NPI

The Numbering Plan Identifier of the originating address.

Channel protocol

With these radio buttons, you can choose to send the request over the air via the Short Message Service Centre (SMS) or directly to a card inserted in a WIR connected to your terminal. If you use the WIR, only one destination card can be specified on the Destinations page, and it must be the card inserted.

Request security

You should normally leave this field set to Default, which means the request will be sent using the appropriate security standard for each card. If, for some reason, you need to set different security parameters, choose either of the two alternative security standards for encrypting information. You can change the security settings for both types by clicking Security parameter settings. The security parameters are not described in this guide as, for normal use, there should be no need to change them.

Table 2 - Request Options (continued)

Changing the Default Request Options Each time you submit a request, the Options page is filled with starting values that are stored in the Default Options window. Although you can change the values for each request before submitting the request, it makes sense to set up the Default Options window with the values you will most often need to use. To do this: 1. In the left frame, click Request -> Default options. You see a window almost identical to the “Request Parameters Page”. 2. Change the values as required (refer to “Table 2 - Request Options”) and then click Validate.

Logging Out It is important to end the session properly to ensure security. Otherwise, if the browser remains open the program can be revisited without logging in. (You may be logged out automatically after a certain period of inactivity. Nevertheless, it is always a good idea to log out when you have finished working.) 1. To end a GemXplore Suite session, click Logout in the left frame. You are asked to confirm:

15

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

2. Click Logout. You are now disconnected from GemXplore Suite and returned to the “GemXplore Suite Login Window”.

16

Submitting a Service Request

The Services The standard services available through GemXplore Suite are summarised below, with links to the detailed explanations on the following pages. It is possible that not all these services are available to you, and extra services may have been added for your system that are not described here. Service

Description

“Activate ADN”

Set the mobile phone to Abbreviated Dialing Numbers mode

“Activate FDN”

Set the mobile phone to Fixed Dialing Numbers mode

“Delete Applet”

Delete an applet on the SIM card

“Delete STK Service”

Delete an STK service on the SIM card

“Download Applet”

Download an applet to the SIM card

“Download STK Service”

Download an STK service to the SIM card

“Lock Java Applet”

Deactivate an applet on a Java SIM card

“Send SMS Text”

Send a short text message to the mobile phone

“Switch ADN/FDN Mode”

Switch between ADN and FDN dialing modes

“Unlock Java Applet”

Activate an applet on a Java SIM card

“Update ACC”

Change the user access

“Update ADN”

Change one or more of the subscriber’s personal numbers

“Update BDN”

Change the barred (not enabled) dialing numbers

“Update CBMI”

Change the Cell Broadcast Message Identifier

“Update FDN”

Change one or more of the Fixed Dialing Numbers

“Update FPLMN”

Change the list of forbidden GSM networks

“Update HPLMN”

Change the GSM network search period

“Update IMSI”

Change the unique identity of the subscriber

“Update LP”

Change the language displayed on the mobile

“Update MSISDN”

Change the subscriber’s address

“Update ONS”

Change the display of the operator’s name

“Update PLMN”

Change the GSM networks used

“Update SDN”

Change the network operator’s service dialing numbers

“Update SMSP”

Change the subscriber’s parameters for sending short text messages

“Update SPN”

Change the display name of the service provider

“Update SST”

Change the list of activated services

Table 3 - Standard GemXplore Suite Services

17

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Service

Description

“Update STK Applet”

Update the configuration of an STK applet that already exists on the SIM card

“Update STK Service”

Update the configuration of an STK service that already exists on the SIM card

“Update URS”

Change one or more User Report Strings

Table 3 - Standard GemXplore Suite Services (continued) In the following field descriptions, all field entries are mandatory unless noted as optional. Note that updating the configuration of an applet or STK service is not the same as downloading a new version of the applet or STK service. In order to download a new version of an applet, Java package, or STK service, you need to first delete the old version. That is, you submit two services in this order: 1. “Delete Applet” or “Delete STK Service” 2. “Download Applet” or “Download STK Service”

18

Submitting a Service Request

Activate ADN

Description This service selects ADN (Abbreviated Dialing Numbers) mode for the subscriber’s mobile phone. ADN mode lets the subscriber call any number at will, and also gives the subscriber access to the ADN list. There are no parameters to enter with this service. (Also see the services “Activate FDN” and “Switch ADN/FDN Mode”.) If the mobile phone was already in ADN mode, no change is made (and a SUCCEEDED status is returned).

19

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Activate FDN

Description This service selects FDN (Fixed Dialing Numbers) mode for the subscriber’s mobile phone. FDN mode restricts the subscriber to only the numbers in the FDN list. The subscriber can not use the phone to call any other number. There are no parameters to enter with this service. (Also see the services “Activate ADN” and “Switch ADN/FDN Mode”.) If the mobile phone was already in FDN mode, no change is made (and a SUCCEEDED status is returned).

20

Submitting a Service Request

Delete Applet

Description This service removes an STK applet or Java package from one or more SIM cards. 1. Click either STK applet or Java package, depending on whether you want to delete an STK applet or a Java package. All available applets/packages are now listed. 2. Select an applet or package in the left-hand list. 3. For STK applets, now select the applet or part of the applet in the right-hand list. The name of the applet or applet part to be deleted appears in the bottom field.

21

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Delete STK Service

Description This service deletes an STK service from one or more SIM card(s). An STK service is a collection of STK applet files and STK configuration files. 1. Select an applet in the left-hand list. 2. Select the STK service in the right-hand list. The name of the STK service to delete appears in the bottom field.

Restrictions This service is available only for STK cards such as GemXplore98 and U-Choose.

22

Submitting a Service Request

Download Applet

Description This service securely downloads an STK applet or Java package to one or more SIM card(s). After downloading, the applet or package is immediately available for use by the subscriber. Alternatively, just one STK applet configuration file can be downloaded. In the figure shown above, four available configuration files are shown under the “News” STK applet. For Java cards, the downloadable unit is a Java package, which may contain several applets. If not all of these applets should be made available to the subscriber, as a second step you can use the service “Lock Java Applet” to deactivate some of the applets. This service will fail if the applet or package already exists on the SIM card. (If you are downloading a new version of an STK applet or Java package, you must use the service “Delete Applet” first.) 1. Click either STK applet or Java package, depending on whether you want to download an STK applet or a Java package (which depends on the card type). All currently available applets or packages are now listed on the left; if you move the pointer over the applet or package name, its version number pops up. 2. Select an STK applet or Java package in the left-hand list. 3. For STK applets, now select the applet or one of its configuration files in the righthand list. The name of the STK applet, applet configuration file, or Java package to download appears in the bottom field.

23

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Download STK Service

Description This service securely downloads an STK service to one or more SIM card(s). An STK service is a collection of script files and configuration files, and can be downloaded as one entity. Alternatively, you can download just one configuration file from the STK service. (In the figure above, the “News” STK applet contains two STK services; the “Cinema” STK service contains the configuration file “ConfigurationCinema”.) 1. Select an STK applet in the left-hand list. If you move the pointer over the service name in the right-hand pane, the service’s version number pops up. 2. Select the service or configuration file in the right-hand list. The name of the service or configuration file to download appears in the bottom field. After downloading, the service or configuration file is immediately available for use by the subscriber.

Restrictions This service is available only for STK cards such as GemXplore98 and U-Choose.

24

Submitting a Service Request

Lock Java Applet

Description This service is used to lock an applet’s instance in one or more Java SIM cards. Locking an applet’s instance leaves it on the card but deactivates it so that the subscriber can not use it. The downloadable unit for Java cards is a Java package, which may contain several applets, so after downloading a package it may be necessary to deactivate some of the applets using this service. At any time later they can be activated using the service “Unlock Java Applet”.

Fields You need to enter the details in all fields on this page in order to identify the Java applet and instance. If you do not know these details, your administrator should be able to provide them. Field

Description

Package ID

The number or name that identifies the Java package containing the applet to be locked in the card

Application AID

The number or name that identifies the applet to be locked. In this version (V1.3), this is the same value as the Package AID.

Instance AID

The number or name that identifies the applet instance to be locked. In this version (V1.3), this is always the same value as the Application AID.

Package Major Version

The major version number of the applet

Package Minor Version

The minor version number of the applet

Restrictions The service is valid only for Java-enabled cards such as GemXplore Xpresso V3.

25

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Send SMS Text

Description With this service, you can send a short text message to one or more mobile phones. Enter the text to send. All text, alphabetic and punctuation characters are accepted. If using the ETSI alphabet (all european languages), the text can be up to 160 characters long. If using the UCS2 alphabet, the maximum length is only about half that. On being displayed by the mobile phone, the text may be truncated to fit the maximum message size.

Restrictions On the Destinations page (see “Figure 6 - Request Submission Window”), you must specify MSISDN as the Destination type and enter the card’s MSISDN phone number. You can not use the IMSI or ICCID number, or the request will fail. It does not make sense to use this service if you are using the WIR connection, although GemXplore Suite will still try to send the message.

26

Submitting a Service Request

Switch ADN/FDN Mode

Description This service switches the mobile phone between ADN mode and FDN mode: •

ADN (Abbreviated Dialing Numbers) mode lets the subscriber call any number at will, and also gives the subscriber access to the ADN list.

•

FDN (Fixed Dialing Numbers) mode restricts the subscriber to only the numbers in the FDN list. The subscriber can not use the phone to call any other number.

If the phone was in ADN mode, it switches to FDN mode. If it was in FDN mode, it switches to ADN mode. There are no parameters to enter with this service. Also see the services “Activate ADN” and “Activate FDN”.

27

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Unlock Java Applet

Description This service is used to unlock an applet in one or more SIM cards. It can be used to reactivate an applet instance (that is, make it available to the subscriber) that has been locked using the service “Lock Java Applet”.

Fields Field

Description

Package ID

The number or name that identifies the Java package containing the applet to be unlocked in the card

Application AID

The number or name that identifies the applet to be unlocked.In this version (V1.3), this is the same value as the Package AID.

Instance AID

The number or name that identifies the applet instance to be unlocked. In this version (V1.3), this is always the same value as the Application AID.

Package Major Version

The major version number of the applet

Package Minor Version

The minor version number of the applet

Restrictions The service is valid only for Java-enabled cards such as GemXplore Xpresso V3.

28

Submitting a Service Request

Update ACC

Description The Access Control Class (ACC) controls subscriber access under certain conditions. It contains the random access class and special access class. Each subscriber has one normal priority class. Subscribers that belong to special services also have a high priority class. Use this service to change the allocation of the priority levels. Select a priority level to set it, or deselect it to deactivate it

29

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update ADN

Description Abbreviated Dialing Numbers (ADN) are the phone numbers of friends, colleagues, or businesses stored on the SIM card. The subscriber uses this list like a personal phone book to call correspondents. Use this service to make changes to numbers in the ADN list. Only the ADN records sent in the request are changed; other existing ADN records are left unchanged. However, you must know specifically which records in the ADN list need changing, so that you do not mistakenly change numbers entered by the subscriber. Note that for the subscriber to access the ADN, the phone must be in ADN mode (see “Switch ADN/FDN Mode”).

Fields

30

Field

Description

Record

This is simply a number that identifies, and defines the order of, the phone number in the ADN list.

Alpha Identifier

The name of the correspondent who has this phone number. (Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.The space available depends on the card - it may be, for example, 14 characters, or 24 characters, or some other length.)

Phone Number

The correspondent’s phone number, exactly as it should be entered when making a call. For example, if the call is to be made internationally, the number must include the international dialing prefix and code.

Submitting a Service Request

Field

Description

TON

The Type Of Number.

NPI

The Number Plan Identification that ensures compatibility with other numbering plans.

EXT1

The two-digit hexadecimal value of the record number in the Extension where this phone number will be stored. Use this only if there is no more room in the ADN list for extra records. If you are updating a record in the main ADN list, leave EXT1 as FF.

CCI

The two-digit hexadecimal value of the record number in the Capacity/Configuration parameters that contains the prefix for the phone number, if one is to be used. If no prefix is to be used, leave this field as FF.

After entering all the information for a number, click Add. You can add or update several numbers in the subscriber’s ADN list in the same service request, as many as can be held in the card’s ADN list. (Note that you can add or update records; you can not delete records currently on the SIM card.)

31

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update BDN

Description Barred Dialing Numbers (BDN) are numbers stored on the SIM card that the subscriber is prevented from accessing. They can be individual services such as data transmission, or types of calls such as long distance. Use this service to make changes to the list of barred dialing numbers.

Fields

32

Field

Description

Record

A number that identifies the record on the card

Alpha Identifier

The identifier associated with the barred number. (Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.)

Phone Number

The phone number that the subscriber can not access, or an SSC (Supplementary Service Control) string.

TON

The Type Of Number

NPI

The Number Plan Identification that ensures compatibility with other numbering plans

CCI

The two-digit hexadecimal value of the record number in the Capacity/Configuration parameters that contains the prefix for the phone number, if one is to be used. If no prefix is to be used, leave this field as FF.

Submitting a Service Request

Field

Description

EXT4

The two-digit hexadecimal value of the record number in the Extension where this phone number will be stored. Use this only if there is no more room in the BDN list for extra records. If you are updating a record in the main BDN list, leave EXT4 as FF.

Comparison

The two-digit hexadecimal value of the comparison method used

After entering all the information for a number, click Add. If necessary, you can add or change several BDN records in the same service request (for the same mobile phone).

Restrictions BDN is an optional feature not supported by all mobile phones.

33

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update CBMI

Description Each Cell Broadcast Message contains an identifier (CBMI) to indicate the language and type of content of the message. The subscriber can set the mobile to filter the types of messages to receive. For example, messages that are identified as advertising or those in an unfamiliar language can be ignored. Use this service to change records in the list of cell broadcast message types; this list is stored on the subscriber’s SIM card. The subscriber configures this list to filter out unwanted messages.

Fields Field

Description

Record

The CBMI index, which is a number that identifies the record on the card. This number has no other significance except to order the records in the list.

Value

The combined value of the message type and the language

After entering a record number and a value, click Add. You can repeat this process to update more than one record in the list in the same service request. Only the CBMI records sent in the request are changed; other existing CBMI records are left unchanged. (Note that you can add or update records; you can not delete records currently on the SIM card.)

34

Submitting a Service Request

Update FDN

Description Fixed Dialing Numbers (FDN) are pre-programmed phone numbers stored on the SIM card. The subscriber can use this list like a personal phone book to call correspondents but can not change any of the numbers. Use this service to make changes to the numbers in the FDN list. Note that a SIM card is enabled to use either the FDN or the ADN, the mode being set by the service “Switch ADN/FDN Mode”. Therefore, make sure the SIM card is switched to FDN mode if the subscriber should use the FDN list.

Fields Field

Description

Record

This is simply a number that identifies, and defines the order of, the phone number in the FDN list

Alpha Identifier

The name of the correspondent who has this phone number. (Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.The space available depends on the card - it may be, for example, 14 characters, or 24 characters, or some other length.)

Phone Number

The correspondent’s phone number, exactly as it should be entered when making a call. For example, if the call is to be made internationally, the number must include the international dialing prefix and code.

TON

The Type Of Number.

35

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Field

Description

NPI

The Number Plan Identification that ensures compatibility with other numbering plans.

EXT2

The two-digit hexadecimal value of the record number in the Extension where this phone number will be stored. Use this only if there is no more room in the FDN list for extra records. If you are updating a record in the main FDN list, leave EXT2 as FF.

CCI

The two-digit hexadecimal value of the record number in the Capacity/Configuration parameters that contains the prefix for the phone number, if one is to be used. If no prefix is to be used, leave this field as FF.

After entering all the information for a number, click Add. You can add several numbers to the subscriber’s FDN list in the same service request, as many as can be held in the card’s FDN list. (Note that you can add or update records; you can not delete records.)

36

Submitting a Service Request

Update FPLMN

Description The Forbidden Public Land Mobile Network (FPLMN) list defines which PLMNs the mobile phone should not attempt to access automatically. Use this service to change the list of FPLMNs.

Fields Field

Description

Record

The number that identifies a network record in the list. (No priority is attached to this number.)

Operator Name

Select a network operator from the drop-down list

After entering a record number and an operator name, click Add. You can add a maximum of four FPLMNs to the subscriber’s list in the same service request. To add more than four, use a second service request. Only the FPLMN records sent in the request are changed; other existing FPLMN records are left unchanged. (Note that you can add or update records; you can not delete records.)

37

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update HPLMN

Description The Home Public Land Mobile Network (HPLMN) selector controls the period of time spent searching for a GSM network when the mobile phone is switched on. Use the “Update PLMN” service to set the preferred network operator (priority 1) and to list the others in order of priority. Use this service to change the search period for each network. For example, if you enter 2 in the box, the mobile phone will spend 12 minutes searching for a signal from each operator, and will work its way down the PLMN list until it finds a network. The default card setting is 5 (that is, 30 minutes) if the HPLMN has never been updated. If you enter 0, the HPLMN service is deactivated and no network search attempts are made, though in most cases the subscriber can still use the phone.

38

Submitting a Service Request

Update IMSI

Description The International Mobile Subscriber Identity (IMSI) uniquely identifies a subscriber. Use this service to change the identity when, for example, the subscriber changes country and operator. Caution: When you update the IMSI, the card reference in the card manager database is also updated. For all subsequent operations, you must target the card using the new IMSI.

Fields Field

Description

Operator Name

Select an operator from the drop-down list

Mobile Subscriber Id Number The subscriber’s identification number (up to 20 letters or numbers)

39

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update LP

Description The Language Preference (LP) controls a list of languages/alphabets that affect two functions on the mobile phone: •

It selects the alphabet used to display incoming messages. Certain characters (for example, â) can only be displayed using an appropriate alphabet.

•

It selects the language used for displaying menu items.

Use this service to set the priority order for the languages/alphabets in the subscriber’s phone interface. That is, the language with the priority 1 will be the first-choice language. In the example shown, Portuguese will be the language and alphabet used if it is supported by the mobile phone. If not, Spanish will be used.

Fields Field

Description

Record

The priority of the language/alphabet on the card. Enter a number.

Language

Select a language from the drop-down list.

After entering a priority and selecting a language, click Add. You can repeat this process to set the priorities of several languages in the same service request.

40

Submitting a Service Request

Update MSISDN

Description The Mobile Station Integrated Services Digital Network (MSISDN) number is the mobile’s phone number. In fact, a mobile can have several MSISDN numbers, which could for example be used to identify different services, such as voice or fax, or which could be based in different countries. The SIM card stores these numbers and links them all to the subscriber’s unique International Mobile Subscriber Identity (IMSI) number, which is also stored on the SIM card. Use this service to make changes to the MSISDN number(s) of the card.

Caution: •

This is a powerful service that could render the subscriber’s phone unusable if you make the wrong entries. The MSISDN number(s) stored on the SIM card must reflect the number(s) allocated by the network operator.

•

When you update the MSISDN, the card reference in the card manager database is also updated. For all subsequent operations, you must target the card using the new MSISDN.

•

If you change the primary MSISDN for a card and the subscriber has an account with internet access, you should also update the subscriber’s account record to reflect this change - to do this, see “Modifying or Deleting a Subscriber Account”.

41

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Fields Field

Description

Record

This is simply a number that identifies the phone number in the MSISDN list

Alpha Identifier

The subscriber’s name (or some variant of it, if required, to distinguish several numbers). Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.

Phone Number

The phone number of the mobile phone (the MSISDN)

TON

The Type Of Number

NPI

The Number Plan Identification that ensures compatibility with other numbering plans

EXT1

The two-digit hexadecimal value of the record number in the Extension where this phone number will be stored. Use this only if there is no more room in the MSISDN list for extra records. If you are updating a record in the main MSISDN list, leave EXT1 as FF.

CCI

The two-digit hexadecimal value of the record number in the Capacity/Configuration parameters that contains the prefix for the phone number, if one is to be used. If no prefix is to be used, leave this field as FF.

After entering all the information for a number, click Add. If necessary, you can add or change several MSISDN numbers in the same service request (for the same mobile phone).

42

Submitting a Service Request

Update ONS

Description The Operator Name String (ONS) can be displayed on the mobile phone when the phone is in idle mode. Use this service to change the name displayed.

Fields Field

Description

Operator Name

The operator name to display. You are prevented from entering a name that is too long.

43

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update PLMN

Caution: This is a powerful service that could render the subscriber’s phone unusable if you make the wrong entries.

Description The Public Land Mobile Network (PLMN) selector determines which GSM networks the mobile phone can connect to when it is switched on. The network operators are stored in a list on the SIM card in order of priority. The mobile phone works through the list in order, starting at number 1, until it finds a signal. (The time that it spends searching for each operator can be changed using the service “Update HPLMN”.) With this service, you can make changes to the list on the SIM card. Each record you specify replaces the record with the same record number on the SIM card. If you do not know which operator is already assigned to which record number on the SIM card, the only safe way to use this service is to specify all required records. Note that if the subscriber has chosen an international “roaming” option, the phone may search for other operators apart from those defined here.

Fields Field

Description

Record

The priority of the operator. Enter a number.

Operator Name

Select an operator from the drop-down list

After entering a priority and selecting an operator, click Add. You can repeat this process to set the priorities of several operators in the same service request. Only the PLMN records sent in the request are changed; other existing PLMN records are left unchanged. (Note that you can add or update records; you can not delete records.)

44

Submitting a Service Request

Update SDN

Description Service Dialing Numbers (SDN) are the numbers related to services offered by the network operator or service provider. The subscriber can make outgoing calls to these numbers, but can not update them. Use this service to make changes to these numbers on the subscriber’s mobile phone. (Note that, to make these changes on a whole range of cards at once, you would use the Import/Export destination list capability.)

Fields Field

Description

Record

A number that identifies the record on the card

Alpha Identifier

The name of the service associated with the number. (Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.)

Phone Number

The phone number to access the offered service

TON

The Type Of Number

NPI

The Number Plan Identification that ensures compatibility with other numbering plans

45

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Field

Description

EXT1

The two-digit hexadecimal value of the record number in the Extension where this phone number will be stored. Use this only if there is no more room in the SDN list for extra records. If you are updating a record in the main SDN list, leave EXT1 as FF.

CCI

The two-digit hexadecimal value of the record number in the Capacity/Configuration parameters that contains the prefix for the phone number, if one is to be used. If no prefix is to be used, leave this field as FF.

After entering all the information for a number, click Add. If necessary, you can add or change several SDN records in the same service request (for the same mobile phone).

46

Submitting a Service Request

Update SMSP

Description Short Message Service Parameters (SMSP) define the default transport parameters used to send SMS Mobile Originating messages. Use this service to change any of the parameter values.

Fields Field

Description

Record

A number that identifies the record on the card

Alpha Identifier

The name of the parameter identifier. (Note that if you enter a name that is longer than the space available on the SIM card, it will be truncated.)

Protocol Identifier

The protocol used; for example, SME-to-SME protocol

Service Center Address TON

The number of the SMSC The SMSC Type Of Number

NPI

The SMSC Number Plan Identification that ensures compatibility with other numbering plans

47

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Field

Description

Destination Address TON NPI

The number of the destination OTA platform The Type Of Number The Number Plan Identification that ensures compatibility with other numbering plans

Data Coding Scheme

The coding format of the SMS messages; for example, 7 bits

Validity Period

The number of time increments that the message remains valid. The length of the time increment depends on the number entered (N), as follows: 0 to 143: Period = (N+1) x 5 minutes 144 to 167: Period = 12 hours + ((N-143) x 30 minutes) 168 to 196: Period = (N-166) x 1 day 197 to 255: Period = (N-192) x 1 week

After entering all the information for a number, click Add. If necessary, you can add or change several SMSP records in the same service request (for the same mobile phone).

48

Submitting a Service Request

Update SPN

Description When the mobile phone is in idle mode, it displays the GSM network that the phone is registered with and also, optionally, the Service Provider Name (SPN). Use this service to select whether or not the SPN is displayed and to change its text.

Fields Field

Description

Display required

Select this check box if the SPN should be displayed, or deselect it if the SPN should not be displayed. That is, deselecting this check box will switch off the SPN display - in this case, it does not matter what is entered in the Registered Provider Name box.

Registered Provider Name

The name that will be displayed (if the Display required box is checked)

49

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update SST

(Not all services are shown here) Caution: This is a powerful service that could render the subscriber’s phone unusable if you make the wrong entries. When you first access this page, all standard card services are unchecked - if you submit the request like this, all services will be deallocated and deactivated on the SIM card.

Description The SIM Service Table (SST) on the card controls which standard card services are allocated and, if so, whether or not they are activated. A service must be both allocated and activated on the SIM card before it can be used. Use this service to change the SST settings. Note that all card services are reset according to the selections you make on this page, so do not leave unchecked any services you want to be allocated and activated.

Fields

50

Field

Description

Service

The name of the card service. This can not be modified.

Allocated

Select this check box to allocate the service, or clear it to deallocate the service

Activated

Select this check box to activate the service, or clear it to deactivate the service

Submitting a Service Request

Update STK Applet

Description With this service you can update the configuration of an STK applet that already exists on the destination SIM card(s). You do this by downloading a new version of one of the applet’s configuration files. 1. Select an applet in the left-hand list. On the right, you see a list of the configuration files that belong to this applet. 2. In the right-hand list, select the configuration file to be updated. The name of the file to update appears in the bottom field.

Restrictions This service is available only for STK cards such as GemXplore98 and U-Choose.

51

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Update STK Service

Description With this service you can update the configuration of an STK service that already exists on the destination SIM card(s). You do this by downloading a new version of one of the STK service’s configuration files. 1. Select an applet in the left-hand list. On the right, you see the STK services that belong to this applet, and for each STK service you see the configuration files that it contains. 2. In the right-hand list, select the configuration file to be updated. The name of the file to update appears in the bottom field.

Restrictions This service is available only for STK cards such as GemXplore98 and U-Choose.

52

Submitting a Service Request

Update URS

Description The User Report String (URS) function controls the storage of text strings that are displayed on the mobile phone after a card script has been executed. The purpose of this text file is to reduce the size of the application message that must be downloaded to the phone. Use this service to make changes to the report strings.

Fields Field

Description

Record

A number that identifies the record on the card

Report

The user report string, which is a text message. The maximum length of this text depends on the DCS used. (Note that if you enter text that is longer than the space available on the SIM card, it will be truncated.)

After entering all the information for a number, click Add. If necessary, you can add or change several URS records in the same service request (for the same mobile phone).

Restrictions This service is available only for some STK cards, for example GemXplore98 cards (but not U-Choose cards).

53

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

54

3 Monitoring Service Requests

After you have submitted a service request, as described in the previous chapter, you can monitor its progress to check whether it has successfully completed or not. GemXplore Suite allows you to check on all requests that you have submitted, or on a subset of requests that you have filtered in order to check on a particular type of request. As a final check, GemXplore Suite also lets you view the contents of any SIM card to check that, for example, a particular applet has been successfully downloaded. This option is described in “Checking the Card Content” in this chapter.

The Stages in a Request Submission A request, once it has been submitted, normally goes through the following three stages in its life cycle: •

Created: It has been sent by clicking Submit request in the Request submission window, and it is in a queue waiting to be processed by GemXplore Suite.

•

In Process: GemXplore Suite is treating the request, or has treated the request and has sent it to the SMSC to be sent on to the subscriber’s mobile and is now waiting for a reply from the SMSC.

•

Succeeded or Failed: A message has come back from the SMSC showing that the request has either succeeded or failed.

Created CCI

Queue

GXS SMSC

In Process Succeeded or Failed Database

Acknowledged or purged (or no acknowledgement required)

Figure 10 - Request Life Cycle

55

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

In addition, some other states are possible: •

Deleted: The request was stopped by the Customer Care Agent before it could be processed.

•

Suppressed: The administrator has stopped the request after it was sent out from GemXplore Suite, but before it was sent on from the SMSC to the mobile phone.

•

Expired: The request failed because the Validity Date limit was reached before it could be completed.

Searching For Requests To check up on service requests, follow these steps: 1. Log in to the CCI if you have not already done so (see “Logging In” in the previous chapter) and click Request management in the Customer Care Interface Welcome window. Or click Request at the top of any other window in the CCI. 2. Click Request -> Request monitoring in the left frame of the screen, to display the Criteria setting window.

Figure 11 - Criteria Setting Window

56

Monitoring Service Requests

In this window, you can define exactly what types of request you want to check. If you want to check all requests that you have submitted, simply click View at the bottom of the window without entering anything else. Otherwise, fill in the parts of the window as follows to narrow down your search. 3. Filtering criteria: Select one or more of the life-cycle states to see only requests currently in those states. On-going includes both Created and In process. Processed includes all those requests that have been received back from the SMSC or that have been deleted. Leaving all check boxes empty is the same as selecting them all - all requests are included. 4. Sorting criteria: You can choose the order in which requests are to be listed. If you want them to be listed according to the Destination cards, for example, select Destination in the Available list and then click >>> . It moves to the Selected list. If you leave the Selected list empty, the requests are listed by submission date and time. If the Ascending check box was selected, Destination appears with ^ in front of it. This means the requests will be sorted in ascending alphabetic or numeric order. If you want them sorted in descending order instead, click the Descending check box before selecting Destination. After choosing the first sorting field, you can select a secondary sorting field by moving it to the Selected list in the same way. Then, within each group of requests submitted to the same destination, the secondary field will be used for sorting. Whichever field you select first remains at the top of the Selected list as the primary sorting field. To change the order of sorting fields or to make other changes, select a field in the Selected list and click scenario. The Scenario list window is displayed:

Figure 17 - Scenario List Window

Creating a Campaign Scenario A campaign scenario contains a set of value added services to be applied to a set of cards specified in a sheduled campaign. To create a campaign scenario: 1. On the Scenario list window, click Create. The Create a new scenario window is displayed.

Figure 18 - Campaign Scenario Create Window

68

Managing Campaigns

2. In the window, enter values for parameters shown in the following table and click Validate. Parameter Name

Description

Label

A unique identifier for the campaign scenario (up to 40 unicode characters)

3. Click Add service. The Service list window is displayed:

Figure 19 - Service List Window Note: Free text can be entered for billing information. However, text entered cannot contain a comma or a new line character. 4. On the Service list window, click the down arrow, select the service to be added, enter billing information in the Billing information field, then click Add service. 5. Repeat the previous step to add other services.

Viewing and Updating a Campaign Scenario To view information about a campaign scenario: 1. On the Scenario list window, select the scenario and click View. The Scenario view window is displayed:

Figure 20 - Campaign Scenario Desciption Window 2. Click Back when you want to return to the Scenario list window.

69

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

To update a campaign scenario: 1. On the Scenario list window, select the scenario and click Update. The Update a Scenario window is displayed. On this window you can add, update, view details of, or delete a service.:

Figure 21 - Campaign Scenario Update Window 2. The window, displays the vlaues shown in the following table: Parameter Name

Description

Identifier

Unique identifier generated by the platform. This cannot be changed.

Label

A unique identifier for the campaign scenario (up to 40 unicode characters). This cannot be changed.

Service list

Lists all the services in the scenario.

3. To add, update, view details of, or delete a service, do the following: Adding a service a) To add a service, click Add Service. b) On the Service list window click the down arrow and select a service from the drop-down list. c) Enter billing information in the Billing information field. d) Click Add service. On the window that appears, enter the required information. This window changes depending on the service you select (for a description of the services and the fields on the service windows, see “Submitting a Request”) e) When you have finished, click Add service. f)

Repeat steps a) through e) for other services as required.

g) On the Campaign scenario update window, click Validate to accept the updates to the scenario. Viewing details of a service a) To view the details of a service, select the service and click View service.

70

Managing Campaigns

Updating a service a) To update a service, select the service and click Update service. b) To add a record to the service, enter the required information and click Add (for a description of the services and the fields on the service windows, see “Submitting a Request”) c) To delete a record, select the record in the list and click Delete. d) When you are finished, click Update service. e) Repeat steps a) through d) for other services as required. f)

On the Campaign scenario update windw, click Validate to accept the updates to the scenario.

Deleting a service from a campaign: a) To delete a service, select the service and click Delete. b) On the Delete Prompt window, click OK to confirm the delete.

Deleting Campaign Scenarios To delete a campaign scenario: 1. On the Scenario list window, select the service and click Delete. 2. On the Delete Prompt window, click OK to confirm the delete.

Scheduling a Campaign The following describes how to schedule a capaign. A campaign can be scheduled in either push or on event mode. In push mode, the campaign is scheduled with time inputs, each unitary task following daily time constraints. In on event mode, the campaign is active at a specified beginning date, but the execution of each unitary task for a card is triggered only on reception of an external event. To create a new campaign: 1. Do either of the following: –

On the GemXplore Suite Welcome window, click Request management

–

Click Request on any other GemXplore Suite management interface window.

71

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

2. On the left frame of the Request management window, select Campaign -> Campaign scheduling. The Create a new campaign window is displayed:

Figure 22 - Campaign Definition Screen 3. In the window, enter values for parameters shown in the following table:

72

Parameter Name

Description

Label

A unique identifier for the campaign scenario (up to 40 unicode characters).

Mode

The mode type. Valid values: • Push; the campaign is scheduled with time inputs, each unitary task following daily time constraints. • On event; the campaign is active at the beginning date, but the execution of each scenario for a card is triggered only on reception of an external event.

Scenario

The name of the scenario. Click the down arrow and select a scenario from the list.

Transaction ID

A free text label used to identify the campaign as belonging to a group of campaigns that all have the same label.

Beginning date

The date and time at which the campaign is scheduled to start. Click the calendar button. On the pop-up calendar window, click the down arrows to select the time (HHMMSS), then select the start date.

Managing Campaigns

Parameter Name

Description

Ending date

The date and time at which the campaign is scheduled to end. Click the calendar button. On the pop-up calendar window, click the down arrows to select the time (HHMMSS), then select the end date.

First, Second, and Third frame

The daily time frames. Valid for push mode only. Click on the time buttons. On the time window, click on the arrows to set the from and to times for each time frame.

Priority level

The priority level. Valid values 1 to 100 (highest priority). The priority is used between campaigns. An on event campaign considered to have a priority of 100. The default priority is 50.

Validity period / service

The unitary task validity period in seconds (86400 (24 hours) maximum). The default value is 600 seconds (10 minutes)

Maximum number of retries

The maximum number of retries. 0 specifies no retry (normal attempt only). There is no limit (except for integer coding).

Retry delay

The task retry delay in seconds (604, 800 (7 days) maximum). The default value is 3600 (1 hour),

To specify the SMSC 1. Click on the SMSC tab. The SMSC definition window is displayed:

Figure 23 - SMSC Configuration Screen 2. In the window, enter values for parameters shown in the following table: Parameter Name

Description

Channel ID

The channel identifier. Click the down arrow and select a driver from the list.

SMSC mode

The SMSC mode. Valid values: • MT • TRANS • SMSC The default is the platform default value.

73

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Parameter Name

Description

SMSC CRPC

The SMSC CRPC. Valid values: • True • False • Channel default The default is the channel default.

Tariff class

Free text value (20 characters maximum) to be used in SMSC billing tickets. The default is no tariff class.

Tariff Class Service Description Free text value (20 characters maximum) to be used in SMSC billing tickets. The default is no tariff class service description.

To specify the targeted cards: 1. Click on the Destinations tab. The Targeted cards window is displayed:

Figure 24 - Targeted Cards Window 2. Perform either of the following procedures: –

“Using a query”

–

“Selecting a card file”

–

“Selecting a campaign and specifying the ending status to be considered”

Using a query a) On the Targeted cards window, click the Enter a query radio button b) Click the down arrow and select a value from the drop-down list.

74

Managing Campaigns

c) Click the down arrow and select a comparison operator: equals (=), is not equal to (!=), is less than () d) In the next field, enter the search criteria, for example, if you selected serial number in the first field and > in the second field, enter 2000 to specify all cards from serial number 2000 upwards e) Click Add expression to copy the expression to the Expression searched area. f)

Repeat the previous steps to add more expressions if required..

Note: To remove a line in the query, select it and click Remove. To modify a line in the query, select it, click Modify, make changes to it on the Expression formulation line, then click Add expression. It replaces the original line in the query To change the AND/OR operator for a line, select the line, select, click the down arrow and select the operator, and click Add. g) Click Import at the bottom of the window to run the search and return to the Create a new campaign window. h) On the Create a new campaign window, click Create. Selecting a card file a) On the Targeted cards window, click the Select a card file radio button. b) Enter the path, directory, and the name of the card file in the field or click Browse and select the card file to be imported. c) Click Import at the bottom of the window to import the card file and return to the Create a new campaign window. d) On the Create a new campaign window, click Create. Selecting a campaign and specifying the ending status to be considered a) On the Targeted cards window, click the Select a campaign and specify the ending status to be considered radio button. b) Click on the down arrow and select the campaign from the drop-down list. c) Click on the down arrow and select the executing status from the drop-down list d) Click Import at the bottom of the window to import campaign and return to the Create a new campaign window. e) On the Create a new campaign window, click Create.

Monitoring Campaigns The following describes how to monitor campaigns. You can display the details and execution statistics for individual campaigns.

The Campaign Monitor Window The Campaign monitor window displays all the campaigns and their status. To display the Campaign monitor window: 1. Do either of the following:

75

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

–

On the GemXplore Suite Welcome window, click Request management

–

Click Request on any other GemXplore Suite management interface window. On this window you can also refresh, acknowledge, pause, restart, abort, and purge a camapaign (.

2. On the left frame of the Request management window, select Campaign -> Campaign monitoring. The Campaign monitor window is displayed. .

76

Managing Campaigns

Figure 25 - Campaign Monitor Window

Displaying the Details of a Campaign To display the details of a campaign: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click on the icon. The Campaign details window is displayed:

Figure 26 - Campaign Details Window The Campaign details window displays the status of the campaign and provides the following information Parameter Name

Description

Identifier

The unique identifier generated by the platform.

Label

The unique identifier for the campaign scenario.

Mode

The mode type. Valid values: Push; the campaign is scheduled with time inputs, each unitary task following daily time constraints. On event; the campaign is active at the beginning date, but the execution of each scenario for a card is triggered only on reception of an external event.

Scenario

The name of the scenario.

77

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Parameter Name

Description

Beginning date

The date and time at which the campaign is scheduled to start.

Ending date

The date and time at which the campaign is scheduled to end.

First, Second, and Third frame

The daily time frames. Valid for push mode only.

Priority level

The priority level. Valid values 1 to 100 (highest priority). The priority is used between campaigns. An on event campaign considered to have a priority of 100. The default priority is 50.

Validity period / service

The unitary task validity period in seconds (86400 (24 hours) maximum). The default value is 600 seconds (10 minutes)

Maximum number of retries

The maximum number of retries. 0 specifies no retry (normal attempt only). There is no limit (except for integer coding).

Retry delay

The task retry delay in seconds (604, 800 (7 days) maximum). The default value is 3600 (1 hour),

To display the SMSC details: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click on the icon. The Campaign details window is displayed. 2. On the Campaign details window, click the SMSC tab. The SMSC definition window is displayed:

Figure 27 - SMSC Definition Window

78

Managing Campaigns

The SMSC definition window provides the following information: Parameter Name

Description

Channel ID

The channel identifier.

SMSC mode

The SMSC mode. Valid values: • MT • TRANS • SMSC

SMSC CRPC

The SMSC CRPC. Valid values: • True • False • Channel default

Tariff class

Free text value used in SMSC billing tickets.

Tariff Class Service Description Free text value used in SMSC billing tickets.

To display campaign statistics: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click on the icon. The Campaign details window is displayed. 2. On the Campaign details window, click the Statistics tab. The Campaign statistics window is displayed:

Figure 28 - Campaign Statistics Window The window displays the following statistics: •

number of cards addressed by the platform

•

number of cards for which execution has not begun

•

number of cards for which execution has or has not been successful

•

number of cards for which execution is currently running

•

number of cards not found by the platform

79

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Pausing a Campaign You can pause a campaign at any time. If you pause a campaign, unitary tasks not yet executed will not be started. However, the results of unitary tasks that have been started are still taken into account. To pause a campaign: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click Pause. 2. On the Pause Prompt window, click OK to confirm the pause.

Restarting a Campaign You can restart a campaign that has been paused. If you restart a campaign, unitary tasks not yet executed are re-started. To restart a campaign: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click Restart. 2. On the Retart Prompt window, click OK to confirm the restart.

Aborting a Campaign You can abort a campaign at any time. If you abort a campaign, unitary tasks not yet executed will not be started. However, unitary task results are still taken into account and the campaign is aborted once all unitary task results are received. To abort a campaign: 1. On the Campaign monitor window, click the radio button at the left of the campaign and click Abort. 2. On the Abort Prompt window, click OK to confirm the abort. The status on the Campaign monitor window changes to Aborted.

Purging a Campaign If a campaign has completed and is no longer required, you can purge it from the database. To purge a campaign: 1. On the Campaign monitor window, click the radio button at the left of the camapign and click Purge. 2. On the Purge Prompt window, click OK to confirm the purge. The campaign is purged from the database.

80

5 Setting Up a Subscriber Account

When you set up a subscription for a new customer, you supply a SIM card and a new phone number (the MSISDN) to use with it. Most probably, the selected MSISDN has already been physically stored on the SIM card by some other program. What is important in GemXplore Suite is to record this link between the MSISDN and the SIM card, as described in this chapter. The card database in GemXplore Suite already contains a record for the new SIM card. This record is identified by the card identification number (the ICCID), which is normally printed on the card itself. Initially, this card record is not yet assigned to a subscriber. What you now need to do is assign the subscriber’s new MSISDN to this card record.

01 43 78 90 12

Card DB

Card id: 01 43577 A234002 MSISDN:

Figure 29 - Assigning a Subscriber’s MSISDN to a Card Record At the same time, you also have the option of giving the subscriber internet access to perform certain services on his/her own mobile phone, such as downloading logos. If you do this, GemXplore Suite creates a record in the Framework database that contains all the subscriber’s internet account details, and links this to the card record in the card database. Framework DB

01 43 78 90 12

Card DB

The MSISDN is the link

Subscriber internet accounts

Cards

Figure 30 - Creating a Subscriber Internet Account

81

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

This chapter shows you how to record the subscriber’s MSISDN, with the option of giving the subscriber internet access. At any time after following this procedure, you can change the MSISDN on the SIM card using the Update MSISDN service as described in “Chapter 2 - Submitting a Service Request”. This change is automatically reflected in the GemXplore Suite card database, but not in the Framework database, so you must then update the subscriber’s record as described in “Modifying or Deleting a Subscriber Account”. Note: If the SIM card does not initially have the subscriber’s MSISDN stored on it, it is possible to put this data on the card through GemXplore Suite using the Update MSISDN service. You must use a WIR for this (over-the-air is not possible), and should do it after following the procedure in this chapter to record the link between the MSISDN and the SIM card.

Creating a New Subscriber Account With Internet Access This procedure assumes that you know at least two things: the subscriber’s MSISDN (phone number) and the subscriber’s SIM card identifier. 1. Log in to the CCI if you have not already done so (see “Logging In” in chapter 1) and click User management in the Customer Care Interface Welcome window. Or click User at the top of any other window in the CCI. 2. Click Account in the left frame of the screen, to display the search window and users list.

Figure 31 - User Search 3. Click one of the two buttons at the bottom of the window. For the option Create a subscriber without web access, skip to “Creating a New Subscriber Record Without Internet Access”.

82

Setting Up a Subscriber Account

For the option Create a subscriber with web access, continue below.

Figure 32 - Create Account With Web Access 4. Fill in this window with the subscriber’s details and access information, as explained in the following table. Field

Description

Profile

Select a profile to define which services will be available to this subscriber via the internet account. This depends on how the profiles have been set up your GemXplore Suite administrator can give you information on what services are offered by each profile.

MSISDN

The MSISDN, which is the subscriber’s mobile phone number. Up to 20 digits long, including spaces.

Full name

The subscriber’s name. The name may be up to 20 characters long, including spaces.

Subscriber reference (optional)

This is normally used to link this subscriber record with the subscriber record in another program

Card identification

The ICCID, which is the number normally printed on the card that uniquely identifies the card. This number must already exist in the Card Manager database; if not, you will see the error message “Invalid SIM Card”. In this case, inform your administrator.

Table 6 - Subscriber Account Details

83

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Field

Description

Expiration date (optional)

Click “No expiration date” if there is no limit to internet access for this account. If you want internet access to be disabled for this subscriber on a certain date (at the start of this day), clear the box “No expiration date”, click the calendar icon, and select a date.

Authentication protocol

There are two ways of controlling access to the subscriber’s internet account. You must select one of these: Password: On creation of this account, the password entered in the following field is sent to the subscriber’s mobile phone. This is the subscriber’s permanent password. Mobile challenge: No permanent password is held. Each time the subscriber logs on to the internet, a temporary password is created at random and sent to the subscriber’s mobile phone for use during that session only.

Authentication data

Valid only if Password was selected as the protocol. Enter the subscriber’s password and then enter it again in the Confirm field. The password is not displayed on the screen. A password must contain at least 6 characters, including at least 2 numbers (for example: John78, a2hgy64f, 9472381). It can include spaces, and can be up to 20 characters long.

Account status

Normally enabled. To disable this subscriber’s internet account (regardless of any Expiration date set), click Disabled. Any change is effective immediately. Note that if the account has expired, this field can be used to enable it again.

Table 6 - Subscriber Account Details (continued) 5. Click Create to create the account. Subscriber access to the account is effective immediately (unless the Account status field was set to Disabled).

Creating a New Subscriber Record Without Internet Access Note that if you create a subscriber record without access to an internet account, you can not later create an internet account for that subscriber. 1. Click User at the top of any window in the CCI. 2. Click Account in the left frame of the screen to display the search window and users list, as shown in “Figure 31 - User Search”. 3. Click the button labeled Create a subscriber without web access.

84

Setting Up a Subscriber Account

Figure 33 - Create Account Without Web Access 4. Fill in this window with the subscriber’s card details as explained in the following table. Field

Description

MSISDN

The subscriber’s mobile phone number

Card identification

The ICCID number (normally printed on the card) that uniquely identifies that card.

Table 7 - Subscriber Card Details 5. Click Create to create the account.

Modifying or Deleting a Subscriber Account You can modify the account details of any subscriber at any time as follows: 1. Click User at the top of any window in the CCI. 2. Click Account in the left frame of the screen, to display the search window shown in “Figure 31 - User Search”. 3. Enter the subscriber’s MSISDN (phone number) in the User identifier field and click Find. The subscriber record appears in the lower window (Users list). 4. Select the subscriber record in the Users list and click Update... . Or click View... to simply view the details without being able to modify them. Or click Delete to delete this subscriber record. 5. Make any modifications in the Update user window and then click Update to save them.

Importing a List of Subscribers If you have a great many subscribers to set up in GemXplore Suite, these can be created in an XML file using a text editor or some other program and then imported into GemXplore Suite as follows: 1. In the User Management area of GemXplore Suite, click Subscriber import in the left frame of the screen.

85

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Figure 34 - Subscriber Import Window 2. Click Browse. Locate the XML file and click Open. 3. Click Import. You now see a table listing the subscriber details (MSISDN and card ICCID) imported from the file. Only lines marked SUCCEEDED were accepted - the others were rejected for the reason given and the records and accounts were not created. Remember that each record must contain an ICCID that already exists in the database but that does not have an MSISDN defined. The required format of the XML file is shown by the following example. The SUBSCRIBER id is the MSISDN and the cardId is the ICCID. The creatorId is the name of the person who created the file. The other fields are as shown in “Figure 32 - Create Account With Web Access”. Note that this example shows three subscriber records, the first two with internet access and the third one without.

86

A Installing the WIR program

To prepare a Wired Internet Reader (WIR) to work with GemXplore Suite, you need to do two things: 1. Install the WIR on your terminal using the installation software that came with it, if this is not already done. This procedure depends on the WIR model and is not described here. Refer to the documentation that came with the WIR. 2. Install the GemXplore Suite WIR applet as described in this appendix. For your WIR to work with GemXplore Suite, your PC needs to be using one of these operating systems: Windows 95/98, Windows NT 4.0 Workstation, Windows 2000.

Running the Installation The installation of the WIR applet is a simple process that is done remotely over the intranet or internet. Follow these steps: 1. Open a Web browser and enter one of the following URLs, as appropriate: If you are accessing GemXplore Suite on an intranet: http://:/wirinstall If you are using an SSL connection on the internet: https:///wirinstall Ask your administrator for the specific entries for , and if you do not know them. They are the same as you use to access the CCI.

87

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Once you have connected to GemXplore Suite, you see the following window:

Figure 35 - WIR Environment Install Window You will probably also see the following dialog box superimposed over the initial window. If you don’t see it, skip to step 6, as it means you already have the Java runtime environment installed on your PC.

Figure 36 - Java Plug-in Download 2. If you see this dialog box, you first need to download the Java runtime environment (JRE) version 1.3.1. This is required before you can install and run the WIR applet. Click Yes. 3. You are asked to specify the language, region, and nearest download location. After selecting these, click Install. 4. Click Yes to the licence agreement. 5. Select a location for the JRE and click Next. The JRE requires about 17 MB of disk space. Once the JRE has finished installing, you are returned to the WIR environment install window 6. Click the link Click here to install the WIR environment.

88

Installing the WIR program

You see a similar window:

Figure 37 - WIR Applet Install Window 7. Click the link.

Figure 38 - File Download 8. In the File Download dialog box, select Run this program from its current location and click OK.

89

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

Figure 39 - Security Warning 9. In the Security Warning dialog box, click Yes.

Figure 40 - Specifying the JRE Path 10. If necessary, browse to specify the location where the JRE was installed, and then click Install.

90

Installing the WIR program

When installation of the WIR applet is complete, you should see the following window:

Figure 41 - Successful Installation 11. Click Done. You can now close the browser.

91

GemXplore Suite V1.3.1 Customer Care Agent’s Guide Service Pack 2 Edition

92