
HyperBase 1.0  (release)
========================

Drop-in Borland ClientDataset Redistributables replacement. 

TABLE OF CONTENTS
-----------------
Latest changes
Overview
Features
Installation
Features
Limitations
License
Ordering
Technical support

Latest changes
--------------
Version 1.0
[*] Release: full-featured MIDAS II compilant

Version 0.95
[+] BCD support 32 significant digits 

Version 0.94
[+] Implemented: embedded datasets
[+] Implemented: delayed details

Version 0.93
[+] Implemented: constraints, default expressions

Version 0.92
[+] Implemented: ADT fields, array fields

Version 0.91
[+] Implemented: aggregates
[+] Implemented: delayed blobs, RefreshRecord
[+] Improved memory management

Overview
--------
HyperBase is a dynamic-link library that implements full-featured Borland 
MIDAS II core DLL (DBClient.dll). It allows developers to replace original
MIDAS core and to avoid purchasing MIDAS Deployment License for multi-tier 
programs.

HyperBase implements IDSBase, IDSCursor, IDSWriter interfaces that compatible 
with original. HyperBase allows to use all standart MIDAS components without 
any code modifications.

Features
--------
HyperBase allows to use ALL FEATURES of Borland MIDAS II:

  - database-independent in-memory dataset;
  - indexes: unique, ascending, descending, case insensitive, partial;
  - fast indexed locate;
  - ranges, SetToKey, GotoKey and so on;
  - filtering: user-defined, expressions;
  - editing history: savepoints, undo, record revert;
  - delta extraction;
  - streaming;
  - aggregates;
  - ADT and array object fields;
  - embedded datasets;

HyperBase EXTENDS functionality of Borland MIDAS:

  - changes in embedded datasets can be applied to the provider;
  - array fields support for all types of elements;

Installation
------------
Kind: replacement. HyperBase registers COM objects like DBClient.dll does.
COM objects registered with CLSIDs known to standart components and can be used
without any code modifications.

1. Backup existing DBClient.dll.
2. Copy DBClient.dll into Windows\System32 directory.
3. Register DLL with regsvr32.exe.

Kind: alternative. HyperBase registers COM objects with alternative CLSIDs 
that unknown to standart components. Developers should write new or modify 
standart components to use these CLSIDs.

1. Backup existing DBClient.dll.
2. Copy DBClient.dll into Windows\System32 directory. 
3. Rename DBClient.dll to HBClient.dll.
4. Register DLL with regsvr32.exe.

Alternative CLSIDs:

  CLSID_HBDSBase:     TGUID  = '{9C150A61-36E0-11D3-B5C1-4854E828D2EB}';
  CLSID_HBDSCursor:   TGUID  = '{9C150A63-36E0-11D3-B5C1-4854E828D2EB}';
  CLSID_HBDSWriter:   TGUID  = '{9C150A65-36E0-11D3-B5C1-4854E828D2EB}';
  CLSID_HBDSReader:   TGUID  = '{9C150A67-36E0-11D3-B5C1-4854E828D2EB}';

Limitations
-----------
1. HyperBase core can be used with application servers compiled with Delphi 4.
If the application server is compiled with Delphi 3 it uses IDPROV32.DLL 
to create datapackets that cannot be readed by HyperBase clients.

License
-------
HyperBase is a shareware product. This means:

  - All copyrights to HyperBase are exclusively owned by the author - 
    Vladimir Gaitanoff
  - Anyone may use this software during a test period of 30 days. 
    Following this test period of 30 days, if you wish to continue 
    to use HyperBase, you MUST register.
  - Once registered, the user is granted a non-exclusive license to 
    use HyperBase on a number of computers as mentioned in License section
    at a time, for any legal purpose. The registered HyperBase software may 
   not be rented or leased, but may be permanently transferred, if the person 
    receiving it agrees to the terms of this license. If the software is an 
    update, the transfer must include the update and all previous versions. 
  - The HyperBase unregistered shareware version may be freely distributed, 
    provided the distribution package is not modified. No person or 
    company may charge a fee for the distribution of HyperBase without 
    written permission from the copyright holder. 
  - HyperBase IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED 
    OR IMPLIED. YOU USE THIS SOFTWARE AT YOUR OWN RISK. THE AUTHOR WILL 
    NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER 
    KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.
  - You may not use, copy, emulate, clone, rent, lease, sell, modify, 
    decompile, disassemble, otherwise reverse engineer, or transfer the 
    licensed program, or any subset of the licensed program, except as 
    provided for in this agreement. Any such unauthorised use shall 
    result in immediate and automatic termination of this license and 
    may result in criminal and/or civil prosecution. All rights not 
    expressly granted here are reserved by Vladimir Gaitanoff.
  - Installing and using HyperBase signifies acceptance of the terms and 
    conditions of this license.
    If you do not agree with the terms of this license you must remove 
    HyperBase files from your storage devices and cease to use the product.

Ordering
--------
There are four type of licence present:

1. Personal   ($29) - one computer licence.

2. Company   ($149) - any number of computers within single company.

3. Developer ($299) - licence for software developers. Allows to distribute
HyperBase as a part of developed software packages.

4. Source    ($649) - licence for software developers. 

Source licence allows:
  - make modifications and compile own version(s) of HyperBase core project;
  - distribute any part of HyperBase core project in the form .EXE, .DLL or 
  any other Windows(tm) executable as a part of developed software packages.

Source licence don't allows:
  - distribute any part of original or modified HyperBase core project 
    as a standalone package.

Technical support
-----------------
Technical support is available by e-mail addressed to Vladimir Gaitanoff at 
vg@tsinet.ru.

I will try to reply to all messages but only registered users can expect 
a quick answer. 

Please include the following information when requesting support:

- program version (from Explorer's "Properties" dialog)
- registred name (if you're a registered user)
- where did you get HyperBase from (http or ftp site). 
- Delphi/C++ Builder version (including updates installed)
- Windows 95/98/NT version (including service packs and other fixes 
  installed)
- a full description of your problem - provide as much information 
  as possible to allow duplication of the problem: place of error, 
  sequence of your actions, etc.
- files causing problems may be submitted in one of two ways:
  * by e-mail attachment, but only if less than 1MB in size
  * by URL

Note: before requesting technical support, please ensure you are using 
the latest version of HyperBase available from 

http://www.tsinet.ru/~vg
                        
-------------------------------------------
Vladimir Gaitanoff
WWW:             http://www.tsinet.ru/~vg/
E-mail:          vg@tsinet.ru


