     JDBCREADME.TXT
     DataDirect Technologies
     DataDirect Connect for JDBC
     Release 3.7 (Build 0032)
     May 2008

***********************************************************************
Copyright (c) 2008 Progress Software Corporation. All rights reserved. 

DataDirect Connect is a registered trademark of Progress Software 
Corporation in the U.S. and other countries. Any other trademarks or 
service marks contained herein are the property of their 
respective owners.
***********************************************************************

This README file contains additional database driver information not 
included in the DataDirect Connect(R) for JDBC(TM) documentation or the 
online help.

CONTENTS

Changes Since 3.7 Service Pack 1 (SP1)
Changes Since 3.7 GA
Release 3.7 Features
Installation
Available DataDirect Connect for JDBC Drivers
Notes, Known Problems, and Restrictions
Using the Online Documents
DataDirect Connect for JDBC Files
Third-Party License Agreements


     Changes Since 3.7 Service Pack 1 (SP1)

- The DB2 driver was certified against DB2 9.5 for Linux/UNIX/Windows.

- Added a new String connection option, CurrentFunctionPath, to specify 
  the default path that is used to resolve unqualified function names 
  and data type references in dynamically prepared SQL statements. 
  It also is used to resolve unqualified stored procedure names 
  specified in CALL statements. The value of this property is a 
  comma-separated list of DB2 schema names. This property sets the 
  DB2 CURRENT PATH special register. The default is null.


     Changes Since 3.7 GA

New Features and Enhancmements
------------------------------
* New MySQL driver
* Support for the following new database versions:
  - DB2 v9.1 for z/OS
  - Informix 11
  - Oracle 11g
* DB2 driver features and enhancements:
  - New Database connection property synonym for the DatabaseName 
    connection property
  - Ability to use the DatabaseName connection property for all 
    DB2 versions
  - Support for new DB2 Graphic data types
  - Support for DB2 v9.1 for z/OS, including support for:
    * New DB2 v9.1 for z/OS data types
    * Distributed transactions
    * SQL Procedures
    * IPv6 addresses
* Informix driver features and enhancements:
  - New Database connection property synonym for the DatabaseName
    connection property
* Oracle driver features and enhancements:
  - Support for Oracle 11g, including support for server result set
    caching and XQuery functions.
* Microsoft SQL Server and Sybase driver features and enhancements:
  - New Database connection property synonym for the DatabaseName 
    connection property.
  - New LongDataCacheSize connection property controls whether the 
    driver caches long data (images, pictures, long text, or binary 
    data) in result sets.

For more information about these changes, refer to the DATADIRECT 
CONNECT FOR JDBC USER'S GUIDE AND REFERENCE SUPPLEMENT.

New MySQL Driver
----------------
See "DataDirect Connect(R) for JDBC Files" later in this readme for the 
complete list of files, including files for the MySQL driver.


     Release 3.7 Features

All Drivers
-----------
     * Support for the following JDBC 4.0 features:
       - Connection validation
       - Client information storage and retrieval
       - Auto-load driver classes (when using Java SE 6)
     * IPv6 support.
     * Enhanced support for returning auto-generated keys.
     * New integrated statement pooling monitoring feature.
     * Hibernate certification.
     * Reauthentication and Delegation of Credentials support in the 
       DataDirect Connection Pool Manager.
     * New ConvertNull connection option to control how 
       data conversions are handled for null values.
     * New ImportStatementPool connection option for configuring a 
       file to load the contents of the statement pool.  
     * New MaxStatements synonym for the MaxPooledStatements 
       connection option.
     * New QueryTimeout connection option for setting a default 
       query timeout.
     * Performance enhancements.

         
DB2
---
     * Support for DB2 V9.1 for Linux/UNIX/Windows, including 
       support for the new XML data type.
     * Support for DB2 UDB V5R4 on iSeries including:
       - JTA support
       - 2-MB length for SQL statements
       - 128-byte column names
       - RAISE_ERROR function
       - New timestamp identifier format
       - SQLDA record changes
       - Blanks in hexadecimal literals
       - Instead of triggers
       - ENCRYPT_TDES function
     * Reauthentication support for switching the user associated with 
       a connection to another user. 
     * Enhanced Kerberos authentication support:
       - Support for DB2 UDB for z/OS
       - Support for MIT Kerberos for DB2 UDB for Linux/UNIX/Windows 
         and DB2 UDB for z/OS.
     * DB2-specific encryption support.
     * New EncryptionMethod connection option for configuring 
       data encryption across the network.
       
Informix
--------
     * New FetchBufferSize connection option for configuring 
       The size (in bytes) of the fetch buffer.
     * Support for multiple output parameters for stored procedures.

