SMS Messaging Over the IP Network Using a GSM Driver

OZEKI IP SMS

SMS messaging over the IP network using a GSM driver

/ user manual /

Last change: 11th April, 2005.

Document version: 1.0.4

Document length: 48 pages

Ozeki Proprietary and Confidential

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.

Ozeki Proprietary and Confidential

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.

1. Contents

Ozeki Proprietary and Confidential

1. Contents 3

2. About this document 4

2.1. Summary of changes 4

2.2. References 5

3. Introduction 5

4. System requirements for running the Ozeki Message Server with an GSM driver 5

4.3. 5.1 Architectural elements of Ozeki SMS 6

Hardware and software requirements 8

Installing Ozeki Message Server 8

Step2: Connect your phone to thePC 9

Step3: Installing the application 10

Step5: Starting theGSM modemconnection 18

Step6: Sending your first SMS 18

Hardware and software requirements 19

Installing OzekiMessage Server 20

Step1: Installing the application 20

Starting theData call connection 29

Receivingyour first data file 30

Microsoft SQL Server 32

Tips: 32

MySQL 33

Interbase 34

Oracle 35

Example for sending a message: 36

PostgresSQL 36

2. About this document

This document describes the UCP interface of the Ozeki IP-SMS software. UCP is a protocol that transfers messages between applications 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. UCP/EMI is version 3.5 or 4 of the Universal Computer Protocol / External Machine Interface protocol. This document is intended for operator personnel involved in daily operations of the Ozeki IP SMS Software and for application developers.

2.1. Summary of changes

Date released / Version / Changes
2005-01-03 / v6.0.0.0 / The first development release of Ozeki Message Server 6
2005-01-14 / v6.0.1.0 / Improvements in Ozeki Message Server v6.0.1.0
2005-02-01 / v6.0.1.2 / Improvements in Ozeki Message Server v6.0.1.2
2005-02-09 / v6.0.1.4 / Improvements in Ozeki Message Server v6.0.1.4
2005-02-14 / v6.0.1.5 / Improvements in Ozeki Message Server v6.0.1.5
2005-02-20 / v6.0.0.6 / Improvements in Ozeki Message Server v6.0.0.6
2005-02-23 / v6.0.0.8 / Improvements in Ozeki Message Server v6.0.0.8
2005-02-25 / v6.0.0.9 / Improvements in Ozeki Message Server v6.0.0.9
2005-03-06 / v6.0.1.10 / Improvements in Ozeki Message Server v6.0.1.10
2005-03-14 / v6.0.1.11 / Improvements in Ozeki Message Server v6.0.1.11
2005-03-14 / v6.0.2.12 / Improvements in Ozeki Message Server v6.0.2.12
2005-03-17 / v6.0.2.14 / Improvements in Ozeki Message Server v6.0.2.14
2005-03-17 / v6.0.2.15 / Improvements in Ozeki Message Server v6.0.2.15
2005-03-26 / v6.0.2.16 / Improvements in Ozeki Message Server v6.0.2.16
2005-03-27 / v6.0.2.17 / Improvements in Ozeki Message Server v6.0.2.17
2005-03-31 / v6.0.2.18 / Improvements in Ozeki Message Server v6.0.2.18
2005-04-01 / v6.0.3.1 / Improvements in Ozeki Message Server v6.0.3.1
2005-04-02 / v6.0.3.2 / Improvements in Ozeki Message Server v6.0.3.2
2005-04-03 / v6.0.3.3 / Improvements in Ozeki Message Server v6.0.3.3
2005-04-07 / v6.0.3.4 / Improvements in Ozeki Message Server v6.0.3.4

Ozeki Proprietary and Confidential

2.2. References

IP SMS technology information

http://www.ozeki.hu/index.phtml?ow_page_number=263

UCP product information

http://www.ozeki.hu/index.phtml?ow_page_number=264

3. Introduction

If you plan to send or receive a larger number of SMS messages, it is worth to consider using the Internet. 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) Figure 1. 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:

A large number of messages can be sent of 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.

4. System requirements for running the Ozeki Message Server with an GSM driver

Operating System / Windows 2000, Xp, 2003
Internet Explorer 6. (by reason for xml library)
Minimal hardware / Pentium III. 1GHz processor
500Mb HDD
256Mb RAM
Network
connect / Public Internet or a leased line can be used. The bandwidth should have a minimum capacity of 128kbps in the link to the service provider.
Other / Database server (MySql, PostgresSql, Sybase, Oracle, or other SQL based database server) is recommended
Software / Ozeki IP SMS UCP installation Package (CD or downloaded file)

Ozeki Proprietary and Confidential

4.2 The most important features

- Delivery reports

- Connection link management

- Can be run as windows service

- Creates a log files

- SQL - SMS gateway

- FILES - SMS gateway

- HTTP- SMS gateway

- IPC – SMS gateway for COM and SOAP/WSDL

- Windows client connection

4.3 The package contains the following components

The message engine / The main application that handles message queues, permissions and operates the drivers and plugins.
The UCP driver / It connects to the SMSC (Short Message Service Center) of the GSM service provider through an IP connection.
SMS - SQL gateway / Makes it possible to store the incoming messages a database table. Another table is used to send outgoing messages.
SMS – Files gateway / It provides a way to send and receive short messages (SMS) by simply creating text files.
Windows client / Provides a user interface for management and office use.

Ozeki Proprietary and Confidential

