Ozeki Message Server 6 Product Guide. Copyright, Ozeki Informatics Ltd. Number of pages: 185

Transcription

1 Copyright, Ozeki Informatics Ltd. Number of pages: 185

2 Table of contents TABLE OF CONTENTS 1 INTRODUCTION 4 Terms of use 5 Summary of changes 6 About Ozeki Message Server 6 7 Package contents 8 Ozeki Message Server 9 Ozeki Message Server Monitor 10 Ozeki Message Server Manager 11 OZEKI Excel SMS Client 12 Outlook SMS Plugin 13 Ozeki SMS Client 13 SMS TECHNOLOGY 15 The SMS network entities 15 SMS Network Architecture and Internal Protocols 17 SMS message types 18 SMS messaging with a mobile phone attached to the PC 20 Connect your phone to the PC with an RS232 serial cable 21 Connect your phone to the PC with an USB data cable 22 Connect your phone to the PC with Infrared (IR) 23 Connect your phone to the PC with Bluetooth (BT) 24 IP SMS technology 25 Common protocols - UCP/EMI 26 Common protocols - SMPP 27 Common protocols - CIMD2 29 Common protocols - Colour SMS 29 Common protocols - Premium rated SMS services 30 VPN configuration on Windows Service Provider Information 32 PRODUCT FEATURES 33 Ozeki Message Server in the Office 33 Basic features 34 Multi-user architecture 36 Addressbook 37 How IT Professionals Use the Software 38 The envelope system 38 Link and message management 39 Message routing 39 INSTALLATION / ADMINISTRATION GUIDE 43 2/185

3 Installing the server 43 Hardware and software requirements 43 Installation steps 44 Product activation 52 Server Configuration - Server Preferences 54 Driver Installation 57 How to turn on the SMPP communiction logging 71 Plugins 77 System maintenance 79 Keep the system healthy by deleting old messages 79 Ozeki Performance Monitor 79 Manual uninstallation 79 DEVELOPERS GUIDE 81 General information 81 Autoresponding SMS applications 81 Application Mode 82 Programming APIs and languages 84 SMS API for C++ Developers 84 SMS API for Database developers (SQL) 85 SMS API for Webdevelopers (HTTP) 101 SMS API for JAVA developers 111 SMS API for PHP developers 113 SMS API for ASP developers 116 SMS API for Delphi developers 117 SMS API for Microsoft Access developers 120 APPENDIX 134 Appendix "A1" - Message types - OTA bitmap 135 Appendix "A2" - Message types - Operator logo XML 136 Appendix "A3" - Message types - Operator logo 138 Appendix "A4" - Message types - Ringtone 140 Appendix "A5" - Message types - Wap push 143 Appendix "B" - GSM service providers 145 Appendix "C" - SMS service center addresses 155 Appendix "D" - GSM operator and country codes for operator Logos 160 Appendix "E" - The 7 bit default alphabet of GSM phones 167 Appendix "F" - GSM error codes 173 Appendix "G" - Database plugin connection strings 175 Appendix "H" - References 185 3/185

4 Introduction Organizations today are facing several unique communication challenges: the proliferation of electronic messages across their enterprise; the need to provide employees, customers, and partners with consistent information; the desire to better equip information workers with meaningful information to drive informed decisions; and the mandate to control costs without sacrificing application availability, security, or reliability. The latest release of Ozeki Message Server is designed to help enterprises address these challenges. Ozeki Message Server 6 will help in maximizing the productivity of IT by reducing the complexity of creating, deploying, and managing communication applications. It empowers developers through a rich, flexible, modern development environment for creating secure, high performance communication applications. Various types of messages (SMS text messages, binary data messages, etc...) can be sent from multiple platforms, applications, and devices to make it easier to connect internal and external systems. Deliver robust, integrated business intelligence solutions that help drive informed business decisions and increase productivity across your entire organization. Control costs without sacrificing performance, availability, or scalability. Read on to learn more about the advancements Ozeki Message Server will deliver in three key areas: enterprise messaging, developer productivity, and cost control. About this document This document describes the Ozeki Message Server software. It gives an overview of the functionality, describes the user interface and provides all the information necessary for configuration. The document is intended for operator personnel involved in the installation, configuration and daily operations of the Ozeki Message Server Software. It provides useful information for application developers as well. 4/185

5 Terms of use The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. This document is intended for the use of Ozeki's customers only for the purposes of the agreement under which the document is submitted, and no part of it may be reproduced or transmitted in any form or means without the prior written permission of Ozeki. The document has been prepared to be used by professional and properly trained personnel, and the customer assumes full responsibility when using it. Ozeki welcomes customer comments as part of the process of continuous development and improvement of the documentation. The information or statements given in this document concerning the suitability, capacity, or performance of the mentioned hardware or software products cannot be considered binding but shall be defined in the agreement made between Ozeki and the customer. However, Ozeki has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Ozeki will, if necessary, explain issues which may not be covered by the document. Ozeki's liability for any errors in the document is limited to the documentary correction of errors. OZEKI WILL NOT BE RESPONSIBLE IN ANY EVENT FOR ERRORS IN THIS DOCUMENT OR FOR ANY DAMAGES, INCIDENTAL OR CONSEQUENTIAL (INCLUDING MONETARY LOSSES), that might arise from the use of this document or the information in it. This document and the product it describes are considered protected by copyright according to the applicable laws. Ozeki logo is a registered trademark of Ozeki Informatics Ltd. Other product names mentioned in this document may be trademarks of their respective companies, and they are mentioned for identification purposes only. Copyright Ozeki Informatics Ltd All rights reserved. Ozeki Informatics Ltd. 5/185

