==================================================================
TabExp - Oracle Table Exporter GUI Application Version 4.0.1
Copyright (c) 1995-2001 by Material Dreams.
All Rights Reserved.
http://www.materialdreams.com
==================================================================


PURPOSE:
========
The utility TabExp is a simple Windows 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 or previewed in Microsoft Excel.


LICENSE:
========
Please consult the License.TXT file for licensing information
and on how to register this application.


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.


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 -u -p -s [-e] [-h] <parameter-file>
       -u ... user name
       -p ... password
       -s ... server
       -e ... start export after loading parameter file
       -h ... help


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

Version 4.0.1 - 27-FEB-2001
---------------------------
- Fixed a strange problem on certain
  workstations that prevented from
  selecting the tables to export.
- Fixed a problem when exporting empty
  tables.
- Fixed a problem with the registration
  process.
- Fixed a problem with the unregistration
  process.

Version 4.0.0 - 20-DEC-2000
---------------------------
- Internal changes and adapted to new CI.
- Export of XML tables has been introduced.
  A Valid XML Document can now be exported
  with te extension XML together with a
  HTML File that can be used to display
  the contents of the XML File using XML
  data binding functionality.
  e.g.: When exporting the table scott.emp
  a file scott.emp.xml and a second file
  scott.emp.xml.html will be generated.

Version 3.5.1 - 18-OCT-2000
---------------------------
- A bug was fixed that caused NULL values in
  th SQL script not to be followed by a comma.

Version 3.5.0 - 02-OCT-2000
---------------------------
- A new export target HTML has been introduced:
  It is now possible to export to an HTML table
  and to display the contents of an Oracle table
  in a web browser as an HTML table object.
- New HTML button in the toolbar to directly
  previews a table export in the WEB browser.
- A new line wrap option for the SQL export has
  been introduced allowing to minimize the line
  length of the SQL insert commands.
- The export files can now be have an extension.
  If the user defines an export file name in
  the application or in the parameter file, this
  name can (must) now contain the complete
  filename including the extension.
  The application will only generate a filename
  automatically if no individual name was given.
- Export of RAW, LONG and LONG RAW columns
  has been finalized. Unfortunately SQL*Plus
  only allows a line length of up to 2499
  characters and it is therefore not possible to
  execute SQL script with lines longer that this
  limit.
- When exporting LONG or LONG RAW columns, the
  array fetches are disabled and the export will
  take longer but be save for all LONG lengths.
- Fixed a problem in the login dialog, when
  entering a wrong password.
- It is no longer possible to define more
  then one export target at the same time
  but only one export destination per run.
- The error handling of Oracle OCI errors has
  been improved and better messages are given.
- Now using the IE5 toolbar controls look & feel.
- The examples now contain tree INI-Files for
  the SQL, CSV and HTML export and all export
  examples are part of the distribution.
- Fixed an error when using the delete option
  in the SQL export.
- Fixed an error in the CSV export that
  sometimes appended the string ); at the end of
  a line.

Version 3.1.1 - 03-JUN-2000
---------------------------
A problem in the online registration process
has been corrected. You must use version 2.2.1
or higher in order to register the application
successfully.

Version 3.1.0 - 25-MAY-2000
---------------------------
The application now supports online registration
and will expire after a 30 day trial period.


Version 3.0.0 - 09-APR-2000
---------------------------
Major new release with a completely redesigned user interface,
several new features and a dramatic export speed improvement:
- All reported errors in the Beta version of TabExp have been
  fixed in this release.
- TabExp now used a completely redesigned mechanism of array
  fetches and allows to set the maximal array fetch buffer size
  as a simple parameter.
- By using an array fetch buffer of 1MB the export speed should be
  improved up to 10 times compared to the older versions of TabExp.
- TabExp now uses a list control to show the objects (tables, views and
  user defined objects) that can be exported.
- The user interface now allows invoking all commands by using the menu,
  the toolbar buttons or a popup menu that can be invoked for each object
  in the list by pressing the right mouse button.
- The database objects can be selected from the object repository of oracle
  by using a filter and added to the current list of objects.
- A where clause and order by clause can be added for each object and shown
  in it's own column.
- The export filename can be separately specified for each object and shown
  in it's own column.
- Objects can be added, removed, changed or marked for export at any time.
- Objects can be imported from any oracle schema and objects from more than
  one schema can be combined together.
- Objects can be automatically previewed in MS Excel by automatically exporting
  them and then invoking MS Excel from within the TabExp utility.
- The complete selection including the current preferences can be stored to a
  simple (INI-style) parameter files and later by loaded into TabExp.
- The current settings of TabExp can be stored and retrieved from a simple
  INI-File-like text document and edited in any text editor.
  TabExp now allows showing the number of rows for each object in the list.
- The command line processing of TabExp has been redesigned to take advantage
  of the new preference files. TabExp can be invoked with a predefined preference
  file and executed automatically.


Version 2.2.0 - 20-MAR-1999
---------------------------
- When exporting in CSV format empty string columns have
  been truncated to NULL. This problem has been resolved.


Version 2.1.1 - 22-JUN-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.


