************************************************************
Aldiscon Ltd.
SMS Developer's Toolkit(TM) v3.1.0.0 - (Feb 1999)
Copyright (C) Aldiscon Ltd., 1999
************************************************************
CONTENTS of this README FILE
============================
1. Welcome to the SMS Developer's Toolkit
2. Scope
3. Terms of Use
4. Copyright String
5. Hardware and Software Environment
6. Installing the Software
7. Developing
8. Note on Example
9. Testing on an SMSC
10. Support Contact Details
1.
WELCOME to the SMS DEVELOPER'S TOOLKIT
======================================
Thank you for purchasing the Aldiscon SMS Developer's Toolkit.
We trust that you will be satisfied with the contents of this product.
However, should you encounter any difficulties in using the toolkit, or
have any comments or suggestions that you wish to return to us, please
contact our Technical Support Department at the location below.
2.
THIS FILE
=========
The text contained in this 'Readme' file is intended to supplement
the SMS Developer's Toolkit User Guide, contained in the document binder of
the toolkit.
3.
TERMS of USE
============
The terms of usage of the SMS Developer's Toolkit software contained on this
disk, and the related user documentation are as stated in the Aldiscon SMS
Developer's License Agreement, which has been agreed between Aldiscon and the
Customer. The user is requested to ensure familiarity with the terms of this
License Agreement before installing the contents of this diskette.
4.
COPYRIGHT STRING
================
As per Aldiscon's Developer and Runtime License Agreement, the following text
string should be included and displayed as part of any Application software
program developed using any or all of the SMS Developer's Toolkit. This string
is also contained in the file 'Copyright' included on this diskette :"(c)1999 SMS Developer's Toolkit(TM), Aldiscon Ltd. All rights reserved."
5.
HARDWARE and SOFTWARE ENVIRONMENT
=================================
This version of the SMS Developer's Toolkit software is designed for use on
one of the following platforms (as applicable to your version) :
IBM compatible PC running MS Windows'95, MS Windows NT
HP-UX v9.X, 10.10, 10.20
Sun Solaris v2.5, v2.6
6.
INSTALLING the SOFTWARE
=======================
Windows'95
= From Windows Explorer, click on the 'Install' icon
WinNT
= From Windows Explorer, click on the 'Install' icon
MS-DOS
= From the DOS prompt type 'A:\Install'
HP-UX
= untar the tape to the host target directory
Sun Solaris
= untar the tape to the host target directory
7.
DEVELOPING
==========
7.1
Note on Compiling
=================
~ For all versions of the SMS Developer's Toolkit, include the file
"smsdtk_a.h" for all prototypes, structures etc. when compiling.
7.2
MS Windows'95 version
=====================
~ DLL libraries are :
smsdtk.lib and
smsdtk.dll
~ Static library is :
smsdtks.lib
Developer Tools
--------------The SMPP API libraries contained on the diskette may be compiled with
any version of Microsoft Visual C++ Compiler.
Notes on linking MS Windows'95 version
-------------------------------------~ To use the DLL library, link against 'smsdtk.lib'.
~ Ensure that the file 'smsdtk.dll' is located either in the directory
from which the application will be executed or in directory :C:\Windows\system
~ No access to global debug variables 'last_err_string' and
'last_err_lib_name' is provided in the DLL library version.
These variables are not part of the SMPP API.
~ The 'err_!!' functions are not supported in the DLL library version.
7.3
MS Windows NT version
=====================
~ DLL libraries are :
smsdtk.lib and
smsdtk.dll
~ Static library is :
smsdtks.lib
Developer Tools
--------------The SMPP API libraries contained on the diskette may be compiled with
any version of Microsoft Visual C++ Compiler.
Notes on linking MS Windows NT version
-------------------------------------~ To use the DLL library, link against 'smsdtk.lib'.
~ Ensure that the file 'smsdtk.dll' is located either in the directory
from which the application will be executed or in directory :C:\Windows\system
~ No access to global debug variables 'last_err_string' and
'last_err_lib_name' is provided in the DLL library version.
These variables are not part of the SMPP API.
~ The 'err_!!' functions are not supported in the DLL library version.
7.4
Note on MS Windows Versions
===========================
When using the sm_connect function, always connect using SMPPP_PROTOCOL,
as opposed
to SMPP_PROTOCOL. The latter is not included in the Windows' library, ho
wever, all
functionality of SMPP_PROTOCOL is supported indirectly by SMPPP_PROTOCOL
.
7.5
HP-UX and Sun Solaris versions
==============================
~ The Static library name is :
libsmsdtk.a
Notes on linking UNIX versions
-----------------------------~ Link as follows :
-lsmsdtk
** NB:- when linking, libsmsdtk.a must reside in directory specified by
-L{lib path}
8.
NOTES ON EXAMPLE SOFTWARE
=========================
This is a simple program to allow users to bind to the Telepath SMSC
and send, query, replace and cancel messages etc.
Build the example software as follows :
W95
--nmake -a -f make95.mak
builds exampld.exe (dll version) and exampls.exe (static)
Windows NT
---------nmake -a -f makent.mak
builds exampld.exe (dll version) and exampls.exe (static)
HP-UX
----make -f make.hp
Solaris
------make -f make.sol
** NB:- make files assume libs are in ../lib and .h are in ../inc
directories
9.
TESTING on an SMSC
==================
A number of different versions of the Telepath SMSC software may be running
on the same test machine simultaneously. For this reason, the SMPP Interface
process reads data from the socket in order to setup some environment
variables specific to your session, such as the kernel socket, event socket,
database name etc.
You may edit these environment variables in the smpp_dbg.txt file.
If this file exists, the SMPP API reads it one line at a time and
sends the data out over the socket before doing any SMPP handshaking.
If you do not wish to use this file, simply delete or rename it.
** NB:- Refer to the file smpp_dbg.txt for more details.
10.
SUPPORT CONTACT DETAILS
=======================
For Technical Support, on the Aldiscon SMS Developer's Toolkit, or to return
your comments and suggestions, please contact :Aldiscon Ltd.
SMS Developer's Toolkit, Technical Support
5 Custom House Plaza
Harbourmaster Place
Bublin 1
Ireland
Email :Phone :Fax :-
[email protected]
+353-1-8193400 (9:00am to 5:30pm GMT)
+353-1-8193401
Note :- All trademarks and tradenames are hereby acknowledged as the property
of their respective owners.