6 Summary of changes The document is automatically updated on a daily bases, based on content available on the website. 6/185

7 About Ozeki Message Server 6 Ozeki Message Server 6 - SMS Server is a powerful, flexible SMS Gateway application, that enables you to send/receive SMS messages to mobile devices with your computer. It has an easy to use user interface, and an excellent internal architecture. The application can use a GSM mobile phone attached to the PC with a phone-to-pc data cable or IP SMS technology to transmit and receive the messages. Ozeki Message Server works on Microsoft Windows XP,2000,2003 operating systems. Office users Office users can use Microsoft Outlook, Microsoft Outlook Express and Microsoft Excel to send hundreds of messages to their clients. The messages and the phone numbers are stored in Excel files and an Excel Macro initiates the sending process. (The excel macro is included in the software package.) Software developers Software developers can integrate SMS messaging functionality into their a pplications very easily. For example if a message needs to be sent, it could be placed into a database table. The Ozeki Message Server monitors this table and delivers the message. The Message Server puts all received SMS in an incoming database table. Of course many other APIs are availble in the software to support software development. 7/185

8 Package contents If you purchase Ozeki Message Server, you can download a package that contains the following installation files: If you click on OzekiMessageServer.exe, you can install the software just like you would install any other Windows application. The installation will create a new folder in C:\Program Files that will contain the following components. Ozeki Message Server Ozeki Message Server Monitor Ozeki Message Server Manager Excel SMS Client Outlook SMS Client Ozeki SMS Client Product documentation The main message engine. This program operates GSM phones or IP SMS connections. It handles message queues and users. It runs as a system service in the background. It contains a built in HTTP server that is used by clients. This application monitors the activity of the main message engine and displays a status icon in the windows taskbar. This Ozeki Message Server Manager can be used to configure and manage the main message engine. It has an easy to use graphical user interface (GUI), that can be used to access the message folders (queues) and to modify user and server preferences. An.xls file, that can be opened with Microsoft Excel to send SMS messages from Excel spreadsheetes. This file contains the Excel Macro that is used for this purpose. An application that can be installed on client computers to make SMS sending from Microsoft Outlook possible. A GUI application for SMS messaging with a user interface similar to popular clients. Detailed documentation in PDF format with examples and case studies. (The list of components may vary depending on your license.) 8/185

9 Ozeki Message Server If you install the Ozeki Message Server a new service will be registered in your system. This service will communicate with the GSM phone attached to your PC or if you use an IP SMS connection it will communicate with your GSM provider through the Internet. To enable you to use the software on a 24 hours a day / 7 days a week basis, the service will run in the background all the time. If you restart your computer it will start automatically. After installation you may check the properties of the new service by starting the Windows Service Manager. To start the Windows service manager click the Start menu and select Control Panel/Administration tools/services menu. (Figure 1) Figure 1 - starting the service manager In the Service Manager you can find an entry called Ozeki Message Server. You may click on this link with the right mouse button to see it's properties. (Figure 2) 9/185

10 Figure 2 - Service properties Ozeki Message Server Monitor The Ozeki Message Server Monitor provides information about the status of the Message Engine. It is a taskbar icon (Figure 1.) application. If the message engine works properly, the taskbar icon signals green if the message engine stops it turns into red. After installation the Message Server Monitor is started by default. To start it manually you should click on the "Message Server Monitor" icon on your desktop. Figure 1 - taskbar icon If you click on this icon with the right mouse button, you can open a menu, that provides options for starting/stopping and configuration of the server. To perform the configuration you must start the Message server manager by clicking on the Manage Service menu item (Figure 2 ). 10/185

11 Figure 2 - Starting the message server manager. Ozeki Message Server Manager The Message Server Manager is the main user interface of the application. It can be used to configure the service, to send/receive messages, to maintain the addressbook and to get information from the server real time. It can be used a management console to manage the server remotely over the network. The Message Server Manager can be started from the Start menu or from the Server Monitor Taskbar icon. After startup the Ozeki Message Server Manager requires a login name and a password. The default user name and password is: admin / abc123. (Note: It is important that you change this password after the first login.) On the main form of the Message Server Manager you can perform the necessary configuration and management tasks and you can send and receive SMS messages. 11/185

