--------------------------------------------------------------------------------
TabExpCo - Oracle Table Exporter Console Application
Copyright (c) 1995-1998 by Dieter Oberkofler. All Rights Reserved.
--------------------------------------------------------------------------------

This is TabExpCo, a Windows 95/NT console application for
Oracle that allows you to export a table into a simple SQL script where
each row is represented as an INSERT statement.

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


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 TabExpCo.EXE in the TabExpCo 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 TabExpCo used OCI Version 7.3. 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.


HISTORY:
--------
14-JUN-1998 Version 1.2.0
The export of LONG values has been fixed but
does still not support sizer 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.

06-MAI-1998 Version 1.1.2
Version 1.1.1 introduced a new date format error when
no -y option was used. This been fixed.
Adde a new -oDebug otion that shows the SQL command.

29-APR-1998 Version 1.1.1
Fixed error when using the -y option.

28-APR-1998 Version 1.1.0
Added support to export to a CSV ascii file.
Added options for special date format and delimiter.
Fixed error when exporting rowid's.
Started with a history section in the readme.txt file.

25-MAR-1998 Version 1.0.2
Added support for where and order by clauses.


USAGE:
------
TabExpCo is a very simple and small 32-bit Windows console application.
It uses only the Oracle OCI DLLs.
The utility uses unix-like command line parameters.

Usage: TabExpCo.exe <options>

The options are:

-u<usr>       user name (must be submitted)
-p<pwd>       password (must be submitted)
-s<conn>      oracle connect string (must be submitted)
-t<table>     table name  (must be submitted)
-w<where>     allows to add a where clause
-r<order>     allows to add a order by clause
-g<script>    filename of generated SQL script (if omitted, the table name is used)
-y<date-fmt>  special date format
-d<delimiter> CSV delimiter (default is ';')
-o<option>    define an additional option
              CSV exports a a CSV ascii file
              Delete adds a delete statement
              Commit adds a commit statement"
-v[0|1]       verbose messages 0=off, 1=on (on by default)
-h            help

Example 1: (generate SQL Insert commands)

The command line "TabExpCo -uscott -ptiger -s2: -temp -oCommit -v1" does the
following:

       o Log's into the server as 'scott/tiger@2:'.
       o Generates an SQL-script named emp.sql containing the INSERTs.
       o Adds a COMMIT command after the insert statements.
       o Shows some process messages.


Example 2: (generate CSV export file for Excel)

The command line "TabExpCo -uscott -ptiger -s2: -temp -oCSV -v0" does the
following:

       o Log's into the server as 'scott/tiger@2:'.
       o Generates an CSV-file named emp.csv containing the data lines.
       o Shows no process messages.


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:
-------------
TabExpCo 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 suggested contribution amounts are:

No. of copies        Price per copy (U.S. dollars)
      1-9                   5.00
      10 or more            2.00

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 a check made out to "Dieter Oberkofler" to:

       Dieter Oberkofler
       Czerningasse 8/16
       A-1040 Vienna
       Austria


DISTRIBUTING:
-------------
You may freely distribute the unregistered version of the TabExpCo 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 TabExpCo at your own risk.  All warranties expressed and implied are
disclaimed. Any damages resulting from the use of TabExpCo shall not result in
any liability. Except for those associated with the name TabExpCo, 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 TabExpCo is currently only available via E-mail or
by accessing the TabExpCo 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.
