                            JW SMS  V1.01
                            =============

                  Written by Jochen-Matthias Wienke
                    <C> 2010. All rights reserved.
                      
 



1 INTRODUCTION
==============

JW SMS is a simple and free Java SMS messaging tool. 

Why another SMS application? 
I needed a tool which is able to send special SMS types like the voice 
message notification ones. By using such special SMS types it is possible 
to get rid of certain symbols and alerts on the mobile. These might 
remain e.g. when a mobile network provider (e.g. a different one of 
another country) sends a new-voice-message SMS in case a new voice message 
is left, and afterwards the mailbox is called with a different provider, 
not sending a second no-new-voice-messages SMS. 

Although this should be a common problem, I couldn't find any small and 
free SMS application being able to send these kind of SMS. Only 
professional and expensive SMS server software with limited testing 
periods. 

Usage and distribution of the application itself is free and happens 
entirely at own risk.
However, since any SMS is sent through the connected mobile, it will get 
charged by the provider as if it was sent directly using the phone!
Furthermore, it is NOT ALLOWED to use it for teasing others and any user 
is responsible by themself for things done with this application!


Find new versions or contact author at:
http://www.worldwidehome.de

This application makes use of code developed and published by other 
authors, namely William Alexander, Wolfgang Wrankl and Sun Microsystems.
The respective source code can be found at following URLs:.
http://www.java-samples.com/showtutorial.php?tutorialid=22
http://www.wrankl.de/JavaPC/SMSTools.html
It is (c) by the respective owners and is thankfully used under the 
specified terms and conditions. 



 
                 
2 GENERAL INFORMATION
=====================


    
2.1 DISCLAIMER
==============

This  software comes with no warranty, either expressed or implied. The
author  is  in no way responsible for any damage or loss that may occur
due  to  direct  or  indirect usage of this software. Use this software
entirely at your own risk.

With so many possible existing operating systems, settings, drivers, hardware
devices, it is not possible for me to support all of these or even test the
functionality!
The application works fine with my Nokia phones under Windows XP and 
Windows 7 by using a COM port over Bluetooth connection. 
With respective drivers and set up COM ports, also using USB cables, 
infrared (IrDa) or other connection possibilities should work. Also, a lot of other
devices should be compatible if they offer respective capabilities and follow 
the standards.
Respective drivers in most cases can be installed along with the delivered 
software from the hardware manufacturer or even by using standard drivers from 
MS Windows respectively the ones provided in addition via Windows Update.
Please refer in doubt to the respective information sources regarding your used 
hard- and software.



2.2 COPYRIGHT
=============

The usage of this software for  legal purposes is  FREE  and   complete 
distribution of this archive is allowed.  Programm  and   documentation  
are copyright by Jochen-Matthias Wienke.  All  rights  reserved.   That
means especially that  reverse-engineering  or changing the software or
other files of this archive is NOT ALLOWED.
Please see above regarding code parts overtaken from other authors.



2.3 DISTRIBUTION
================

Permission is given to include this program in a public archive (such as
a Web site or PD library (e.g. CD-ROM versions)) providing that
all  parts  of  the  original distribution are kept intact.

The following files are included:

- README.TXT  ( doc-file ; this file )
- Application Java JAR file (classes and images)
- A complete Java Comm distribution for MS Windows systems as distributed
  by Sun Microsystems.



2.4 CONTACT
===========

Send bug reports, critics, X-mass cards, etc ...
Download new versions. Find other software.

homepage: http://www.worldwidehome.de



2.5 REQUIREMENTS
================

- Java 2 Release 1.4 (at least the Java Runntime Environment) or newer.
  It is assumed this is installed already.
  Please see http://java.sun.com for further details.
- Installed Java Comm extension (files included in this package)
- Compatible GSM mobile or modem and operating system along with 
  respective drivers and preferences done (e.g. a working serial ("COM") 
  port. Please refer in doubt also documentation of your mobile or
  modem. Or use general infomation sources about setup of communication 
  ports.



3 INSTALLATION
==============


3.1 INSTALLATION OF THE JAVA COMM EXTENSION
===========================================

This application makes use of advanced Java API classes not included 
in the standard Java distribution. The respective package is included in
this distribution regarding MS Windows. Regarding other operation systems
please download the respective package from Internet and follow the included
instructions. Installing the Java Comm classes is the most difficult part
of the installation.

At least in some parts, depending on your system, and if you want to do 
settings for all users or just for yourself, administration rights might be 
necessary.

Regarding MS Windows systems:

- Unzip the file javacomm20-win32.zip to a directory of your choice. You can
  e.g. create a special directoty within something lika a "java_addons" 
  directory. Additional to this description, the included HTML and text files 
  can provide further support.
  
- In parts different to the instructions of these documents, accordingly to 
  my experiences following steps need to be taken:
  
- If you have just the usual Java Runntime Environment (JRE) for executing Java 
  files installed, it should work more or less exactly in the described way. 
  For experts having additionally the Java Development Kit (JDK) for developing 
  own Java applications installed, and maybe certain environment variables set: 
  It might get a bit tricky here. You have then at least 3 different 
  "main paths" ( e.g. Java/JDK/lib etc... ; Java/JDK/JRE/lib etc...; Java/JRE/lib 
  etc...) to be considered depending on your system's settings. 
  Within these main paths it should be similar. If you don't know which is the 
  valid main path active on you system ehwn calling the application, in doubt do 
  the installation for all of these main paths. ;-) In my case it was the JRE path.
  
