################################################################################ # # File name: README # Project: DBD::Illustra # Description: README file # # Author: Peter Haworth # Date created: 11/08/1998 # # sccs version: 1.9 last changed: 10/13/99 # # Copyright (c) 1998 Institute of Physics Publishing # You may distribute under the terms of the Artistic License, # as distributed with perl, with the exception that it cannot be placed # on a CD-ROM or similar media for commercial distribution without the # prior approval of the author. # ################################################################################ This is version 0.04 of DBD::Illustra. Changes from version 0.03: * Included dbd-illustra.pod. This is the text describing Illustra from Tim Bunce and Alligator Descartes' book about DBI, although it's not going to be included now, due to Illustra's unpopularity * Support for bind parameters * Support for reading large objects * Return correct number of rows in all cases * Partial $sth->{TYPE} support INSTALLING What you need to install this module: Perl version 5.004 or later DBI version 1.0 or later Illustra client library and include files An ANSI C compiler If the environment variable $MI_HOME is not set, Makefile.PL will look in a couple of likely places (currently /opt/illustra and /usr/local/illustra). It is looking for the directories $MI_HOME/lib/ and $MI_HOME/h/ for libraries and include files, respectively. If these directories aren't found, you won't be able to compile the module. With $MI_HOME set or using the default, type 'perl Makefile.PL' to build the makefile and 'make' to build the module. 'make install' will install. TESTING DBD::Illustra uses Jochen Wiedmann's test suite. Before running the test you should set the environment variables DBI_DSN, DBI_USER and DBI_PASS to give write access to a database on your system. DBI_DSN defaults to dbi:Illustra:test