**********************************************
*   SQLDirect Component Library Ver.1.05     *
**********************************************

TABLE OF CONTENTS

    OVERVIEW
    LATEST CHANGES
    INSTALLATION
    DEMO-PROGRAMS
    KNOWN PROBLEMS
    CONTACTING AUTHOR

---------------------------------
OVERVIEW
---------------------------------

   SQLDirect - native components for Delphi for access to SQL-servers.
Now supported Centura SQLBase Server and Oracle Server using 32-bit call
interface. No distributing and configuring BDE and ODBC.
Support all data-aware components.

   Using SQLDirect gives you the following advantages:

- use 32-bit native API of Centura SQLBase Server(ver. 6, 7) and
  Oracle Server 7.2 or later with SQLNet 2.2 or later;
- no distributing, installing and configuring the BDE and ODBC;
- no BDE or ODBC overhead;
- for SQLBase ver.7 and Oracle Server 2.3 you can execute multiple 
  concurrently transactions from one or more threads of your 
  application (one TSDDatabase component on one transaction);
- give to you access to both servers at the same time;
- possibility to use any Delphi3 version (Desktop and other) to develop
  Client/Server applications;
- BLOB-fields;
- support stored procedure;
- cached updates;
- using a data source to bind parameters for master/detail forms;
- interface (methods, properties) of SQLDirect components similar to
  standard BDE data access components (TSession, TDatabase, TQuery ..);
- support all data-aware components;

---------------------------------
LATEST CHANGES
---------------------------------

- fixed "List index out of bounds " error after open query with
  persistent fields (ver.1.05);
- read output parameter of Oracle stored procedure bug (ver.1.04);
- fixed memory leaks and other bugs (ver.1.03);
- fixed the discovered bugs (ver.1.02);
- compatible with Delphi 4 (ver.1.01);
- new component TSDSQLBaseServer, multi-threading sample,
  fixed update error for varchar2(>256), fixed default connect, 
  design-time editors for TSDataSet and it's descendants (ver.1.0);

---------------------------------
INSTALLATION
---------------------------------

   Unzip the SqlDir.ZIP in your chosen directory for the components.
Uninstall "SQLDirect Components" package from design package list.
From the Delphi "Component" menu select "Install Packages". Press
the "Add" button and select the <Package collection (*.dpc)> filetype.
Select the SqlDir*.dpc file from the chosen directory and press "OK". If
you want to choose of directory for installation press "Directories..".

ATTENTION for Delphi 4.0 !!! You must remove old files and set your 
Windows System directory, else SQLDIR40.BPL will be copied at C:\WINNT\SYSTEM32.

You will see in column "Path" subdirectories in Delphi directories, you
can enter full path for install package.
The new components should now be available in the Data Access group. The
following dcu-files and lib-files should be necessarily installed: 
	SDConsts.dcu,
	SDCSql.dcu,
	SDOra.dcu, 
	SDCsbSrv.dcu,
	SDEngine.dcu,
	SDSrvLog.dcu, 
	SDSrvLog.dfm,
	DclSql30.dpl or DclSql40 (for Delphi 4.0),
	SqlDir30.dcp or SqlDir40.dcp,
	SqlDir30.dpl or SqlDir40.bpl(in the Windows system directory: WINNT\SYSTEM32, WIN95\SYSTEM).

   Be sure to include the path in each project's "Search Directory" to
avoid file not found errors at compile time.
This is found in the "Options" for the project on the "Directories" tab.
   At the end of installation of package collection Delphi 3.02 displays 
Update Library Search Path dialog for updating global Library Path of 
Environment Options. In this dialog check path only for library files.
   For converting the existing applications, using BDE data access a
component it is necessary to open dfm-file (as text) and to replace
TDatabase on TSDDatabase, TQuery on TSDQuery and etc. Then make this
in a pas-file.

  The evaluation version does not have any restriction. It displays 
reminder-dialog at startup Delphi IDE and when application performs
first connection to a database.

---------------------------------
DEMO-PROGRAMS
---------------------------------

QueryUpd

   Demo-program can be connected to any database, which you choose.
Query test execute any SQL statement and diplay result in grid.
For testing cached updates necessary create the test-table for that
press the button "Create Table". Then it is possible to press "Test Update".
After viewing the demo the test-table can be removed by pressing the
button "Drop Table".

Threads

   Demo-program can be connected to any database, which you choose.
Program demonstrates an execution queries at the some threads. Before
testing you need to create the test tables for that press the button 
"Create Tables". Then you can enter desired quantity of the rows for 
inserting and press "Insert Data". You can see the inserted rows after
press button "Select Data" at any moment. After viewing the sample 
the test-table can be removed by pressing the button "Drop Tables".

---------------------------------
KNOWN PROBLEMS
---------------------------------

   For Oracle:
   1. If the LONG-column (or LONG RAW) is equal NULL and is located last
in INSERT-statement, then all columns are inserted as NULL (tested
on SQLNet 2.3.2 & Oracle Server 7.3.3).

   2. If you get "External Exception C0000008" or "Access Violation" error 
with Oracle SQL*Net 2.3.3 that look at the following links:

	http://www.borland.com/devsupport/bde/qanda/641.html
		or
	http://www.borland.com/devsupport/sqllinks/pub-73.html

---------------------------------
CONTACTING AUTHOR
---------------------------------

If you have any problems send me the following information:
- what server(name, version) you use;
- what software client(SQL*Net and its version or SQLBase Client) you use;
- Delphi version;

Any questions or suggestions send E-mail to: sheino@cit.org.by

Welcome to SQLDirect Home Page (http://www.cit.org.by/users/sheino/sqldir.htm)

Thanks and I hope to hear from you.


Yuri Sheino
CIT  Center of Information Technology.
Minsk, Belarus.