Oracle
------
     * Reauthentication support for switching the user associated with 
       a connection to another user. 
     * Kerberos authentication support, including support for 
       Windows Active Directory and MIT Kerberos.
     * SSL encryption support.
     * Support for Insert/Update/Delete statements with a 
       RETURNING clause.
     * Asynchronous Commit support for Oracle 10g R2.
     * Enhanced support for returning and inserting/updating 
       data stored in XML columns.
     * Support for UROWID data type.
     * New EncryptionMethod connection option for configuring 
       data encryption across the network.
     * New connection options for configuring how the driver 
       implements SSL encryption, including:
       - ValidateServerCertificate and HostNameInCertificate 
         connection options for configuring certificate validation 
         behavior.
       - TrustStore and TrustStorePassword connection options 
         For configuring truststore information.
       - KeyStore, KeyStorePassword, and KeyPassword connection options
         for configuring keystore information for SSL client 
         authentication.
     * New SysLoginRole connection option for configuring whether the 
       user is logged on the database with the Oracle system privilege 
       SYSDBA or the Oracle system privilege SYSOPER.

SQL Server
----------
     * Reauthentication support for switching the user associated with 
       a connection to another user. 
     * Kerberos authentication support for MIT Kerberos.
     * SSL encryption support.
     * New EncryptionMethod connection option for configuring 
       data encryption across the network.
     * New connection options for configuring how the driver 
       implements SSL encryption, including:
       - ValidateServerCertificate and HostNameInCertificate 
         connection options for configuring certificate validation 
         behavior.
       - TrustStore and TrustStorePassword connection options 
         for configuring truststore information.
     * New DescribeParameters connection option to control whether 
       the driver will attempt to determine, at execute time, how to 
       send String parameters to the server based on the database 
       data type.

Sybase
------
     * Support for Sybase 12.5.4.
     * SSL encryption support.
     * Support for DOUBLE PRECISION data type.
     * New EncryptionMethod connection option for configuring 
       data encryption across the network.
     * New connection options for configuring how the driver 
       implements SSL encryption, including:
       - ValidateServerCertificate and HostNameInCertificate 
         connection options for configuring certificate validation 
         behavior.
       - TrustStore and TrustStorePassword connection options 
         for configuring truststore information.
     * New LongDataCacheSize connection option controls whether 
       the driver caches long data in results sets.
     * New PacketSize connection option for configuring the 
       database protocol packet size.
     * New TransactionMode connection option to control 
       how the driver delimits the start of a local transaction.

Enhancement Requests and Fixes
------------------------------
The following enhancement requests and fixes have been implemented 
in this release:

Issue # | Component Modified | Description of Issue

DEF0001394 | All Drivers | DriverPropertyInfo description for the 
InsensitiveResultSetBufferSize property has a misspelling in it.

DEF0001413 | All Drivers | Support auto-generated key methods which 
take column names and column indexes.

DEF0001487 | All Drivers | Support isFirst method for forward only 
result sets. 

DEF0001638 | All Drivers | Support IPv6.

DEF0001875 | All Drivers | Provide a way to clear the contents of a 
connections statement pool.

DEF0002908 | All Drivers | Provide an option to set the default value 
for query time out or to disable the query timeout functionality.

DEF000766 | DB2, Oracle, SQL Server, Sybase | Support Kerberos OS 
authentication from UNIX.

DEF0001669 | DB2, Oracle, SQL Server | Support Reauthentication / 
Impersonation.

DEF0000133 | Oracle, SQL Server, Sybase | Support SSL encryption.

DEF0002644 | Oracle, SQL Server | Build 64-bit Authentication DLL for 
x64 platform.

DEF0001474 | DB2 | Support JTA when connected to DB2 for AS/400. 

DEF000505 | Oracle | Support the Oracle UROWID data type.

DEF0001262 | Oracle | Logon with administrative privileges, sysdba for 
example.

DEF0001983 | Oracle | Support RETURNING clause on INSERT, UPDATE and 
DELETE statements for Oracle.

DEF0002838 | SQL Server | Cannot return a VARCHAR(max) data type from a 
function or stored procedure.

DEF0002875 | SQL Server | "Unsupported data conversion" occurs using 
getDate().


     Installation

For All Users
--------------
* A complete installation of DataDirect Connect for JDBC requires 
approximately 13 MB of hard disk space.

