
Connection Class
================

   This class represents a unique session with a data source. The term
   data source covers a wide range from SQL bases dbcs to files which
   some kind of internal structures (e.g. XML).

   Depending on the functionality supported by the source, some
   collections, methods, or properties of a Connection object may
   not be available.

Constructors
============

   None


Attributes
==========

   State   - Status of the connection which may idle, active
   Mode    - Returns the open mode of  the connection
   Version - Version of the data source
   Id      - Identifier provided by the data source


Methods
=======

   Open         - Connect to a certain data source
   Close        - Close the connection to the data source

   Modify_Command- create a new Modifier instance. 
   Query_Command - create a new Query instance.


Exceptions
==========

  Open_Failure - Failure to open the the data source
  Mode_Error   - Trying to execute a write operation on a read only
                 connection.
  Usage_Error  - Trying top open a connections wich already is open

Helpers
=======
   Is_Open     - True if connection is active


Example
======= 

procedure Test is

   con :  Connection.ODBC.Object;

begin

   Open( con, "db=gnade login=gnade passwd=gnade", Mode => Query );

   .........perform data manipulations ......   

   Close( con );

exception

   when Connection_Failure =>


end Test;


