GNat Ada 95 Database Environment - (GNADE)

Version 1.2.0

Editor M.Erdmann

2.11.2001

Contents

This release of the GNADE project is intended for building with the GNU Ada Translator on the platforms Linux, Solaris and Windows NT/95/2000.

Supported Databases

Even the GNADE project except for the native data base bindings is expected to work with all ODBC compliant data base products. The following products are known to work with GNADE assuming, that you are using the correct driver manager (see section "Other Components").

Component Description Version OS Distribution/Source of the release
Postgres PostgreSQL Database 7.0.3
Linux - Redhat 7.0
Linux - SuSe 7.0
Solaris 7
Windows NT/2000
www.postgresql.org
Mimer Mimer SQL RDBMS 8.2
Solaris 7/8
Linux
Windows NT
www.mimer.com
MySQL MySQL Database
MyODBC

3.23.22

2.50.36-1

Linux www.mysql.com
3.23.35a

2.50.36

Windows 2000 www.mysql.com
MS SQL Server 7.0 Windows 2000 Microsoft
SQL Server 2000 Windows 2000 Microsoft
Oracle Lite 8i Windows 95 Oracle

The GNADE project installation procedure provides for theses product test data bases. If your data base is not listed below, the GNADE project will be very likely usable but the test data base has to be installed manually.

Copyright, License and Authors

The GNU Public License (GPL) applies with the following extension to all software components in this release

As a special exception, if other files instantiate generics from GNADE Ada units, or you link GNADE Ada units or libraries with other files to produce an executable, these units or libraries do not by itself cause the resulting executable to be covered by the GNU General Public License. This exception does not however invalidate any other reasons why the executable file might be covered by the GNU Public License.

The documentation has been put under the Free GNU Documentation License.

The authors and copyright holders of the GNADE project are:

Jürgen Pfeifer juergen.pfeifer@gmx.net>
Michael Erdmann Michael.Erdmann@snafu.de
Sune Falck sunef@hem.passagen.se
François Fabien fr.fabien@infonie.fr

Contact

Bug Reports http://sourcefore.net/projects/gnade M.Erdmann
GNADE Discussions http://cert.uni-stuttgart.de/mailman/listinfo/gnade-dev

gnade-dev@cert.uni-stuttgart.de

Florian Weimer
Project Page http://gnade.sourceforge.net/

http://sourcefore.net/projects/gnade

M.Erdmann
Dev. Coordination Michael.Erdmann@snafu.de M.Erdmann

New Features

Feature Req, Short Description Version Comments
426744 ESQL shall be able to handle files with only one procedure in. 1.1.2 complte
473046 ESQL extended types as VARCHAR, VARBINARY 1.1.10 complte

Restrictions

Fixed Problems

Problems reported earlier then 0.9o are listed in the release note 1.1.2.

Bug Ref. Fixed with

Version

Short Description Comments
421587 0.9o ObjectAda Unrestricted_Access not supported. Unrestricted access is not used any more.
425280 1.1.1 Name of esql not changed every where GNUmakefile updated
425409 1.1.1 sql_standard prefix not handled correct gesql updated
425410 1.1.1 whenever sqlwarning faulty gesql updated
425510 1.1.1 gpl.sgml missing in distribution MANIFEST updated
421586 1.1.2 GNUmake on Windows 95 does not work Makefile changed
435712 1.1.2 Wrong debug code generated esql translator and esql_support updated
427531 1.1.2 gesql file corrupt but available The output file will always be deleted if some error during translation occurred.
427557 1.1.2 gesql command line not correct evaluated driver changed.
427764 1.1.3 Relastion missing error not recognized Code generation has been changed
427747 1.1.3 help message shown twice driver.adb changed
427750 1.1.3 Dynamic SQL DECLARE statement missing documentation updated
427748 1.1.3 Some_Error exception undefine code generator updated
430075 1.1.3 -noniso92 switch does not exist code generator updated
430077 1.1.3 -noiso92 switch not evaluated code generator updated
429984 1.1.4 Result evaluation done twice code generator updated
430751 1.1.4 Notfound class not correctly evaluated code generator updated
430752 1.1.4 not found exception raised twice code generator updated
430760 1.1.4 Number of affrected rows missing is SQLC code generator updated
435982 1.1.5 Wrong package name found esql parser updated
435872 1.1.5 Debug information missleading esql code generator updated
437590 1.1.5 Example simple does not work with MySQL GNU.DB.SQLCLI and esql_support.odbc

updated.