* At a minimum, J2SE 1.3 or higher is required to use 
  DataDirect Connect for JDBC. Standard installations of J2SE on some 
  platforms do not include the jar file containing the extended 
  encoding set that is required to support some of the less common 
  database code pages. To verify whether your J2SE version provides 
  extended code page support, check your J2SE installation for the 
  following file:

  - For J2SE 1.3 and 1.3.x, i18n.jar must be installed in the 
    lib subdirectory of your J2SE installation directory.

  - For J2SE 1.4 and higher, charsets.jar must be installed 
    in the lib subdirectory of your J2SE installation directory.

  If you do not have the required file for your J2SE version, 
  make sure that you install the international version of J2SE.

* The PDF versions of the DataDirect Connect for JDBC books are 
  no longer an installable option with the product for both the 
  GUI installer and the command-line installer (the ib flag has 
  been deprecated). The PDF documentation is provided on the 
  product CD and also on the DataDirect Technologies Web site:

  http://www.datadirect.com/techres/jdbcproddoc/index.ssp

  The HTML versions of the books are installed in the help subdirectory 
  of your product installation directory.

* After you have started the installation process, as described in the 
  DATADIRECT CONNECT FOR JDBC INSTALLATION GUIDE (JDBCIG.PDF), a 
  progress bar is displayed on the screen. If you choose to cancel the 
  installation at this stage, files that have already been copied to 
  your machine will not be removed. You must delete these files 
  manually from the installation directory.

* The DataDirect Connect for JDBC installer accepts multiple product 
  keys. For details, refer to the DATADIRECT CONNECT FOR JDBC 
  INSTALLATION GUIDE (JDBCIG.PDF).

For UNIX Users
--------------
If you receive an error message when executing any DataDirect Connect 
for JDBC shell script (.sh files), including installer.sh, make sure 
that the file has EXECUTE permission. To do this, use the chmod 
command. For example, to grant EXECUTE permission to the installer.sh 
file, change to the directory containing installer.sh and enter:

chmod +x installer.sh


     Available DataDirect Connect for JDBC Drivers

See the DATADIRECT CONNECT FOR JDBC INSTALLATION GUIDE (JDBCIG.PDF) for 
a complete list of supported databases.

Drivers
-------
DB2 (db2.jar) 
Informix (informix.jar) 
MySQL (mysql.jar)
Oracle (oracle.jar) 
SQL Server (sqlserver.jar) 
Sybase (sybase.jar)


     Notes, Known Problems, and Restrictions

The following are notes, known problems, or restrictions with 
Release 3.7 of DataDirect Connect for JDBC.

Starting the Performance Tuning Wizard
---------------------------------------
When starting the Performance Tuning Wizard, security features set in 
your browser can prevent the Performance Wizard from launching. A 
security warning message is displayed. Often, the warning message 
provides instructions for unblocking the Performance Wizard for the 
current session. To allow the Performance Wizard to launch without 
encountering a security warning message, the security settings in your 
browser can be modified. Check with your system administrator before 
disabling any security features.

Distributed Transactions Using JTA
----------------------------------
If you are using JTA for distributed transactions, you may encounter 
problems when performing certain operations, as shown in the following 
examples:

SQL SERVER 7

1. Problem: SQL Server 7 does not allow resource sharing because it 
cannot release the connection to a transaction until it commits or 
rolls back.

  xaResource.start(xid1, TMNOFLAGS)
  ...
  xaResource.end(xid1, TMSUCCESS)
  xaResource.start(xid2, TMNOFLAGS) ---> fail
 
2. Problem:  Table2 insert rolls back. It should not roll back because 
it is outside of the transaction scope.

  xaResource.start(xid1, TMNOFLAGS)
  stmt.executeUpdate("insert into table1 values (1)");
  xaResource.end(xid1, TMSUCCESS)
 
  stmt.executeUpdate("insert into table2 values (2)");
 
  xaResource.prepare(xid1);
  xaResource.rollback(xid1);
 
SQL SERVER 7 and SQL SERVER 2000

1. Problem: Recover should not return xid1 because it is not yet 
prepared.

  xaResource.start(xid1, TMNOFLAGS)
  xaResource.recover(TMSTARTRSCAN) ---> returns xid1 transaction

This problem has been resolved in DTC patch QFE28, fix number 
winse#47009, "In-doubt transactions are not correct removed from the 
in-doubt transactions list".

This Microsoft issue is documented at 
http://support.microsoft.com/default.aspx?scid=kb;en-us;828748.