5 Technical information

4.3. Architectural elements of Ozeki SMS

The Ozeki Message server is a multi-user message delivery engine, that can handle various different message types. To make the engine more efficient and the internal architecture has been designed using the following guidelines.

It uses an envelope system inside the new engine. This way it is able to handle various message types such as SMS, E-mail, MMS, Windows MSN messages, ICQ messages, etc. and future message types.

It has a multi-user architecture. Separate message queues and folders are set up for each user. The users cannot disturb each other, by taking up too much system resources. Security was improved and accounting was added, which helps cost control.

Advanced link management. Often message transport is not reliable. For example the network link between the SMSC and the server can be broken or a GSM phone attached to the PC can stop responding after a certain amount of time. The new engine constantly monitors the transport links and it takes action if the link is broken. (It automatically reconnects if necessary and it notifies the administrator, etc)

Advanced message management. The engine tries to send a message several times before it marks it undeliverable. It handles delivery reports, and informs the users/plugins about change in message states. Old messages can be deleted or put in an archive folder automatically to manage disk space resources.

The GUI and the engine are two separate applications. The engine runs as a Windows service. The engine is a small and fast program. It does not spend time with GUI updates or other subsidiary tasks. The GUI communicates with the engine over HTTP, which enables remote configuration.

The drivers and plugins are placed into DLL-s. Context switching between different processes is slow, and memory requirements are high in a multiprocess messaging architecture. In our new messaging software all the functionality is executed into a single process and native DLL calls are used to communicate between the components and the engine. This is much faster then the previously used Microsoft COM/DCOM IPC communication. The drivers and plugins are running in separate threads instead of separate processes.

Run time configuration and component installations. The messaging service does not

Ozeki Proprietary and Confidential

have to be stopped to change the configuration or to install/uninstall new drivers or plugins.

5.2 Ozeki SMS interfaces

The primary reason why software developers choose the Ozeki SMS software is because they want to save time and effort when implementing a messaging solution. Ozeki SMS is a reliable service that runs in the background. It provides easy to use interfaces for software developers the make development faster. Software developers can easily find a way to communicate with the Ozeki SMS application. There are several options, they can use. Please take a look at the alternatives.

5.2.1 SQL – SMS gateway

If you use the SQL-SMS gateway interface of Ozeki SMS, you can send and receive SMS messages with the help of SQL queries. To use this interface you need to have a database server (e.g.: Oracle, MSSql, MySql, PostgresSql, Sybase). The OZEKI SMS Software will connect to your database server and check a database table periodically for outgoing SMS messages. To send an SMS message, all you need to do is insert a record into the database table. If an SMS message is received another database table is used. The Ozeki software inserts the message to this database table.

5.2.2 FILE – SMS gateway

The FILE-SMS interface provides a way to send and receive short messages (SMS) by simply creating text files. To use this interface, two directories must be created: one for outgoing and one for incoming messages. The Ozeki SMS software will read the contents of the outgoing directory periodically. If it finds a text file containing a message it sends the message and deletes the file. For incoming a messages the other directory is used. If a message arrives a txt file is created in the incoming directory.

5.2.3 HTTP – SMS gateway

With the HTTP-SMS interface, standard HTTP requests (GET, POST) can be used to send and receive SMS messages. Ozeki SMS can operate in two modes if this interface is used. It can act as an HTTP server or as an HTTP client. If it is used as an HTTP server, the client application can make the HTTP queries to send and download the messages. In the client mode mode Ozeki SMS makes an HTTP request when an incoming message arrives.

5.2.4 IPC – SMS gateway (COM, SOAP)

Ozeki SMS can use various inter-process communication methods to send and receive SMS messages. The server provides a Common Object Model (COM) interface, which means that clients implementing this interface can attach to it to receive events and to be able to call procedures on the server. The Simple Object Access Protocol (SOAP) over HTTP can also be used. This protocol provides a standard web service interface for application developers. The features of this interface can be queried using the WSDL protocol.

6 Installation guide

INSTALLATION GUIDE - GSM Modem Driver

OzekiMessage Sever is a software-based solution for you to benefit from advanced communications functions with the help of a mobile phone. You can easily connect your mobile phone to a compatible PC for sending and receiving short messages (SMS). As soon as the phone is attached, Ozeki Message Server enables you to send, receive and manageSMS messages in various ways. You can use thegraphical user interface or one of the built-in plugins to handle the messages.
This guide describes you how to install the Ozeki Message Server software onto your PC and how to start using it.For more details aboutthe use of the software contact our on-line support at the following e-mail address: .

Hardware and software requirements

To install and run the Ozeki Message Server, you need the following tools/devices available:

Suitable mobile phone / A list of supported phones can be seen on the following page:
supported phones
Data cable / You need a phone-to-pc data cable
or an Infra Red port (IR)
or a Bluetooth connection
WindowsPC / Intel compatible PC
Windows 95,98,Me, 2000,Xp
20 Mb free hard disk space
Ozeki Message Server / OzekiMessage ServerIntallation Package (CD or downloaded

Installing Ozeki Message Server

During the installation, various selections can be made. You will find step-by-step information in the following section. If you want to quit the Setup program without installing or uninstalling, just click Cancel and the Exit Setup window will offer you the possibility of quitting the Setup program. Click Exit Setup to quit Setup . If you want to rerun Setup after having quit the installation before it had been completed, follow the installation steps normally as if you were installing the program for the first time.