12 OZEKI Excel SMS Client The Excel SMS client enables you to send SMS messages from Microsoft Excel. To achieve this goal, all you have to do is open two excel spread sheets: Messages.xls and Ozeki.xls. In the Messages.xls spread sheet, you need to fill the telephone numbers into the first column and the messages into the second column. In the Ozeki.xls excel sheet you will find a macro that can be started by clicking on the Send all button. This makro will connect to Ozeki Message Server 6 over the office LAN or over the internet and will send the SMS messages you have edited on the Messages.xls sheet. The parameters for this network connection can be edited on the Ozeki.xls spread sheet (Figure 1). Figure 1 - Creating the excel sheet 12/185

13 Outlook SMS Plugin The Outlook SMS Client plugin creates a button in Microsoft Outlook. If the button is pressed a message composer window is opened. In this window the SMS message can be created and by clicking on the send button it is sent over the network to the Ozeki Message Server engine for delivery. The sent messages are saved in the sent items folder of Outlook. If an incoming message arrives it is saved in he inbox folder of Outlook. The user of this Outlook SMS Client can use the addressbook of outlook to look up and select the appropriate phone numbers for delivery. Ozeki SMS Client The Ozeki SMS client is similar to any client, that communicates with a server. It can be used in your office network to enable your colleagues to send and receive SMS messages from their desktop computers using a central server. The Ozeki SMS Client has a very easy to use graphical user interface (Figure 1). 13/185

14 Figure 1 - Ozeki SMS Client The communication protocol used between the Ozeki SMS client and the Ozeki Message Server is HTTP. The client connects to the server periodically to check for new messages and to send the messages that can be found in the outbox. 14/185

15 SMS Technology The SMS technology was created in Europe, by GSM pioneers. The standardization process is lead by the European Telecommunications Standards Institute (ETSI). The SMS technology was created to provide an infrastructure for the transportation of short messages containing a maximum of 140 bytes (8 bit objects) of useful data in mobile telecommunication networks. The transportation is done in the GSM signaling path in traditional GSM networks, and as GPRS packets in GPRS networks. The messages are composed using the PDU specification. An SMS is a binary string, that contains all the necessary information to form the message header needed for transportation and the message body that contains the payload. The basic addressing scheme of SMS messages are mobile telephone numbers called MSISDN. SMS technology fact sheet: Standard: GSM (ETS 03.40) Transport technology: GSM Signaling Path, GPRS Transport protocol: Short Message Protocol Addressing scheme: MSISDN Message description language: SMS PDU User data length: 140 byte (Concatenated messages can exceed this size) Basic character set: 7-bit SMS, 8-bit SMS, UCS2 The SMS network entities SMS messages are created by mobile phones or other devices (e.g.: personal computers). These devices can send and receive SMS messages by communicating with the GSM network. All of these devices have at least one MSISDN number. They are called Short Messaging Entities. To understand their role in the GSM SMS network please take a look at the following figure: 15/185

16 Figure 1. - Short Messaging Entities (SME) in the GSM network The SME-s are the starting points (the source) and the end points (the receiver) for SMS messages. They always communicate with a Short Message Service Center (SMSC) and never communicate directly with each other. An SME can be a Mobile telephone. Depending on the role of the mobile phone in the communication we can talk about two kinds of SMS messages Mobile Originated (MO) messages and Mobile Terminated (MT) messages. MO messages are sent by the mobile phone to the SMSC. Mobile terminated messages are received by the mobile phone. The two messages are encoded differently during transmission. An SME can also be a computer equipped with a messaging software, such as the Ozeki Message Server, that can communicate directly with the SMSC of the service provider. For this communication a mobile phone attached to the PC with a phone-to-pc data cable or a direct IP link can be used. Figure 2 - Ozeki Message Server used with a mobile phone attached to the PC 16/185

