==================================================================
TabExp - Oracle Table Exporter GUI Application
Copyright (c) 1995-1999 by Dieter Oberkofler. All Rights Reserved.
==================================================================

This is TabExp Version 2.1.0, a Windows 95/NT application for Oracle
that allows you to export a table into a simple SQL script where
each row is represented as an INSERT statement or to a ASCII file in
CSV format to be used in Microsoft Excel.

TabExp is distributed as a shareware product. See Registration,
below, for information on how to register your copy of TabExp.


THE ORIGINAL INTENTION:
=======================

As an Oracle Developer, I know about the power of the native Oracle
import and export facilities.
What this utility is all about, is the very easy to use interface and
the ability to generate SQL-script with simple INSERT statements.
If you just need to copy or save table and you only want to rely on
the basic SQL language, this is e very nice utility to have.
I also use it a lot when transferring tables to my customers because
the SQL*Plus editor is the only thing I can really rely on.


INSTALLATION:
=============

Copy the file TabExp.EXE in the TabExp distribution to a convenient
directory. Typically, I keep these files in a directory along with other
small Oracle utilities.

This utility used the native Oracle OCI (Oracle Call Interface) to
access the Oracle server. No additional drivers are needed to connect
to an Oracle server. OCI itself is the low-level API that allows to use
SQL in an Oracle SQL*Net environment.

This 32-Bit version of TabExp used OCI Version 8.x. The specific DLL that
contains the OCI implementation is OCIW32.DLL.

Usually OCI is automatically installed during the installation process of
SQL*Net and should be always available.


VERSION HISTORY:
================

Version 2.1.0 - 20-MAR-1999
---------------------------
- A better error handling for oracle errors now immediately aborts the
  application after a fatal error happened.
- Added command line parsing capabilities that give TabExp the
  same functionality as the command line based TabExpCo app.
  The exact syntax of the command line arguments that will
  be processed by TabExp can be found in the Usage section of this
  document.
- Added a sample batch file showing how to use the new command
  line arguments.

Version 2.0.0 - 24-JAN-1999
---------------------------
General changes:
- Major new release using a new utility library for all tools.
- New login dialog fixes problem with stored connection duplicates
  and sets the correct keyboard focus when entering.
- New about dialog allows to automatically sending email and
  connecting to the products web page for updates.

Application specific changes:
- A new object selection page allows now to select tables and/or
  views.
- All settings (except the table selection) will now be stored
  in the local preferences when starting an export and will
  be automatically proposed as default values when restarting
  the application.
- The SQL and CSV settings have now been organized in separate
  pages and will be stored separately.
- A new option in the CSV settings allows to specify if a
  header should be generated or not.
- The "where clause" and the "order by clause" can now be used
  for the SQL and the CSV export.
- Additionally a few small problems with the user interface have
  been fixed and the organization of the settings should be more
  consistent.

Version 1.1.0 - 20-DEC-1998
---------------------------
- Some functional improvements. This version has not been released.

Version 1.0.1 - 19-JUN-1998
---------------------------
- Fixed a major error in the table selection dialog.
- Fixed an error when exporting without tables.

Version 1.0.0 - 14-JUN-1998
---------------------------
- The export of LONG values has been fixed but
  does still not support sizes larger then 64K.
- The debugging option now shows the table structure.
- An error has been fixed when exporting a table
  that has an empty VARCHAR2 column as the last one.

Version 0.1.0 - 10-MAY-1998
---------------------------
- First release version.


USAGE:
======
Just start the executable with or without command line arguments.
It is possible to specify all needed command line arguments or
to only specify the -u, -p and -s arguments to automatically log
into the oracle server.

The following command line arguments will be processed:
Usage: TabExp -e -u -p -s -t -v [-g] [-o] [-v] [-d] [-h] objects...
       -e ... export mode
              -eCSV export as CSV file
              -eSQL export as SQL file
       -u ... user name
       -p ... password
       -s ... server
       -w ... where clause (e.g. \"rownum < 10\")
       -r ... order by clause (e.g. \"deptno desc\")
       -g ... filename of generated SQL script
       -y ... special date format
       -d ... CSV column delimiter
       -t ... CSV text delimiter decimal ascii code (e.g. 34 for ")
       -o ... define an option
              -oDelete adds a delete statement
              -oCommit adds a commit statement
              -oHeaderline for CSV exports
       -h ... help


THE FUTURE:
===========
I currently use this utility in my day-to-day work and just
wanted to make it available as a shareware package to see how
useful my utilities can be for others.
There are lot's of features I can imagine to add and therefore I
really like to hear from you.


REGISTRATION:
=============
This application is a shareware program. It is not free software.
If you use the program in a commercial setting, or non-commercially
on a regular basis, you must submit a registration contribution.

	>>> The shareware fee is US$ 10 per copy <<<

Contributors will automatically receive a version that exports an
unlimited number of rows as uuencoded .ZIP files by e-mail.
When submitting your registration, be sure to contact the author
at doberkofler@usa.net so your e-mail address can be placed on the
update list.

To register, you may send cash in US$ or a check in US$ made out to
"Dieter Oberkofler" to the following address:

	Dieter Oberkofler
	Czerningasse 8/16
	A-1020 Vienna
	Austria


DISTRIBUTING:
=============
You may freely distribute the unregistered version of this
executable as long as the executable file is not modified in any way,
and as long as this file, README.TXT, are distributed with the executable.


DISCLAIMER - AGREEMENT:
=======================
You use this application at your own risk.  All warranties expressed
and implied are disclaimed. Any damages resulting from the use of
this application shall not result in any liability. Except for those
associated with the name of this application, all rights associated
with names mentioned in this file and in the accompanying files, are
held by their respective companies.


CONTACTING THE AUTHOR:
======================
E-mail correspondence concerning this program may be submitted to:

        doberkofler@usa.net

Suggestions for improvements are particularly welcome.


OBTAINING UPDATES:
==================
The latest version of this application is currently only available
via E-mail or by accessing my homepage at:

http://members.tripod.com/~DieterOberkofler/project.htm


WHAT IS SHAREWARE:
==================
Shareware distribution gives users a chance to try software before 
buying it.  If you try a Shareware program and continue using it, you 
are expected to register.  Individual programs differ on details -- some 
request registration while others require it, some specify a maximum 
trial period.  With registration, you get anything from the simple right 
to continue using the software to an updated program with printed 
manual.

Copyright laws apply to both Shareware and commercial software, and the 
copyright holder retains all rights, with a few specific exceptions as 
stated below.  Shareware authors are accomplished programmers, just like 
commercial authors, and the programs are of comparable quality.  (In 
both cases there are good programs and bad ones!) The main difference is 
in the method of distribution.  The author specifically grants the right 
to copy and distribute the software, either to all and sundry or to a 
specific group.  For example, some authors require written permission 
before a commercial disk vendor may copy their Shareware.

Shareware is a distribution method, not a type of software.  You should 
find software that suits your needs and pocketbook, whether it's 
commercial or Shareware.  The Shareware system makes fitting your needs 
easier, because you can try before you buy.  And because the overhead is 
low, prices are low also.  Shareware has the ultimate money-back 
guarantee -- if you don't use the product, you don't pay for it.