All Drivers
-----------
* The DataDirect Connect for JDBC drivers no longer accept connection 
  URLs in the format: 
       
     jdbc:<database_name>://<servername>:<port>

  For example, the following URLs are no longer valid:

     jdbc:db2://myserver:50000
     jdbc:informix://myserver:2003
     jdbc:oracle://myserver:1521
     jdbc:sqlserver://myserver:1433
     jdbc:sybase://myserver:5000
       
  Support for URLs in this format has been deprecated for several 
  releases, but the drivers have continued to accept URLs in this 
  format for backward compatibility. DataDirect Connect for JDBC 
  drivers cannot continue to accept URLs in this format because it 
  causes conflicts with the JDBC drivers provided by the 
  database vendors.

  The supported URL format for DataDirect Connect for JDBC drivers is:

     jdbc:datadirect:<database_name>://<servername>:<port>

  See the DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND REFERENCE 
  (JDBCREF.PDF) for details on specifying connection URLs.

* The DataDirect Connect for JDBC drivers allow 
  PreparedStatement.setXXX methods and ResultSet.getXXX methods on 
  Blob/Clob data types, in addition to the functionality described 
  in the JDBC specification. The supported conversions typically are 
  the same as those for LONGVARBINARY/LONGVARCHAR, except where limited 
  by database support.

* Calling CallableStatement.registerOutputParameter(parameterIndex, 
  sqlType) with sqlType Types.NUMERIC or Types.DECIMAL sets the scale 
  of the output parameter to zero (0). 
  According to the JDBC specification, calling 
  CallableStatement.registerOutputParameter(parameterIndex, sqlType, 
  scale) is the recommended method for registering NUMERIC or 
  DECIMAL output parameters. 

* When attempting to create an updatable, scroll-sensitive result set 
  for a query that contains an expression as one of the columns, the 
  driver cannot satisfy the scroll-sensitive request. The driver 
  downgrades the type of the result returned to scroll-insensitive.

* The DataDirect Connect for JDBC drivers support retrieval of output 
  parameters from a stored procedure before all result sets and/or 
  update counts have been completely processed. When 
  CallableStatement.getXXX is called, result sets and update counts 
  that have not yet been processed by the application are discarded to 
  make the output parameter data available. Warnings are generated when 
  results are discarded.

* The preferred method for executing a stored procedure that generates 
  result sets and update counts is using CallableStatement.execute(). 
  If multiple results are generated using executeUpdate, the first 
  update count is returned. Any result sets prior to the first update 
  count are discarded. If multiple results are generated using 
  executeQuery, the first result set is returned. Any update counts 
  prior to the first result set are discarded. Warnings are generated 
  when result sets or update counts are discarded. 

* The ResultSet methods getTimestamp, getDate, and getTime return 
  references to mutable objects. If the object reference returned from 
  any of these methods is modified, re-fetching the column using the 
  same method returns the modified value. The value is only modified in 
  memory; the database value is not modified.

DB2 (All Platforms)
-------------------
* The ResultSetMetaData.getObject method returns a Long object instead 
  of a BigDecimal object when called on BIGINT columns. In versions 
  previous to DataDirect Connect for JDBC 3.5, the DataDirect Connect 
  for JDBC DB2 driver returned a BigDecimal object.

* Scroll-sensitive result sets are not supported. Requests for 
  scroll-sensitive result sets are downgraded to scroll-insensitive 
  result sets when possible. When this happens, a warning is generated 
  indicating that result set scrollability has been downgraded.

* The DB2 driver must be able to determine the data type of the column 
  or stored procedure argument to implicitly convert the parameter 
  value. Not all DB2 database versions support getting parameter 
  metadata for prepared statements. Implicit conversions are not 
  supported for database versions that do not provide parameter 
  metadata for prepared statements.

DB2 (Windows/UNIX/Linux)
------------------------
* Except for DB2 v8.1 and higher for Linux/UNIX/Windows, Clob 
  data types are limited to a maximum length of 32714 bytes because 
  of DRDA listener limitations.

* Except for DB2 v8.1 and higher for Linux/UNIX/Windows, Blob 
  data types are not supported because of DRDA listener limitations.

DB2 (iSeries)
-------------
Except for DB2 V5R2 and higher for iSeries, Blob and Clob data types 
are not supported.

Oracle
------
* If you install the Oracle driver and want to take advantage of JDBC 
  distributed transactions through JTA, you must install 
  Oracle version 8.1.7 or higher.

* Because JDBC does not support a cursor data type, the Oracle driver 
  returns REF CURSOR output parameters to the application as 
  result sets. For details about using REF CURSOR output parameters 
  with the driver, refer to the DATADIRECT CONNECT FOR JDBC USER'S 
  GUIDE AND REFERENCE (JDBCREF.PDF).

