*** BEFORE BUILDING, TESTING AND INSTALLING this you will need to:

Build, test and install Perl 5 (Preferrably 5.006_00 or later) It is very important to TEST it and INSTALL it!

Build, test and install the DBI module (at least DBI 1.21). It is very important to TEST it and INSTALL it!

Remember to read the DBI README file and this one CAREFULLY!

Ensure the following DB2 product is installed.

        DB2 Application Development Client v7.2 or later
            Included with the DB2 Personal Developer's Edition and the
            DB2 Universal Developer's Edition

The Application Development Client can be downloaded here:

http://www.ibm.com/software/data/db2/udb/support/

*** BUILDING:

On UNIX:

perl Makefile.PL # use a perl that's in your PATH make
make test
make install (if the tests look okay)

On Windows:

perl Makefile.PL
nmake
nmake test
nmake install

*** TESTING:

All Platforms:
Edit the file connection.pl in the folder tests so that it looks like the following:

$USERID="userid";
$PASSWORD="password";
$PORT=50000;
$HOSTNAME="localhost";
$DATABASE="database";
$PROTOCOL="TCPIP";

The next section has details about the trusted context user. If you dont have trusted users set specifically, then you may leave this section as is and the testcase for the trusted context would fail. This is an expected behavior.

The details for fakeport etc can be left untouched.

Run the test suite by running the following command: $ perl run-tests.pl

*** IF YOU HAVE PROBLEMS:

Please read the CAVEATS files which includes important information, including tips and workarounds for various platform-specific problems.

*** SUPPORT INFORMATION:

Technical support for the DBD::DB2 driver is provided by IBM through its service agreements for DB2 UDB. Information on DB2 UDB service agreements and support can be found on the Web at

http://www.software.ibm.com/data/db2/db2tech

For other DBD::DB2 information, please see

http://www.software.ibm.com/data/db2/perl

For documentation about DB2 and CLI, please see:

http://publib.boulder.ibm.com/infocenter/db2help/index.jsp

Comments/suggestions/enhancement requests may be sent to

opendev@us.ibm.com

Please see the following files for more information:

        CAVEATS - important build/usage information
        DB2.pod - an example perl script
                - an explanation of attribute hashes

*** MAILING LISTS

As a user or maintainer of a local copy of DBD::DB2, you need to be aware of the following addresses:

The DBI mailing lists located at

        dbi-announce@perl.org          for announcements
        dbi-dev@perl.org               for developer/maintainer discussions
        dbi-users@perl.org             for end user level discussion and help

To subscribe or unsubscribe to each individual list please see

http://lists.perl.org/

or send an empty email to the following addresses

        dbi-announce-subscribe@perl.org
        dbi-dev-subscribe@perl.org
        dbi-users-subscribe@perl.org