                            SMS DB  V1.04
                            =============

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



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

With different handys (along with different PC software applications) are used,
there is a demand on how to archive SMS beyond the borders of seperate handy 
applications within one integrated database.
SMS DB is a simple storaging tool allowing import of SMS from different supported 
data sources (Siemens Data Suite/MPM RTF files or Nokia PC Suite CSV files) and 
storing them within an odd ODBC database.

Therefore, also other ODBC enabled applications (e.g. MS Office) can directly 
access to the same data without any further syncronization requirements.

Basic things like importing/viewing/adding/deleting/editing Contacts and SMS 
messages can be done directly within the SMS DB application.

For complex data queries MS Access or other applications being able to connect 
to the database can be used.

Depending on time and feedback issues maybe more advanced features might be 
added. Among these are filtering, sorting and encrypting possibilities or 
additional data import modules.



 
                 
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.



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.


CSV import of this application uses a slightly modified (added support
for different Charsets like e.g. UTF-16) version of CSVFile classes. 

About CSVFile:
--------------

CSVFile classes were adapted from a C++ original that is Copyright 
(C) 1999 Lucent Technologies and excerpted from 
'The Practice of Programming' by Brian Kernighan and Rob Pike.

Included by permission of the Addison-Wesley web site, which says:
"You may use this code for any purpose, as long as you leave the copyright 
notice and book citation attached"

Thanks alot to all authors:
-> Brian Kernighan and Rob Pike (C++ original)
-> Ian F. Darwin (translation into Java and removal of I/O)
-> Ben Ballard (rewrote handleQuotedField to handle double quotes and for 
   readability)
-> Fabrizio Fazzino (added integration with CSVFile, handling of variable 
   textQualifier and Vector with explicit String type)

Please also see following web sites for further information:
CSVFile Sourceforge project: http://sourceforge.net/projects/csvfile
Addison-Wesley: http://tpop.awl.com/



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

Permission is given to include this program in a public archive (such as
a BBS, FTP site or PD library (disk and 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 )
- Programm Java classes and images
- MS Access 2000 MDB file smsdb.mdb



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

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

email: j.wienke@worldwidehome.de
homepage: http://www.worldwidehome.de



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

- Java 2 Release 1.4 or newer.
- Any ODBC-SQL-Database with respective data structure.
  Complete MDB file for MS Access 2000 (or newer) already included.





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

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

- Set CLASSPATH environment variable of your system to include 
  "." (the current directory of a java application), otherwise Java
  won't find the classes.
  
- Copy included MDB database file to a directory of your choice on your 
  harddisk. You can also build up and use an own database file of a 
  different database with equal data structure.
  
- Set up the database file on your system as ODBC source.
  E.g. on Windows 2000 or XP do following steps for included MDB file:
  (a) Go to Control Panel->Administrative Tools, then double-click 
      "Data Sources (ODBC)". 
  (b) Go either to Tab "User DSN" (to make database available only in your 
      current Windows user profile) or to TAB "System DSN" (in order to make
      database available for all Windows user profiles).
  (c) Click on "Add" and select "Microsoft Access Driver (*.mdb)".
  (d) Continue by doing following settings:
      Name: "SMSDB" (exactly written without quotation marks)
      Database: select smsdb.mdb database file copied above on your harddisk.
      Login: "smsdb" (exactly written without quotation marks)
      Password: "smsdb" (exactly written without quotation marks)         
      
      



4 START APPLICATION
===================  

- Start application by calling the class SmsDb (e.g. by typing "java SmsDb" 
  from it's directory in a console) or on Win32 systems also by just
  doubleclicking "start_SmsDb.BAT".





5 USAGE
=======

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

Within "Import SMS" application part, you can import SMS messages automatically 
from supported import sources (e.g. Siemens Data Suite SMS archive RTF files
or Nokia PC Suite CSV files).

Within "Contacts" application part, you can maintain sender/recipients phone 
numbers together with a person name and a remark for each. If maintained, within 
SMS application part the name will be displayed in addition to the phone number.

Within "SMS" application part, you can view and also manually add/edit/delete 
your SMS messages.

Within "Preferences" application part, database experts can change database 
connection and data structure settings if they decide to use different 
settings for some reasons.

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





6 HISTORY
=========

V1.00
-----
First version released.

V1.01
-----
Added Nokia PC Suite CSV import.

V1.02
-----
Some code optimizations and Siemens RTF import imporovements for better MPM compatibility.

V1.03
-----
- Nokia CSV Import: Included recognition of sent status also for German Nokia PC Suite exports where "Sent Items" is named "Gesendete Objekte".
- CSVFileReader: Fixed records are not read properly when textfields include linebreak characters.

V1.04
-----
- CSVFileReader: Improved logic for detecting if linebreak is within textfields making class more universal also for other purposes than Nokia PC Suite import.