- For following examples it is assumed the Java Runntime is installed into the
  directory: C:\Program Files\Java\jre6
  
- Copy the win32com.dll file of the Java Comm distribution into the <jre>\bin directory.
  In our example the directory is then: C:\Program Files\Java\jre6\bin

- Copy the comm.jar file of the Java Comm distribution into the <jre>\lib\ext directory.
  In our example the directory is then: C:\Program Files\Java\jre6\lib\ext

- Copy the javax.comm.properties file of the Java Comm distribution into the 
  <jre>\lib directory.
  In our example the directory is then: C:\Program Files\Java\jre6\lib

- If everything works well, setup of Java Comm should be complete now.



3.2 INSTALLATION OF THE JW SMS APPLICATION
==========================================

- Copy all files of this distribution to a directory of your choice on 
  your harddisk.

   
   

4 START APPLICATION
===================  
 
  
- Start application simply by double-clicking the JWSms.jar file
  (on operating systems like MS Windows with standard Java installation and 
  settings). Or execute the JWSms.jar file from a console window. E.g. by
  using command "java -jar JWSms.jar" from within the JW SMS directory.
  
- It is not possible to save settings done within the application for next
  start of application. However, it is possible to start the application
  via console window by using certain parameters. 
  You can also use a batch (.BAT) file like the one mentioned above to get 
  the application started using your desired settings by default.
  
- Following start parameters (all optional) are supported:
  -h or ?: Help
  -r [recipient number]: set a default recipient number
  -m [message]: set a default message
  -c [CSCA number]: set a default CSCA number
  -p [port]: set a default port

  Example: 
  java -jar JWSms.jar -r "+4956789" -m "My Test Message" -c "+49123456" -p "COM3"






5 USAGE
=======

After starting JW SMS, the main window appears. From there on you can go 
to different application parts by clicking on the respective buttons. 
Close opening windows again in order to return to main window.


Main Window: 
Here, you can enter a text message into the message field.
Into the text field Recipient, enter the recipient's phone number 
in international format ( +49... or  0049...). This information is required
in order to continue with sending the SMS.
Within the selection box SMS Type, you can select the type of the SMS to be sent.
It can be a usual "normal" one sent in text mode.
Or an advanced SMS. A Flash SMS for instance will usually show up directly on the 
recipient's mobile, but not stored there unless manually done by the recipient.
The other available advanced SMS types are the special notification types
some GSM network providers send and result in compatible devices show up or
remove certain symbols and alerts. Please be careful and select these SMS types
only if you are aware of what you're doing! In doubt consult further information. 
These settings might lead to problems on some devices. Also don't use these 
features to tease other persons. If I hear about different things, this application 
will be removed from publishing and similar features won't be implemented in future
applications of me. I also want to repeat that I won't take over any responsibility
for what is done by other persons using this application.


In order to finally send the message, just click on "Send" button. As result, a window
will pop up where you can follow up the satus ind where errors are displayed if they 
occur. You should be able to close this window anytime, even if something hangs up or
goes wrong regarding the send process.
In case the communication port is not found at all, please check:
- the settings done within Preferences window
- if the Java Comm extension is installed properly
- if operating system's settings and drivers are setup correctly.


Preferences Window:
Here, you can change the pre-set preferences regarding the connection to the mobile or 
GSM modem. Especially most likely you will have to adjust the specific port used by your 
device (e.g. "COM3", "COM4", ...). 
If your device does not support a baud rate of 9600 you can switch to another setting.
Furthermore, if you don't want to use the SMS center (CSCA) used by default of your 
mobile respective GSM network provider, you can enter a different phone number 
in international format (e.g. +49..., 0049...). Otherwise, leave the CSCA field 
just blank.


Click on "Quit" button in order to exit application.





6 HISTORY
=========

V1.00 (2010-08-17)
------------------
First version released.


V1.01 (2011-06-04)
------------------
- Changed certain code to make it compatible running from a JAR archive.
- Application files now distributed as JAR archive
