DBD::TimesTen -- DBD module interfacing the TimesTen databases.
$Id: README 548 2006-11-26 23:51:09Z wagnerch $
Copyright (c) 1994,1995,1996,1997,1998 Tim Bunce
portions Copyright (c) 1997,1998,1999,2000,2001,2002 Jeff Urlwin
portions Copyright (c) 1997 Thomas K. Wenrich
portions Copyright (c) 2006 Chad Wagner
You may distribute under the terms of either the GNU General Public
License or the Artistic License, as specified in the Perl README file.
PLEASE READ THE ENTIRE README FILE CAREFULLY !
**** NOTICE ******** NOTICE ******** NOTICE ******** NOTICE ******** NOTICE ****
This is a BETA version of the driver, since I am not actively using TimesTen
I have not encountered every issue. This driver is based on DBD::ODBC,
since the TimesTen client can be directly linked to any ODBC-based
application. The intent is to eventually code all of the TimesTen
extensions into this driver.
**** NOTICE ******** NOTICE ******** NOTICE ******** NOTICE ******** NOTICE ****
INTRODUCTION:
This driver is based on DBD::ODBC 1.13. Thanks to Tim Bunce, Jeff Urlwin,
and the contributors of DBD::ODBC, as they have made this driver fairly
easy to implement with TimesTen.
There is more work to be done here, it appears the bulk inserts need to
be done and probably a bunch of other things.
*BEFORE* BUILDING, TESTING AND INSTALLING this you will need to:
Build, test and install Perl 5 (as per DBI specifications/compatibility)
It is very important to TEST it and INSTALL it!
Build, test and install the DBI module (at least DBI 1.201).
It is very important to TEST it and INSTALL it!
Remember to *read* the DBI README file!
Remember to *read* the DBD::TimesTen.pm POD documentation!
BUILDING:
set-up these environment variables:
DBI_DSN The dbi data source, e.g. 'dbi:TimesTen:YOUR_DSN_HERE'
DBI_USER The username to use to connect to the database
DBI_PASS The username to use to connect to the database
TT_HOME (Unix only) The dir your driver manager is installed in
perl Makefile.PL
make (or nmake, if VC++ on Win32)
make test (or nmake, if VC++ on Win32)
TESTING
make test
make test TEST_VERBOSE=1 (if any of the t/* tests fail)
make install (if the tests look okay)
IF YOU HAVE PROBLEMS:
Do not hand edit the generated Makefile unless you are completely sure
you understand the implications! Always try to make changes via the
Makefile.PL command line and/or editing the Makefile.PL.
You should not need to make any changes. If you do *please* let me
know so that I can try to make it automatic in a later release.
Please post details of any problems (or changes you needed to make) to
chad.wagner@gmail.com. But note...
** IT IS IMPORTANT TO INCLUDE THE FOLLOWING INFORMATION:
1. A complete log of a all steps of the build, e.g.:
perl Makefile.PL (do a make realclean first)
make
make test
make test TEST_VERBOSE=1 (if any tests fail)
2. Full details of which software you are using, including:
Perl version (the output of perl -V)
3. A repeatable test case, including:
Tables
Data
Perl code
It is important to check that you are using the latest version before
posting.
===============================================================================
Other info:
DBI 'home page': http://dbi.perl.org
perldoc DBI
perldoc DBD::TimesTen
End.