439149 1.1.5 SQLCA Not inserted correctly esql parser updated
439151 1.1.5 Handling of inner exception -noiso92 switch changed to -iso92 switch
439274 1.1.5 Mimer SQL not correctly installed Makefile updated
439274 1.1.5 MimerSQL, Tables of test db not found. Documentation updated
478056 1.1.6 Move in ESQL raises exception esql_support.adb updated
470357 1.1.6 simple.gpq does not handle conn. error simple.gqp updated
471060 1.1.7 esql_parse does not compile esql_parser.adb updated
471082 1.1.7 Useless evaluate code generated esql_parser.adb updated
473062 1.1.8 Package name in host var. decl. not eval. esql_parser.adb updated
473104 1.1.8 Query result not evaluated by gesql esql_parser.adb updated
473259 1.1.9 esql samples do not complie esql_parser.adb updated
475736 1.1.10 VARBINARY not handled correctly gnu-db-esql_support-odbc.adb
471061 1.1.10 seperator for Win 9x not handled GNUmakefile
433671 1.1.10 Win 2000 installation failes modules.adb
477766 1.2.0 longblob not correctly handled gnu-db-mysql.adb, gnu-db-mysql.ads

Known Problems

Bug Ref. Short Description Comments
411141 Missing ";" for "EXEC SQL DECLARE DB01 D" This problem may be bypassed by putting a semicolon in the source code.
421586

ODBC does not compile with ObjectAda

This is a problem with the Object Ada compiler which has to be fixed there.

Installation

The GNADE code and the documentation is distributed in the following files:

File Contents
gnade-src-1.2.0.tar.gz Complete GNADE source code distribution GNU compressed tar file
gnade-src-1.2.0..zip Complete GNADE source code distribution as ZIP file.

The installation of this software requires the following components:

Component Version Origin
gzip 1.2.4 GNU
unzip 5.42 Infozip
zip 2.2 Infozip
tar - GNU or native
autoconf*1 2-13-9 GNU
make 3.79.1 GNU
gnat 3.13p

3.12

ALT distribution
gawk 3.0.3 GNU

The autoconf utility is only required on Linux/Unix Systems if the configuration scripts have to be changed. For window systems a special set of makefiles in the directory ./win32 is provided which are not using the autoconf facility.

Installation on Linux/Unix

Unpacking and Configuration

$ gunzip -c gnade-src-linux-gnu-<version>.tar.gz | tar xvf -
$ cd gnade-src-linux-gnu-<version>
$ ./configure <dbname>

As dbname the following values are allowed.

If the value is omitted because your data base product is not listed,, all subsequent steps regarding the data base installation may be skipped and you have to install the test database manually.

Installation of the Database

Depending on the installation of the data base you have specified in the configure script command, you have to execute the following step either by using a DBA account our you may use your own user account.

$ su ..dba..
$ make createuser

After the database and the database user has been configured, the ODBC interface has to be configured. The directory ./samples/sample_db contains sample files for the unixODBC driver manager. The files odbc.ini.sample odbcinst.ini.sample have to be copied to /etc/odbc.ini and /etc/ odbcinst.ini.sample.

Compiling an testing

After the creation of the data base user, the final build may be done by:

$ make

Test code is located under ./samples. In order to test the functionality of the ODBC interface use the examples in ./odbc or ./esql.

If it does not work

If this installation procedure fails you may use the Makefile under ./win32. This makefile is known to work at least on Solaris well if the correct driver manager is installed (see section other components).

Installation on Windows NT

For window users a zip file is provided. In order to install perform the following steps:

> unzip gnade-src-linux-gnu-<version>.zip
> cd gnade-src-linux-gnu-<version>/win32
> make 
                                   
The issue regarding the installation of a data base user has to be done by hand. 
The windows makefile  uses the make.conf file which is prebuilt by the ./configure script. Any configuration
change has to be done there. Please refer to the README file in ./win32.

Other components

The following Driver Manager are known to work with the release:

Component Description Version Operating System Comments
unixODBC ODBC Driver Manager 1.8.12-2 Linux www.unixodbc.org
2.0.5 Solaris 8

www.unixodbc.org

ODBC Driver Manager 3.5.10 Windows 95 Microsoft

The iODBC 3.04 implementation on Solaris seems to have a problem with the handling of cursor states. It should not be used.

Contributions

Special regards to the following persons which have contributed to the project:

Florian Weimer Florian.Weimer@RUS.Uni-Stuttgart.DE
François Fabien. fr.fabien@infonie.fr
Pascal Obry p.obry@wanadoo.fr


Document Version: $Date: 2001/11/03 20:16:33 $ $Revision: 1.1 $