* By default, values for TIMESTAMP WITH TIME ZONE columns cannot be 
  retrieved using the ResultSet.getTimestamp method because the 
  time zone information is lost. The Oracle driver returns NULL when 
  the getTimestamp method is called on a TIMESTAMP WITH TIME ZONE 
  column and generates a SQLException. For details about using the 
  TIMESTAMP WITH TIME ZONE data type with the driver, refer to the 
  DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND REFERENCE (JDBCREF.PDF). 

* The Oracle driver describes columns defined as FLOAT or FLOAT(n) as a 
  DOUBLE SQL type. Previous to DataDirect Connect for JDBC 3.5, the 
  driver described these columns as a FLOAT SQL type. Both the DOUBLE 
  type and the FLOAT type represent a double precision floating 
  point number. This change provides consistent functionality with the 
  DataDirect Connect for ODBC Oracle driver. The TYPE_NAME field that 
  describes the type name on the Oracle database server was changed 
  from number to float to better describe how the column was created.

SQL Server
----------
* Microsoft SQL Server 7 and SQL Server 2000 Only: Although the 
  SQL Server driver fully supports the auto-generated keys feature as 
  described in the Microsoft SQL Server chapter of the DATADIRECT 
  CONNECT FOR JDBC USER'S GUIDE AND REFERENCE, some third-party 
  products provide an implementation that, regardless of the column 
  name specified, cause the driver to return the value of the identity 
  column for the following methods:

  Connection.prepareStatement(String sql, int[] columnIndexes)
  Connection.prepareStatement(String sql, String[] columnNames) 

  Statement.execute(String sql, int[] columnIndexes)
  Statement.execute(String sql, String[] columnNames)

  Statement.executeUpdate(String sql, int[] columnIndexes)
  Statement.executeUpdate(String sql, String[] columnNames)

  To workaround this problem, set the WorkArounds connection option 
  to 1. When Workarounds=1, calling any of auto-generated keys methods 
  listed above returns the value of the identity column regardless of 
  the name or index of the column specified to the method. If multiple 
  names or indexes are specified, the driver throws an exception 
  indicating that multiple column names or indexes cannot be specified 
  if connected to Microsoft SQL Server 7 or SQL Server 2000.

* If you want to take advantage of JDBC distributed transactions 
  through JTA, you must install JDBC XA Procedures. DataDirect provides 
  the following files to install the XA Procedures: sqljdbc.dll and 
  instjdbc.sql. Refer to the Microsoft SQL Server Driver chapter in 
  the DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND REFERENCE 
  (JDBCREF.PDF) for details and file location.
  
  If you have multiple instances of Microsoft SQL Server on the same 
  machine, you can edit the instjdbc.sql script with a text editor to 
  specify a fully qualified path to the sqljdbc.dll file for a 
  particular instance. For example, if you want to install XA Procedures 
  for an instance named "MSSQL.2," modify the instjdbc.sql script 
  as shown: 

  /*
  **  add references for the stored procedures
  */

  print 'creating JDBC XA procedures'
  go

  sp_addextendedproc 'xp_jdbc_open', 
     'C:\Program Files\Microsoft SQL Server\MSSQL.2\MSSQL\Binn\sqljdbc.dll'
  go
  sp_addextendedproc 'xp_jdbc_open2', 
     'C:\Program Files\Microsoft SQL Server\MSSQL.2\MSSQL\Binn\sqljdbc.dll'
  go
  sp_addextendedproc 'xp_jdbc_close', 
     'C:\Program Files\Microsoft SQL Server\MSSQL.2\MSSQL\Binn\sqljdbc.dll'
  go
  sp_addextendedproc 'xp_jdbc_close2', 
     'C:\Program Files\Microsoft SQL Server\MSSQL.2\MSSQL\Binn\sqljdbc.dll'
  go
  sp_addextendedproc 'xp_jdbc_start', 
     'C:\Program Files\Microsoft SQL Server\MSSQL.2\MSSQL\Binn\sqljdbc.dll'
  ...

  NOTE: For Microsoft SQL Server 2005, you can use the SQL Server 
  Configuration Manager tool to view Microsoft SQL Server services 
  and determine the fully qualified path to the binn subdirectory of 
  each Microsoft SQL Server instance on a machine. Using the 
  Configuration Manager, right-click on a service and select Properties. 
  Select the Service tab. The path is shown as a value of the Binary Path 
  attribute. For Microsoft SQL Server 2000, you can use the SQL Server 
  Enterprise Manager. Refer to your Microsoft SQL Server documentation 
  for details.

  Once you modify the instjdbc.sql script, run it as described in the 
  DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND REFERENCE (JDBCREF.PDF).