17 Figure 3 - Ozeki Message Server used with direct IP connection SMS Network Architecture and Internal Protocols In the SMS network operated by GSM service providers four layers of transport is used (Figure 1.): SM-AL (Application Layer) SM-TL (Transfer Layer) SM-RL (Relay Layer) SM-LL (Lower Layers) Ozeki Message Server is located in the SM-AL layer. When sending an SMS the software creates protocol data units (PDU's) transported by the SM-TL layer. When a GSM phone attached to the PC receives an SMS, the message is also encoded according the SM- TL layer PDU specification. Ozeki Message Server decodes this PDU and makes the message readable for computer programs and computer users. Figure 1. - SMS network layers To understand how the SMS travels from the mobile phone to the SMSC please take a look at Figure 2. On this figure you can see which protocols are used and which GSM network entities take place in the communication process. As you can see, the mobile phone (Mobile station) transmits the SMS message to the GSM base station (BTS) through a wireless link. After this the message goes though the backbone network of the service provider. The Mobile Switching Center (MSC), the Home Location Register (HLR) and optionally the Visitor Location Register (VLR) is used to find out the appropriate Short Message Service Center 17/185

18 (SMSC) that will store and forward the message when the receiving party becomes available. Figure 2. - SMS transportation SMS message types The Short Message Service (SMS) makes it possible to send and receive messages to and from mobile telephones. The messages can contain text or binary data. The text can comprise of words or numbers or an alphanumeric combination. A single short message can contain up to 160 characters when Latin alphabets are used, and 70 characters when non-latin alphabets such as Arabic and Chinese are used. The latest SMS standards released by ETSI provide an extension to send longer text messages in SMS. This technology is called concatenated SMS messages. An SMS message can also carry binary data. A binary SMS message has 140 bytes of used data. This user data can be split into two parts: the user data header and the actual data. The user data header can be used to inform mobile phones about certain message types. This way SMS can be used to carry operator logos, ringtones, telephone settings and WAP push messages. Although the main goal of the SMS technology is to send and receive SMS messages between mobile telephones, it is possible to send and receive messages between a mobile phone and a computer as well. The Ozeki Messages Server was developed to help exploit this possibility. The software can be used to create automated SMS services or it can be used to simply send SMS messages from popular desktop applications such as Microsoft Excel and Microsoft Outlook. Ozeki Message Server currently supports the following message types (Figure 1). SMS:TEXT A text message, that can contain alphanumeric characters, numbers from the default GSM alphabet. The basic message length is 160 characters. If the message length is longer it is sent 18/185

19 SMS:TEXT:GSM7BIT:CLASS0 SMS:TEXT:GSM7BIT:CLASS1 SMS:TEXT:GSM7BIT:CLASS2 SMS:TEXT:GSM7BIT:CLASS3 SMS:TEXT:UCS2 SMS:BINARY SMS:BINARYXML SMS:WAPPUSH:application/vnd.wap.sic SMS:OPLOGO SMS:OPLOGOXML SMS:RINGTONE SMS:CALLERICON SMS:PICTUREMESSAGE SMS:VCARD SMS:VCALENDAR DATACALL using more then one messages. In this case each SMS contains 153 characters. A text SMS message. Often referred to as FLASH SMS messages. It is different from traditional messages, because it is immediately displayed on the screen of the phone and it is not saved in the memory of the phone. A text SMS message. Class1 indicates that the message should be stored on the Device. A text SMS message. Class2 indicates that the message should be stored on the SIM card. A text SMS message. Class3 indicates that the message should be sent to the terminal equipment (TE) attached to the phone. A text SMS message encoded using unicode characters. This message type is used if, arrabic, chinese, or other special characters should be sent. A unicode text message can contain 70 characters. If the message text is longer and concatenated messages are used, 63 unicode characters are sent in one SMS message. A binary SMS message. The maximum message length is 140 octets. A binary SMS message with direct access to the PID, DCS and UDH fields in the SMS PDU. A WAP push message containing a URL link to a WAP or Webpage An operator logo message. An operator logo message with direct access to the country code and operator code in the message. A ringtone message. A callericon message. A picture message. A vcard message. A vcalendar message. A datacall message contains a binary file. This message type is not sent as an SMS. Instead it is sent using a modem data call to another modem. The file is sent using the zmodem protocol. Figure 1 - Messages types 19/185

20 SMS messaging with a mobile phone attached to the PC If you plan to send/receive less then SMS messages per day a good option is to attach a GSM phone or GSM modem to your PC. The GSM phone must be equipped with a SIM card that has good tariff for SMS messages. The GSM phone can be attached with a data cable, with and InfraRed port (IR) or with a BlueTooth (BT) connection. With this setup you can use a computer program such as Ozeki Message Server to send/receive SMS messages. The computer program in this case uses the attached device to communicate with the GSM network. If a message is sent by the application running on the computer it is first sent to the attached GSM phone, and as a second step the GSM phone transmits the messages to the SMSC of the GSM service provider through a wireless link (Figure 1). When a message is received, the GSM phone stores the message in its memory or on the SIM card and sends a notification to the PC. When the program running on the PC receives this notification, it reads the appropriate memory cell and deletes the message from the phone to make room for the next incoming message (Figure 1). Figure 1 - IP SMS connection to send and receive large number of SMS messages. Sending an SMS message using a cell phone takes about 5-6 seconds. Receiving takes about the same time. Good software, such as Ozeki Message Server allows you to attach more then one devices to your PC and to use them simultaneously to increase capacity. The best option to connect a phone to the PC is to use a standard RS232 serial cable. USB cables, InfraRed and BlueTooth connections are not that reliable. You can read more about the connection methods on the following pages 20/185

21 Serial cable connection USB cable connection Infrared (IR) connection Bluetooth (BT) connection Connect your phone to the PC with an RS232 serial cable In order to send or receive SMS messages from your PC, you can attach your phone to the PC with a phone-to-pc data cable (Figure 1). The cable is attached to the serial port of your computer. The serial port is located on the back side and has 9 pins. The name of the serial port in your operating system is COM1 or COM2. Figure 1 - Attaching the device to the PC with a phone-to-pc data cable. If you select from different alternatives, for example (Serial, USB, IR, BT connection), choosing the serial cable is the best option. An RS232 serial data cable is a simple and reliable tool. Industrial GSM modems used in environments, where performance and reliability is crucial are always connected using a RS232 cables. If you wish to build an environment where it is important to operate all the time, we suggest to use an industrial GSM modem (Figure 2): SIEMENS TC35 / SIEMENS MC35 An excellent GSM phone released by Siemens. It can be connected directly to the power supply of the PC. It uses an external antenna, and it has a standard 9 pin RS232 interface. You need a standard RS232 "mouse extender" cable to connect this device to the PC 21/185

22 WAVECOM Wavecom provides very fast and reliable modems for a good price. These modems need an external GSM antenna, an RS232 data cable. Just like the Siemens MC35 they can be connected directly to the power supply of your PC NOKIA 30/ Nokia 32 The Nokia 30 is also an excellent GSM phone. You can read more about in it's installation guide: Nokia_30_UG_en_.pdf Figure 2 - Industrial GSM modems Connect your phone to the PC with an USB data cable In order to send or receive SMS messages from your PC, you can attach your phone to the PC with a phone-to-pc data cable (Figure 1). The cable can be attached to the USB port of your computer. One advantage to using USB connections is that you can attach quite a large number of phones to the same PC with the help of USB hubs available at a low cost. One disadvantage is that you have to install a driver for your cable. Some of the drivers shipped with USB cables have errors and don't allow you to build a reliable system. If you install the driver software shipped with the USB data cable, a new "virtual" serial port will be register in your computer. The name of this serial port will be COM3 or COM4 or some higher number. Figure 1 - USB cable connection 22/185

23 The USB cables available for cell phones are built on a special chip called USB - Serial Bridge. This chip is located inside the cable and is powered by the USB port. When you plug your USB cable into the PC the Windows OS will detect this chip and will ask for the USB driver. Some USB cables can use the power current available in the USB port to charge the battery of the phone. If you purchase a cable with this option you must make sure, that the charging will happen automatically and no special software is required. If you have to install a software for charging there is a high probability that the installed software will lock the serial port and you won't be able to use the cable for SMS messaging and battery charging simultaneously. If you don't have an USB data cable available for your phone, but you can get a standard RS232 data cable, you can still use USB (Figure 2). In this case you should install an USB-Serial converter. The USB-Serial converter can be attached to the PC's USB port and the data cable can be attached to it. In this case the installation procedure will be similar to the procedure you would follow when you would install a standard USB data cable. First you attach the cable to the computer, then you install the driver for the cable. The driver will create the "virtual" com port you can use for SMS messaging. Figure 2 - USB serial converter Connect your phone to the PC with Infrared (IR) You can attach your phone to your PC to send and receive SMS messages through an Infrared connection. Most mobile phones have IR ports and notebook computers are also equipped with it. An Infrared connection is a good option if you want to use Ozeki Message Server for short periods to send and receive messages. IR ports cannot be used to establish long lasting connections between the phone and the PC for two main reasons. Their must be a line of sight between the two communicating parties, which is often broken if one of the devices are moved. The other problem is the way IR connectivity is implemented in GSM phones. Very often the phones switch off their IR port after a certain period (e.g. 10 minutes) automatically. If you are in a situation, where IR is you choice, to use Infrared (IR), you must enable your infrared port on the phone. (Sometimes you have to turn it on in the PC as well). When this is done, you should place the phone within the range of the IR receiver on the PC. When the PC and the phone begin to communicate over IR, you will see an icon in the bottom right hand side of the screen (Figure 1). 23/185

24 Figure 1 - IR connection between the c ell phone and the PC After this icon appears a new "Virtual" serial port is registered into your PC. This serial port will have a standard name e.g.: COM3. When you configure Ozeki Message Server, you should select this newly created COM port. Connect your phone to the PC with Bluetooth (BT) You can attach your phone to your PC to send and receive SMS messages through a Bluetooth (BT) connection. The Bluetooth technology is based on radio signals, so this connection is wireless. One strong advantage to bluetooth over infrared connections is that no line of sight is required. If you have a bluetooth phone within range of your PC, it can be used to send and receive SMS messages. One problem with bluetooth is that several devices can be within range and a quite complicated pairing process is required when you establish the connection. The bluetooth standard provides many services. Among these services there is a bluetooth serial connection service. To use bluetooth on your computer, it must be equipped with a bluetooth antenna. Bluetooth antennas in most cases are connected to the USB port of your PC. When you install the driver of a bluetooth antenna into, it will register "virtual" serial ports called COM3, COM4, COM5, etc. When a bluetooth capable cellphone is attached it can be accessed through one of these virtual serial ports. Figure 1 - Bluetooth connection To sum it up: In order to use the bluetooth connection, a PC must have bluetooth support. This can be achieved with an USB bluetooth antenna and an appropriate driver installation. The mobile phone must be bluetooth capable and the bluetooth link must be activated. Following this the serial connection can be initiated from the PC by opening the appropriate virtual COM port. (Figure 1.) 24/185

25 IP SMS technology If you plan to send or receive a larger number of SMS messages, it is worth to consider using the Internet (Figure 1). Over the Internet (or over a private IP network, such as a leased line), it is possible to connect directly to the GSM operator's SMS Center (SMSC). The SMSC is responsible for receiving, storing and delivering the SMS messages in a GSM telephone network. The benefits of direct connection to this service are great. Figure 1 - IP SMS connection to send and receive large number of SMS messages A large number of messages can be sent or received in a short time. The sender phone number can be freely modified. The availability of the service can be monitored. If you work with great volumes of messages, this solution is cheaper, faster and more reliable than the alternative solution of using a GSM handy connected to a computer. Ozeki Message Server enables you to connect directly to your service provider's SMSC through the Internet or a leased line using TCP/IP. In order to use this option, first you need to sign a contract with your GSM service provider, to get direct access to it's SMSC. If you have a contract you will receive their IP address, a port number and user name and password to access their service. Often they will ask to set up a VPN connection to their service. After a connection is available to the SMSC, an SMS protocol is required to be able to send and receive SMS messages. The most common protocols are UCP, SMPP and CIMD2. (Of course all of these are supported by Ozeki Message Server. In fact you can use more then one of these protocols simultaneously.) You can read more about these protocols on the following pages. Universal Computer Protocol (UCP) Short Message Peer to Peer Protocol (SMPP) Computer Interface Message Distribution version 2 (CIMD2) It is also important to mention, that some service providers use custom 25/185

26 protocols, for example XML over HTTP. If you wish to use Ozeki Message Server with your service provider, and your protocol is not yet included in our program, please contact us. There is a good chance we will add support to your service free of charge. Common protocols - UCP/EMI Ozeki Message Server has built in support for Universal Computer Protocol / External Machine Interface (UCP / EMI). This protocol is often used by GSM service providers for IP SMS connectivity. The currently used protocol versions (v3, v3.5, v4.0) can be used to transfer high volumes of SMS traffic. It is used for both premium rate and normal rate SMS messages. In order to use UCP to connect to an SMSC over the internet or other private TCP/IP network, a contract should be signed with the service provider. The TCP/IP link can be a leased line or the Internet. One advantage to using UCP connections, is that the client is able to specify the sender address of the message. The sender address can be a custom phone number or a short word containing alphanumeric characters. Unfortunately some GSM service providers restrict the use of this option. Another advantage of UCP is that it makes it possible to send every message type the GSM network can carry. It can be used to send binary SMS messages (operator logos, ringtones), wap push messages and other messages as well. Concatenated SMS messages and various alphabets can also be used. If you wish to use UCP to connect to your service provider, you need to get the following information from the service provider: IP address of the SMSC Port number of the SMSC User name Password Some service providers require you to set up an IPSEC VPN tunnel when you wish to connect to their SMSC (Figure 1). 26/185

27 Figure 1 - UCP connection with VPN In most cases you need a fix IP address, that you have to tell the provider so they can give you access through their firewall. In some situations, the service provider does not want you to be able to set up more then one UCP connections from your computer to their service. If this is the case, they might ask you to use a specific source port for the connection. Common protocols - SMPP The Short Message Peer to Peer (SMPP) protocol is an open, industry standard protocol designed to provide a flexible data communications interface for the transfer of short message data between External Short Message Entities (ESME), Routing Entities (RE) and Message Centers. SMPP is capable to carry any message type just like UCP/EMI. SMPP can be used as a protocol that transfers messages between applications, such as Ozeki Message Server and the Short Message Service Center (SMS Center) of the GSM Service provider over an IP link. This link can be a leased line or the Internet. The IP connection between your PC and the SMSC might be protected by VPN (Figure 1.) Figure 1 - SMPP connection between a PC and the SMSC 27/185

28 If you wish to use UCP to connect to your service provider, you need to get the following information from the service provider: IP address of the SMSC Port number of the SMSC User name Password If you would like to get some insights about SMPP, you must be familiar with some of the following terms. A Message Centre (MC) is a generic term used to describe systems such as a Short Message Service Centre (SMSC), GSM Unstructured Supplementary Services Data (USSD) Server, or Cell Broadcast Centre (CBC). A ESME typically represents a fixed network SMS client, such as a WAP Proxy Server, Gateway, or Voice Mail Server. It may also represent a Cell Broadcast Entity (CBE). A Routing Entity (RE) is a generic term for a network element that is utilized for MC to MC, and ESME to MC message routing. A RE has the ability to emulate the functionality associated with both a MC and an ESME. To an ESME, a RE appears as a MC and to a MC, a RE appears as an ESME. A carrier may utilize REs to hide a network of Message Centres, presenting only the REs as the external interface point for ESMEs. Figure 2 illustrates the context of SMPP in a mobile network: Figure 2 - SMPP inside the mobile network 28/185

29 Common protocols - CIMD2 The Computer Interface Message Distribution (CIMD) protocol was introduced by Nokia. The Nokia SMS Center includes an CIMD2 interface, that transfers messages between applications and the Nokia Short Message Service Center (SMS Center). CIMD2 is version 2 of the Computer Interface to Message Distribution protocol. The CIMD2 interface is suitable for client applications that send and retrieve messages over TCP/IP sockets, such as Ozeki Message Server. An application is interconnected through the CIMD2 connection to a SMS Center. The main purpose of this interconnection is to transfer messages from the applications to the mobile stations (MS) and from the MSs to the applications. Other kind of information can also be conveyed over the interconnection, for example, status reports from the GSM/GPRS network to the applications. CIMD2 is capable of transfering any SMS message type just like UCP/EMI and SMPP. A CIMD2 connection can be used through an IP link. This link can be a leased line or the Internet. Optionally the link can be protected by VPN (Figure 1). Figure 1 - CIMD2 connection with VPN protection If you wish to use CIMD2 to connect to your service provider, you need to get the following information from the service provider: IP address of the SMSC Port number of the SMSC User name Password Common protocols - Colour SMS The Colour SMS protocol was developed by T-mobile Hungary for premium rate SMS services. It is an easy to use HTTP based SMS protocol. When a customer tries to access a premium rate SMS service by sending an SMS to a premium rate phone number, the SMSC transfers this message as an HTTP post request to the HTTP Server operated by the content provider. The content 29/185

30 provider returns a response to the HTTP request in XML format. This response is sent as an SMS message back to the customer. The HTTP server operated by the service provider is Ozeki Message Server 6 (Figure 1). Figure 1 - Colour SMS transport Due to the nature of the HTTP protocol, it is always required to return a response to incoming messages in a short period of time. The Colour SMS protocol is often used with other connection methods, such as UCP to make delayed responses to incoming messages possible. Using a UCP connection, response messages can be sent at a later time, which is useful if you would like to set up periodic SMS notifications, such as weekly news service. Common protocols - Premium rated SMS services Mobile Service providers often allow 3rd party content providers to create mobile services using premium rate SMS messages. The services can be games for prizes, tests, data services. Premium rate SMS messages make it possible to collect money from the users of these value added services. Since the amount of money collected is very small, these services are often referred to as micropayment services. Today's most popular premium SMS services are downloaded games, logos, ringtones, background pictures and information services (e.g.: weather, news, programs). These services work in the following way: The person who would like to use the premium rate service, sends an SMS to a premium rate phone number. When the SMS arrives into the Short Message Service Center (SMSC) of the service provider, the SMSC recognizes that the destination phone number belongs to a "content server". As a next step, the message is transferred to a content provider's server through a TCP/IP connection. The content provider's server receives the SMS messages and generates a response SMS according to the implemented business logic. The response SMS travels back to the SMSC for transmission through TCP/IP just as 30/185

31 the request SMS was transferred to the content server. In most situations the content server and the SMSC communicate over the Internet (Figure 1). Figure 1 - Premium rated service architecture The business logic of the content server can be simple or complex. One of the most common solutions is based on content interpretation. A simple algorithm compares the incoming message text to a set of keywords, and generates a response based on the keyword. Another common application collects the phone numbers of the received messages and uses these phone numbers to provide periodic information services, such as traffic report or weather report every morning. There are many other types of solutions as well. One thing they have in common, is that in every case an SMS must be sent back to acknowledge the service request within a limited response time (usually in 2 minutes). Some useful facts: The premium rate SMS prices cannot be chosen freely. In most cases the content provider must select a price offered by the GSM service provider. One premium rate phone number can run several services, but can only operate with one price. It is not possible to send/receive premium rated SMS messages using SIM cards of foreign countries. It means that there is no such thing as premium rate roaming. When creating a solution, it is important to check if premium rated messages can be sent to our service from every GSM network in the country. Sometimes it is necessary to sign a contract with all GSM providers independently. Premium rated SMS service cannot be operated using a GSM phone attached to the PC with a phone-to-pc data cable. Premium rate SMS service phone numbers are often different than normal price phone numbers. They often use a special prefix, such as If there is no answer for the premium rate SMS the Mobile Service provider doesn't charge the customer. VPN configuration on Windows 2003 This guide describes how you can configure an IPSEC/L2TP connection to a GSM service provider with preshared secret key to set up IP SMS connectivity: 31/185

32 Service Provider Information Our company provides detailed information to our customers about connecting Ozeki Message Server to any of the following service providers. The documentation contains the contact information of the administrative and technical people at these companies (names, direct telephone numbers, addresses, etc) and detailed instructions on how to set up the service. The set up documents contain step by step configuration instructions, communication protocol information, detailed protocol specifications and case studies along with the experiences and hardships we have faced when we have set up our own service to these providers. We also give working configurations for Linux and Windows on how to set up the VPN connections required by some of these operators. HUNGARY: Pannon GSM HUNGARY: T-Mobile HUNGARY: Vodafone CZECH REPUBLIC: EuroTel CZECH REPUBLIC: Oskar CZECH REPUBLIC: T-Mobile 32/185

33 Product features The Ozeki Message Server Application is a Message Management System, that operates as a system service on Windows 2000, Windows XP and Windows 2003 computers. It is the successor of the successful Ozeki SMS Server 5 application. It can be used to send and receive SMS text messages and various other message types through the GSM network. Ozeki Message Server can be used by everyday people in the office, and by IT professionals. Ozeki Message Server in the Office Office users can use applications they are already familiar with sending SMS messages. For example Microsoft Excel can be used to send large numbers of messages with the help of an Excel Macro. Ozeki Message Server provides a plugin for Microsoft Outlook to make SMS messaging possible from the standard outlook interface and to be able to receive reminders about Outlook events. Of course there is a graphical user interface included in the software for those, who wish to use Ozeki Message Server on its own. Ozeki Message Server in the hands of IT professionals Ozeki Message Server was designed to help software developers and system integrators to add messaging functionality to their applications. The software supports SMS text messages and it can be used to send and receive other message types, such as zmodem files. It provides connectivity plugins, and application programming interfaces (APIs), that make sending and receiving very easy from existing systems. One of the biggest advantages of the software, is that it has a powerful engine, that can handle large volumes of traffic. It can be configured to use more then one devices and connections to send and receive messages with load balancing and it provides advanced management of message queues. The software provides SMS connectivity via GSM phones attached to the PC's serial port and over TCP/IP links connected directly to the Short Message Service Center (SMSC) of the GSM service provider. For IP SMS connectivity the UCP, CIMD2 and the SMPP protocols are supported. Ozeki Message Server in the Office Ozeki SMS is a reliable mobile messaging platform, that enables intelligent delivery of relevant information for people using GSM handsets. It is a costefficient two-way messaging system for your office. It can be used for various purposes whether you are a small, medium size or large company. The software provides a friendly, easy-to-use interface that makes it possible to send and receive SMS messages. It also has a lot of pluggable modules that help if you want to do messaging from other applications. If you use it, you and your employees will not forget any important events, vital information will reach you as fast as possible and your marketing and customer 33/185

34 relationship management team will perform better. The "Out-of-the-box", office edition of the Ozeki Message Server application is capable of handling SMS messages in a similar way to your client. It provides functionality for sending, receiving, forwarding and replying to messages. It maintains a history of all the messages sent and received by the system and can be used in an office in two ways. It can be used in a single user mode from a standalone computer, or it can be used in the office network from several computers simultaneously (Figure 1). Figure 1 - Ozeki Message Server in the office If you have a computer network in your office, you can use Ozeki Message Server to send SMS messages from any PC. After installation user accounts can be created in the server, and these accounts can be used to attach Microsoft Excel, Microsoft Outlook, and the other office clients to the server to send large or small number of messages through the office server, that has a mobile phone attached to it. Basic features Ozeki Message Server 6 provides the following basic features for Office users: Intelligent Message Sending You can send SMS messages from the built in Ozeki Graphical User Interface (GUI) or from MS Excel or MS Outlook. In all of these cases the outgoing messages are collected into a message queue, and sent as fast as 34/185

35 Receiving Messages Message Forwarding Message Replies Message Templates Address book Group Messaging Message History Message Folders Integrated Printing Multiple Device Support Integrated Microsoft Excel Support MS Outlook Support possible. In certain situations, for example on New Year's Eve, the GSM network fails. In these cases it is not possible to send SMS messages. The intelligent message sending capability of Ozeki Message Server helps in these situations. If a message cannot be sent for any reason, the software tries to re-send it a couple of times. Between each retry a certain amount of time (e.g. 10 minutes) is spent, to wait for the network to be available again. If there are six failures, the message is considered undelivered and the users are notified. You can receive SMS messages in the Ozeki GUI and in MS Outlook or MS Outlook express. The built-in user interface makes it possible to forward any incoming message to other phone number(s). The reply feature of the built in GUI is similar to the clients' user interfaces. It is very easy to reply to any incoming SMS message. To speed up work, you can define default messages in advance. These predefined messages are called message templates. When you want to send an SMS you can choose a template and edit it. Ozeki Message Server 6 provides a central addressbook for all clients. This address book can be synchronized with an SQL database or an LDAP directory. You can read more about this feature on the addressbook page. If a large number of SMS messages with the same content needs to be sent, the group messaging feature provided by Ozeki Message Server can make your job easier. You can send messages to a lot of phone numbers (up to a few thousand) with only a few clicks. Log files created by Ozeki Message Server, you can keep track of your messages anytime. A list of all messages, which have been sent and received by you are saved in a separate log file. This file can help you to remember what have you sent, when and to whom your message have been sent to. In case of having a lot of incoming messages it is a good idea to organize them into folders. Ozeki SMS provides an option to create new folders and to save your messages to them. You can print your messages and log files to your default system printer. For one GSM module it takes around 5-6 seconds to send an SMS message. You can speed this up by attaching more than one module to your computer. If you have two phones attached to send messages, you get twice the speed. Of course there is an option to switch to IP SMS technology seamlessly if the capacity of standard GSM phones are insufficient. You can use the built-in Excel support of Ozeki SMS. This allows you to send your SMS messages directly from Excel, simply by pressing a button. This feature is created with an Excel Macro that loads all the messages into the server and uses your Excel worksheet as the addressbook. You can use an Outlook plugin or you can use a standard client (e.g. Microsoft Outlook Express) to send SMS messages. If you have a computer network, equipped with several clients, this option provides a comfortable 35/185