Copyright (c) 2001 Simplewire. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. For further documentation and support, please check out www.simplewire.com Description ----------- Net::SMS is a global short text messaging service interface via the Internet. It brings you the first and only way to send SMS messages through one easy interface. Simplewire has defined an XML SMS standard and will make numerous tools available for developer's use so that SMS technology can be better utilized. Currently, this interface supports more than just SMS enabled devices and can send messages to ANY protocol. The module hides all the difficulties of sending SMS messages and guarantees the same interface no matter what changes happen in the wireless market. Net::SMS is the perl interface to Simplewire's expanding messaging network. The module interacts with Simlewire's Remote Procedure Calls. The Remote Procedure Calls provide an XML API and the protocol is open to all developers. For futher support or questions, you should visit SimpleWire's website at www.simplewire.com. There you will find support and documentation including the white paper explaining the Simplewire XML API. Dependencies ------------ The following packages are required in order to run or even install Net::SMS. * XML::DOM (libxml-enno) >= 1.02 Features in 2.00 ---------------- . Send messages to ANY wireless device . Provides a consistent interface to wireless devices . Removes the difficult part of interfacing to many different wireless providers and carriers. . The Simplewire network will maintain every service so that you don't have to. Archive Location ---------------- . The newest release/extensive help/faq/exaples on www.simplewire.com . In the CPAN directory: modules/by-module/Net/ . To find a CPAN site near you see http://cpan.perl.org/SITES.html Prerequisites ------------- . Perl Version 5.002 or later . A Windows 95/NT machine requires Perl version 5.003_07 or later Documentation ------------- User documentation in POD format is contained within the module source (i.e. the .pm file). Installing using "make install" places this documentation in a man page in the perl library under the directory "man/man3". However, the best documentation is the example code in the /eg directory form the tar.gz file or on www.simplewire.com. Installation ------------ These notes work on Unix based systems and there are some changes if you are using Windows NT/95/98. See the special notes below. To install, cd to the directory containing the unpacked distribution and do one of the following: a. Create a makefile by running Makefile.PL using the perl program into whose library you want to install and then run make three times: perl Makefile.PL make make test make install b. To install into a private library, for example your home directory: perl Makefile.PL INSTALLSITELIB=$HOME/lib INSTALLMAN3DIR=$HOME/man make make test make pure_install c. Alternatively, you can just copy or move SMS.pm from the distribution into a directory named Net/ in the Perl library. You can then manually build the documentation using pod2man or pod2html. d. At the time of printing this, there should be more ways to install Net::SMS. Please go to www.simplewire.com and visit our Developers section for the easiest ways. There should be a CPAN install and a ppm install. Windows NT/95/98 Installation ----------------------------- Windows does not come with the make program. Instead, you will have to use a similar program called 'nmake'. If you have happened to install Microsoft's Visual Studio then 'nmake' is already installed on your computer and you can fun the following instructions. Once you have 'nmake.exe' then you can replicate the instructions laid out in the previous a, b, and c subpoint above except replace the 'make' command with 'nmake'. So (a) would be now perl Makefile.PL nmake nmake test nmake install Some Common Problems -------------------- You most likely have to logged in as root on any machine to be able to successfully install either module. If you cannot log in as root then follow choice c. above and just make a directory called Net where your programs will run and then copy Pager.pm into it. If you have any other questions please visit Simplewire's FAQ or online support forum for anwers.