* NTLM authentication requires Microsoft SQL Server 2000, 
  Service Pack 3 or higher when connecting to 
  Microsoft SQL Server 2000. 

* In some cases, when using Kerberos authentication, Windows XP and 
  Windows Server 2003 clients appear to use NTLM instead of Kerberos to 
  authenticate the user with the domain controller. In these cases, 
  user credentials are not stored in the local ticket cache and cannot 
  be obtained by the SQL Server driver, causing the Windows 
  Authentication login to fail. This is caused by a known problem in 
  the Sun 1.4.x JVM; this problem is planned to be fixed in the 1.5 
  JVM. As a workaround, the "os.name" system property can be set to 
  "Windows 2000" when running on a Windows XP or Windows Server 2003 
  machine. For example:

  -Dos.name="Windows 2000"

* To ensure correct handling of character parameters, install 
  Microsoft SQL Server 7 Service Pack 2 or higher.

* Because of the way CHAR, VARCHAR, and LONGVARCHAR data types are 
  handled internally by the driver, parameters of these data types 
  exceeding 4000 characters in length cannot be compared or sorted, 
  except when using the IS NULL or LIKE operators.

* The SendStringParameterAsUnicode connection option is set to true by 
  default. Setting this option to true can negatively impact 
  performance if an application compares strings in SQL and the 
  data stored in the database is not Unicode. On the other hand, 
  setting this option to false can cause data corruption or unexpected 
  comparison results if the data is not stored in the default database 
  character set. Microsoft SQL Server allows you to define columns in a 
  table that uses a character set other than the default database 
  character set. When sending parameter data to the server, the driver 
  does not know that the character set is for the column being compared 
  or modified. Sending parameter data as Unicode will always work, but 
  is subject to the conversion and performance issues mentioned in the 
  Microsoft document: 
  http://support.microsoft.com/default.aspx?scid=kb;en-us;Q271566.

Documentation Errors
--------------------
* On page 470 of the DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND 
  REFERENCE (JDBCREF.PDF), the example showing how to retrieve client 
  information contains an error. The last three lines of the example 
  should read: 
  
  DatabaseMetaData metaData = con.getMetaData();
  metaData.getClientInfoProperties();
  ...
  
  Instead of:
  
  DatabaseMetaData metaData = con.getDatabaseMetaData();
  metaData.getClientInfoProperties();
  ...

* On page 615 of the DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND 
  REFERENCE (JDBCREF.PDF), the documentation incorrectly states 
  the class name of the DataDirect Spy driver. The correct class name 
  is com.ddtek.jdbcspy.SpyDriver.

* On pages 70-72 of the DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND 
  REFERENCE (JDBCREF.PDF), the documentation incorrectly omits the 
  following required permissions in the security file of the Java 2 
  Platform:

  permission java.lang.RuntimePermission "getProtectionDomain";
  permission java.util.PropertyPermission "java.security.krb5.conf",  
    "read";
  permission java.util.PropertyPermission 
    "java.security.auth.login.config", "read, write";
  permission javax.security.auth.AuthPermission 
    "createLoginContext.JDBC_DRIVER_01";

* The DATADIRECT CONNECT FOR JDBC USER'S GUIDE AND REFERENCE 
  (JDBCREF.PDF) incorrectly states that the DB2, Informix, and Sybase 
  drivers support the following forms of the 
  Connection.preparedStatement() method:

  Connection.prepareStatement(String <sql>, int[] <columnIndexes>)
  Connection.prepareStatement(String <sql>, String[] <columnNames>)

  These forms are supported by the Oracle and SQL Server drivers only.


     Using the Online Documents

The DataDirect Connect for JDBC books are provided in PDF and HTML 
versions. The PDF versions are provided on the product CD and also on 
the DataDirect Technologies Web site:

http://www.datadirect.com/techres/jdbcproddoc/index.ssp

You can view the PDF versions using Adobe Reader.

NOTE: To download Adobe Reader from the Web, go to Adobes Web site 
at http://www.adobe.com.

The HTML versions of the books are installed in the help subdirectory 
of your product installation directory.


     DataDirect Connect(R) for JDBC Files 

When you extract the contents of the connectjdbc.jar file to your 
installer directory, you will notice the following files that are 
required to install DataDirect Connect for JDBC: 

BuildAdapters.jar          File used to create resource adapters
ddjdbc37.jar               File used to install the  drivers
fixes.txt                  File that lists fixes in this release                           
installer.bat              Batch file to start the GUI installer
installer.sh               Shell script to start the GUI installer
installer.properties	   Support file for the installer
Java Technology Restrictions notice.txt   
                           Copyright notice required by  
                           Sun Microsystems, Inc
JDBCInstaller.jar          File containing the installer                                          
LicenseTool.jar            File required to extend an evaluation 
                           installation
mysqllicense.txt           License agreement for MySQL
jdbcreadme.txt             This file 

When you install DataDirect Connect for JDBC, the installer copies all 
the following directories and files to the product installation 
directory (as determined by the user), represented by INSTALL_DIR.

To INSTALL_DIR/DB2/bind:
------------------------
*.bnd                      Bind files used for creating DB2 packages
DDJDBC_400.lst             List file for creating DB2 packages on 
                           DB2 for iSeries
DDJDBC_LUW.lst             List file for creating DB2 packages on
                           DB2 for Linux/UNIX/Windows 
DDJDBC_MVS.lst             List file for creating DB2 packages on
                           DB2 for z/OS

To INSTALL_DIR/Examples:
------------------------
JNDI_FILESYSTEM_Example.java  Example Java(TM) source files
JNDI_LDAP_Example.java        Example Java source files

To INSTALL_DIR/Examples/connector:
----------------------------------
ConnectorSample.ear       J2EE Application Enterprise Archive file 
                          containing the ConnectorSample application 
connectorsample.htm       "Using DataDirect Connect for JDBC Resource 
                          Adapters" document

To INSTALL_DIR/Examples/connector/graphics:
------------------------------------------
*.*                       Images referenced by the "Using DataDirect 
                          Connect for JDBC Resource Adapters" document 

To INSTALL_DIR/Examples/connector/src:
--------------------------------------
ConnectorSample.jsp       Source for the JavaServer Page used to access 
                          the ConnectorSample application

To INSTALL_DIR/Examples/connector/src/connectorsample:
------------------------------------------------------
ConnectorSample.java      Java source file defining the remote 
                          interface for the ConnectorSample EJB
ConnectorSampleBean.java  Java source file defining the home interface 
                          for the ConnectorSample EJB
ConnectorSampleHome.java  Java source file containing the 
                          implementation for the ConnectorSample EJB

INSTALL_DIR\Help: 
----------------

Help.htm                  HTML help system entry file
\*.*                      Support folders for the HTML help system 

To INSTALL_DIR/lib:
-------------------
db2.jar                   DataDirect Connect for JDBC DB2 Driver 
                          and DataSource classes
informix.jar              DataDirect Connect for JDBC Informix 
                          Driver and DataSource classes
mysql.jar                 DataDirect Connect for JDBC MySQL
                          Driver and DataSource classes
oracle.jar                DataDirect Connect for JDBC Oracle 
                          Driver and DataSource classes
sqlserver.jar             DataDirect Connect for JDBC SQL Server 
                          Driver and DataSource classes
sybase.jar                DataDirect Connect for JDBC Sybase 
                          Driver and DataSource classes
base.jar                  Classes that are used by and required by all 
                          DataDirect Connect for JDBC drivers
util.jar                  Classes that are used by and required by all 
                          DataDirect Connect for JDBC drivers
db2packagemanager.jar     DataDirect DB2 Package Manager jar file 
DDJDBCAuthxx.dll          Windows DLL that provides support for 
                          NTLM authentication (32-bit), where xx is the 
                          Build number of the DLL
DDJDBC64Authxx.dll        Windows DLL that provides support for 
                          NTLM authentication (Itanium 64-bit), 
                          where xx is the Build number of the DLL
DDJDBCx64Authxx.dll       Windows DLL that provides support for 
                          NTLM authentication (AMD64 and 
                          Intel EM64T 64-bit), where xx is the 
                          Build number of the DLL
DB2PackageManager.bat     Batch file to start the DataDirect DB2 
                          Package Manager
DB2PackageManager.sh      Shell script to start the DataDirect DB2 
                          Package Manager
JDBCDriver.policy         Security policy file listing permissions that 
                          must be granted to the driver to use Kerberos 
                          authentication with a Security Manager
JDBCDriverLogin.conf      Configuration file that instructs the driver 
                          to use the Kerberos login module for 
                          authentication
krb5.conf                 Kerberos configuration file


To INSTALL_DIR/lib/JCA:
-----------------------
resource.jar              J2EE Connector Architecture resource adapter 
                          components 

To INSTALL_DIR/lib/JCA/META-INF:
--------------------------------
db2.xml                   DB2 resource adapter deployment descriptor
informix.xml              Informix resource adapter deployment 
                          descriptor
mysql.xml                 MySQL resource adapter deployment descriptor
oracle.xml                Oracle resource adapter deployment descriptor
sqlserver.xml             SQL Server resource adapter deployment 
                          descriptor
sybase.xml                Sybase resource adapter deployment descriptor
MANIFEST.MF               Manifest file

To INSTALL_DIR/pool manager:
----------------------------
pool.jar                  All DataDirect Connection Pool Manager 
                          classes

To INSTALL_DIR/spy:
-------------------
spy.jar                   All DataDirect Spy classes

To INSTALL_DIR/SQLServer JTA/32-bit:
------------------------------------
instjdbc.sql              File for installing JTA Stored Procedures
sqljdbc.dll               File for use with JTA Stored Procedures 
                          (32-bit version)

To INSTALL_DIR/SQLServer JTA/64-bit:
------------------------------------
instjdbc.sql              File for installing JTA Stored Procedures
sqljdbc.dll               File for use with JTA Stored Procedures 
                          (Itanium 64-bit version)

To INSTALL_DIR/SQLServer JTA/x64-bit:
------------------------------------
instjdbc.sql              File for installing JTA Stored Procedures
sqljdbc.dll               File for use with JTA Stored Procedures 
                          (AMD64 and Intel EM64T 64-bit version)

To INSTALL_DIR/sun/lib:
-----------------------
jdbc2_0-stdext.jar        Redistributable Sun Microsystems 
                          components for the JDBC 2.0 Optional Package
jndi.jar                  Redistributable Sun Microsystems components 
                          for JNDI 1.2
jta-spec1_0_1B.jar        Redistributable Sun Microsystems components 
                          for JTA 1.0.1
/fs/*.*                   Redistributable Sun Microsystems components 
                          for the File System JNDI Provider
/ldap/*.*                 Redistributable Sun Microsystems components 
                          for the LDAP JNDI Provider

To INSTALL_DIR/testforjdbc:
---------------------------
Config.txt                Configuration file for DataDirect Test 
testforjdbc.bat           Batch file to start DataDirect Test
testforjdbc.sh            Shell script to start DataDirect Test
/lib/testforjdbc.jar      DataDirect Test classes

To INSTALL_DIR/wizards:
-----------------------
index.html                HTML file to launch the Performance Tuning 
                          Wizard applet
JDBCPerf.jar              Jar file containing the classes for the 
                          Performance Tuning Wizard applet

To INSTALL_DIR/wizards/logo:
----------------------------
ddlogo.gif                DataDirect Technologies logo in the 
                          Performance Tuning Wizard applet


In addition, installation creates the following files in 
INSTALL_DIR/lib if you choose to install the resource adapters:

db2.rar                   DB2 resource archive file
informix.rar              Informix resource archive file
mysql.rar                 MySQL resource archive file
oracle.rar                Oracle resource archive file
sqlserver.rar             SQL Server resource archive file
sybase.rar                Sybase resource archive file


     Third-Party License Requirements/Agreements

The DataDirect Connect for JDBC drivers include certain software 
products made available for distribution by Sun Microsystems, Inc. and 
are subject to the following limitation:
 
Java(R) Technology Restrictions. You may not modify the Java 
Platform Interface ("JPI", identified as classes contained within the 
"java" package or any subpackages of the "java" package), by creating 
additional classes within the JPI or otherwise causing the addition to 
or modification of the classes in the JPI. In the event that you 
create an additional class and associated API(s) which (i) extends 
the functionality of the Java Platform, and (ii) is exposed to third 
party software developers for the purpose of developing additional 
software which invokes such additional API, you must promptly publish 
broadly an accurate specification for such API for free use by all 
developers. You may not create, or authorize your licensees to create 
additional classes, interfaces, or subpackages that are in any way 
identified as "java", "javax", "sun" or similar convention as specified 
by Sun in any naming convention designation.

If DataDirect Connect for JDBC is licensed for the Microsoft SQL Server 
database the following shall apply:  DataDirect Connect for JDBC 
contains a licensed implementation of the Microsoft TDS Protocol. You 
may only use DataDirect Connect for JDBC to communicate data to and 
from Microsoft SQL Servers.  You must separately obtain a license from 
Microsoft or its channel partners for any Microsoft software products 
used by you.

The DataDirect Connect for JDBC driver for MySQL Enterprise was 
developed using the MySQL Protocol Documentation whose copyright is 
owned by, and licensed by DataDirect from, MySQL AB. If DataDirect 
Connect for JDBC is licensed for the MySQL database the following shall 
apply: You must purchase commercially licensed MySQL database software 
or a MySQL Enterprise subscription in order to use the DataDirect Connect 
for JDBC driver for MySQL Enterprise with MySQL software.


---------------------
End of JDBCREADME.TXT

