Use this table as an at-a-glance reference of JDBC providers that can be defined for use with WebSphere Application Server Version 6.x, to establish data sources for transacting with relational databases. A list that contains detailed requirements for creating data sources with these providers follows the table. (The list also contains information about JDBC providers that are deprecated in WebSphere Application Server Version 6.x.)
Database type | JDBC Provider | Transaction support | Version and other considerations |
---|---|---|---|
DB2 on Windows, UNIX, or workstation-based LINUX | DB2 Universal JDBC Provider | One phase only | |
DB2 Universal JDBC Provider (XA) | One and two phase | The XA implementation is not supported in WebSphere Application Server run on workstation-based LINUX. | |
DB2 legacy CLI-based Type 2 JDBC Provider | One phase only | ||
DB2 legacy CLI-based Type 2 JDBC Provider (XA) | One and two phase | ||
DB2 UDB for iSeries | DB2 UDB for iSeries (Native) | One phase only |
Recommended for use with WebSphere Application Server run on iSeries |
DB2 UDB for iSeries (Native XA) | One and two phase |
Recommended for use with WebSphere Application Server run on iSeries | |
DB2 UDB for iSeries (Toolbox) | One phase only | ||
DB2 UDB for iSeries (Toolbox XA) | One and two phase | ||
DB2 Universal JDBC Provider (XA) | One and two phase |
- Only for use with WebSphere Application Server run on z/OS - Only driver type 4 is supported - Does not support Version 4 data sources | |
DB2 legacy CLI-based Type 2 JDBC Provider | One phase only |
- Only for use with WebSphere Application Server run on Windows, UNIX, or workstation-based LINUX - Requires the DB2 Connect driver (available from DB2) | |
DB2 legacy CLI-based Type 2 JDBC Provider (XA) | One and two phase |
- Only for use with WebSphere Application Server run on Windows, UNIX, or workstation-based LINUX - Requires the DB2 Connect driver (available from DB2) | |
DB2 on z/OS | DB2 for z/OS Local JDBC Provider (RRS), using the Legacy DB2 for z/OS JDBC Driver | One and two phase |
Only for use with WebSphere Application Server run on z/OS |
DB2 Universal JDBC Provider | One phase only | ||
DB2 Universal JDBC Provider (XA) | One and two phase |
- Only driver type 4 is supported in WebSphere Application Server run on z/OS - Does not support Version 4 data sources in WebSphere Application Server run on z/OS | |
DB2 legacy CLI-based Type 2 JDBC Provider | One phase only |
- Only for use with WebSphere Application Server run on Windows, UNIX, or workstation-based LINUX - Requires the DB2 Connect program (available from DB2) | |
DB2 legacy CLI-based Type 2 JDBC Provider (XA) | One and two phase |
- Only for use with WebSphere Application Server run on Windows, UNIX, or workstation-based LINUX - Requires the DB2 Connect program (available from DB2) | |
Cloudscape | Cloudscape JDBC Provider | One phase only |
- Not for use in clustered environment: accessible from a single JVM only - Does not support Version 4 data sources |
Cloudscape JDBC Provider (XA) | One and two phase |
- Not for use in clustered environment: accessible from a single JVM only - Does not support Version 4 data sources | |
Cloudscape Network Server Provider using the Universal JDBC driver | One phase only |
- Can be used in clustered environment: a database instance can be accessed by multiple JVMs - Does not support XA - Does not support Version 4 data sources | |
Derby Restriction: Derby Version 10.0 cannot be used as a production database. Derby Version 10.0 can only be used for development and test purposes. No restriction: Derby Version 10.1 can be used in production environments as well as in development and test environments. | Derby JDBC Provider | One phase only |
- Not for use in clustered environment: accessible from a single JVM only - Does not support Version 4 data sources |
Derby JDBC Provider (XA) | One and two phase |
- Not for use in clustered environment: accessible from a single JVM only - Does not support Version 4 data sources | |
Derby Network Server Provider using the Universal JDBC driver | One phase only |
- Can be used in clustered environment: a database instance can be accessed by multiple JVMs - Does not support XA - Does not support Version 4 data sources | |
Informix | Informix JDBC Provider | One phase only | |
Informix JDBC Provider (XA) | One and two phase | ||
Sybase | Sybase jConnect for JDBC Provider | One phase only | |
Sybase jConnect for JDBC Provider (XA) | One and two phase | ||
Oracle | Oracle JDBC Provider | One phase only | |
Oracle JDBC Provider (XA) | One and two phase | ||
MS SQL Server | DataDirect ConnectJDBC Provider, type 4 driver, for MS SQL Server | One phase only | Only for use with the corresponding driver from DataDirect Technologies |
DataDirect ConnectJDBC Provider, type 4 driver, for MS SQL Server (XA) | One and two phase | Only for use with the corresponding driver from DataDirect Technologies | |
WebSphere embedded ConnectJDBC Provider for MS SQL Server | One phase only | Cannot be used outside of WebSphere Application Server environment | |
WebSphere embedded ConnectJDBC Provider for MS SQL Server (XA) | One and two phase | Cannot be used outside of WebSphere Application Server environment |
Detailed data source requirements per JDBC provider and platform
The following list contains the requirements for creating data sources with every JDBC provider type that is supported in WebSphere Application Server Version 6.x. Specific fields are designated for the user and password properties. Inclusion of a property in the list does not imply that you should add it to the data source custom properties list. Rather, inclusion in the list means that a value is typically required for that field.
Important: After you determine the type of JDBC provider that suits your application and environment, ensure that you acquire the corresponding JDBC driver at a release level supported by this version of WebSphere Application Server. Consult the Supported hardware and software Web page at the http://www.ibm.com/software/webservers/appserv/doc/latest/prereq.html IBM Web address. Use these links to find your provider and data source information:
DB2 on Windows, UNIX, or workstation-based LINUX
The DB2 Universal JDBC Driver is an architecture-neutral JDBC driver for distributed and local DB2 access. Because the Universal Driver architecture is independent of any particular JDBC driver connectivity or target platform, it allows both Java connectivity (Type 4) or Java Native Interface (JNI) based connectivity (Type 2) in a single driver instance to DB2.
This JDBC driver allows applications to use both JDBC and Structured Query Language in Java (SQLJ) access. The DB2 Universal JDBC Driver Provider supports one phase data source:
com.ibm.db2.jcc.DB2ConnectionPoolDataSourceRequires JDBC driver files:
Note: To find out the version of the universal driver you are using, issue this DB2 command:
java com.ibm.db2.jcc.DB2Jcc -versionThe output for the above example is:
IBM DB2 JDBC Universal Driver Architecture 2.2.xx
The db2jcc_license_cisuz.jar does not ship with Websphere Application Server and should be located in the same directory as the db2jcc.jar file, so that the DB2UNIVERSAL_JDBC_DRIVER_PATH points to both.
The classpath for this provider is set as follows: <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar </classpath> <classpath>${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar</classpath> <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar</classpath>Note: The license jar files are independent of each other; therefore, order does not matter.Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
Requires a valid authentication alias. Requires properties:
You can use setUseTransactionRedirect for both driverType 2 and driverType 4 data sources. To configure the property, use either the wsadmin scripting tool or the administrative console page Custom properties collection located at Resources > JDBC Providers > JDBC_provider > Data sources > data_source > Custom properties . Assign the property the value of true.
The DB2 Universal JDBC Provider (XA) is an architecture-neutral JDBC provider for distributed and local DB2 access. Whether you use this provider for Java connectivity or Java Native Interface (JNI) based connectivity depends on the version of DB2 you are running. Application Server Version 6.0 minimally requires DB2 8.1 Fix Pack 6. This version of DB2 only supports XA connectivity over the Java Native Interface (JNI) based connectivity (Type 2) driver. In order to use XA connectivity with the Type 4 driver, DB2 8.1 Fix Pack 7 or higher is required.
The DB2 Universal JDBC Driver (XA) supports two phase transactions and the more advanced data source option offered by Application Server (as opposed to the other option, Version 4 data sources). This driver also allows applications to use both JDBC and SQLJ access. The DB2 Universal JDBC Driver Provider supports the two phase data source:
com.ibm.db2.jcc.DB2XADataSourceRequires JDBC driver files:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_License_cu.jar
Class path:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_License_cisuz.jar
You must use the right license JAR file to access a specific database backend.
${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
Requires a valid authentication alias. Requires properties:
You can use setUseTransactionRedirect
only for driverType 4 data sources. To configure the property,
use either the wsadmin scripting tool or
the administrative console page Custom properties collection located at Resources > JDBC Providers >
JDBC_provider > Data sources > data_source >
Custom properties . Assign the property the value of true.
Tip: To find the level of universal driver you are using, issue the following DB2 command:
java com.ibm.db2.jcc.DB2Jcc -version
example output of the above:
IBM DB2 JDBC Universal Driver Architecture 2.2.xx
The DB2 legacy CLI-based Type 2 JDBC Driver Provider is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. DB2 legacy CLI-based Type 2 JDBC Driver supports one phase data source:
COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
Requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias if Application Server is running on the same machine as the database. Otherwise, connectivity through this driver does require an alias. Requires properties:
The DB2 legacy CLI-based Type 2 JDBC Driver (XA) is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. DB2 legacy CLI-based Type 2 JDBC Driver (XA) supports two phase data source:
COM.ibm.db2.jdbc.DB2XADataSource
Requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias if Application Server is running on the same machine as the database. Otherwise, connectivity through this driver does require an alias. Requires properties:
For more information on DB2, visit the DB2 Web site at: http://www.ibm.com/software/data/db2/.
For information on configuring WebSphere Application Server for DB2 access, see the Configuring DB2 article.
DB2 UDB for iSeries
The iSeries Developer Kit for Java contains this Type 2 JDBC driver that is built on top of the iSeries DB2 Call Level Interface (CLI) native libraries. Only use this driver for local DB2 connections on iSeries. It is not recommended for remote access. Use this driver for iSeries V5R2, or later releases. DB2 UDB for iSeries (Native V5R2 and later) supports one phase data source:
com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
Requires JDBC driver files: db2_classes.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias. Requires properties:
The iSeries Developer Kit for Java contains this XA-compliant Type 2 JDBC driver built on top of the iSeries DB2 Call Level Interface (CLI) native libraries. Only use this driver for local DB2 connections on iSeries. It is not recommended for remote access. Use this driver for iSeries V5R2 or later releases. DB2 UDB for iSeries (Native XA - V5R2 and later) supports two phase data source:
com.ibm.db2.jdbc.app.UDBXADataSource
Requires JDBC driver files: db2_classes.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias. Requires properties:
This JDBC driver, also known as iSeries Toolbox driver for Java, is provided in the DB2 for iSeries database server. Use this driver for remote DB2 connections on iSeries. We recommend you use this driver instead of the IBM Developer Kit for Java JDBC Driver to access remote DB2 UDB for iSeries systems. DB2 UDB for iSeries (Toolbox) supports one phase data source:
com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
Requires JDBC driver files: jt400.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias if WebSphere Application Server and DB2 UDB for iSeries are installed in the same server. If they are installed in different servers, the user ID and password are required. Requires properties:
This XA compliant JDBC driver, also known as iSeries Toolbox XA compliant driver for Java, is provided in the DB2 for iSeries database server. Use this driver for remote DB2 connections on iSeries. We recommend you use this driver instead of the IBM Developer Kit for Java JDBC Driver to access remote DB2 UDB for iSeries systems. DB2 UDB for iSeries (Toolbox XA) supports two phase data source:
com.ibm.as400.access.AS400JDBCXADataSource
Requires JDBC driver files: jt400.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias if WebSphere Application Server and DB2 UDB for iSeries are installed in the same server. If they are installed in different servers, the user ID and password are required.
Requires properties:
The DB2 legacy CLI-based Type 2 JDBC Driver Provider is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. This provider is intended for remote connections to DB2 running on iSeries; for use with Application Server on Windows, UNIX, or workstation-based LINUX, it therefore requires the DB2 Connect Driver (which is available from DB2). DB2 legacy CLI-based Type 2 JDBC Driver supports one phase data source:
COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
Requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias. Requires properties:
The DB2 legacy CLI-based Type 2 JDBC Driver (XA) is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. This provider is intended for remote connections to DB2 running on iSeries; for use with Application Server on Windows, UNIX, or workstation-based LINUX, it therefore requires the DB2 Connect Driver (which is available from DB2). DB2 legacy CLI-based Type 2 JDBC Driver (XA) supports two phase data source:
COM.ibm.db2.jdbc.DB2XADataSource
Requires JDBC driver files: db2java.zip Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias. Requires properties:
This JDBC provider is deprecated because it corresponds to a version of the iSeries
operating system that WebSphere Application Server Version 6.x does not support.
You must now use iSeries V5R2 or a later release of the iSeries operating system, for which the WebSphere Application Server administrative console lists one native iSeries DB2 non-XA provider:
DB2 UDB for iSeries (Native).
The iSeries Developer Kit for Java contains this Type 2 JDBC driver that is built on top of the iSeries DB2 Call Level Interface (CLI) native libraries. Only use this driver for local DB2 connections on iSeries. It is not recommended for remote access. Use this driver for iSeries V5R1, or earlier releases. DB2 UDB for iSeries (Native V5R1 and earlier) supports one phase data source:
com.ibm.db2.jdbc.app.DB2StdConnectionPoolDataSource
Requires JDBC driver files: db2_classes.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias. Requires properties:
This JDBC provider is deprecated because it corresponds to a version of the iSeries operating system that WebSphere Application Server Version 6.x does not support. You must now use iSeries V5R2 or a later release of the iSeries operating system, for which the administrative console lists one native iSeries DB2 XA provider: DB2 UDB for iSeries (Native XA).
The iSeries Developer Kit for Java contains this XA-compliant Type 2 JDBC driver built on top of the iSeries DB2 Call Level Interface (CLI) native libraries. Only use this driver for local DB2 connections on iSeries. It is not recommended for remote access. Use this driver for iSeries V5R1, or earlier releases. DB2 UDB for iSeries (Native XA - V5R1 and earlier) supports two phase data source:
com.ibm.db2.jdbc.app.DB2StdXADataSource
Requires JDBC driver files: db2_classes.jar Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper
Does not require an authentication alias. Requires properties:
For more information on DB2 UDB for iSeries, visit the DB2 Web site at: http://www.ibm.com/software/data/db2/
DB2 on z/OS, connecting to Application Server on Windows, UNIX, or workstation-based LINUX
The DB2 Universal JDBC Driver is an architecture-neutral JDBC driver for distributed and local DB2 access. Because the Universal Driver architecture is independent of any particular JDBC driver connectivity or target platform, it allows both Java connectivity (Type 4) or Java Native Interface (JNI) based connectivity (Type 2) in a single driver instance to DB2. Starting with WebSphere Application Server Version 5.0.2, the product now supports both Type 2 and Type 4 JDBC drivers. To use the Type 4 driver, install DB2 Version 8.1 or a later version. To use the Type 2 driver, install DB2 Version 8.1 Fix Pack 2 or a later version.
This JDBC driver allows applications to use both JDBC and Structured Query Language in Java (SQLJ) access. The DB2 Universal JDBC Driver Provider supports one phase data source:
com.ibm.db2.jcc.DB2ConnectionPoolDataSourceRequires JDBC driver files:
Note: To find out the version of the universal driver you are using, issue this DB2 command:
java com.ibm.db2.jcc.DB2Jcc -versionThe output for the above example is:
IBM DB2 JDBC Universal Driver Architecture 2.2.xx
The db2jcc_license_cisuz.jar does not ship with Websphere Application Server and should be located in the same directory as the db2jcc.jar file, so that the DB2UNIVERSAL_JDBC_DRIVER_PATH points to both.
The classpath for this provider is set as follows: <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar </classpath> <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar</classpath> <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar</classpath>Note: The license jar files are independent of each other; therefore, order does not matter.Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
Requires a valid authentication alias. Requires properties:
The DB2 Universal JDBC Driver (XA) is an architecture-neutral JDBC driver for distributed and local DB2
access. In WebSphere Application Server Version 5.0.2, this driver only supports Java Native Interface (JNI) based connectivity (Type 2) in a single driver instance to DB2. To use this driver, install DB2 Version 8.1 Fix Pack 2 or a later version. This driver supports two phase transactions and the WebSphere Application Server Version 5.0 data source. This driver allows
applications to use both JDBC and SQLJ access. The DB2
Universal JDBC Driver Provider supports the two phase data source:
com.ibm.db2.jcc.DB2XADataSourceRequires JDBC driver files:
Note: To find the level of universal driver you are using, issue the following DB2 command:
java com.ibm.db2.jcc.DB2Jcc -versionexample output of the above:
IBM DB2 JDBC Universal Driver Architecture 2.2.xx
You must use the right license jar file to access a specific database backend.
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
Requires a valid authentication alias. Requires properties:
The DB2 legacy CLI-based Type 2 JDBC Driver Provider is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. For use with Application Server on Windows, UNIX, or workstation-based LINUX, this provider requires DB2 Connect (which is available from DB2). DB2 legacy CLI-based Type 2 JDBC Driver supports one phase data source:
COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
Requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias. Requires properties:
The DB2 legacy CLI-based Type 2 JDBC Driver (XA) is built on top of DB2 CLI (Call Level Interface). It uses the DB2 CLI interface to communicate with DB2 UDB servers. For use with Application Server on Windows, UNIX, or workstation-based LINUX, this provider requires DB2 Connect (which is available from DB2). DB2 legacy CLI-based Type 2 JDBC Driver (XA) supports two phase data source:
COM.ibm.db2.jdbc.DB2XADataSource
Requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DB2DataStoreHelper
Does not require a valid authentication alias. Requires properties:
For more information on DB2 for z/OS, visit the DB2 Web site at: http://www.ibm.com/software/data/db2/ .
Cloudscape
The Cloudscape JDBC Provider provides the JDBC access to the Cloudscape database. This Cloudscape JDBC driver uses the embedded framework. You cannot use any Version 4.0 data sources with Cloudscape. Cloudscape JDBC Provider supports one phase data source:
com.ibm.db2j.jdbc.DB2jConnectionPoolDataSource
Requires the JDBC driver files in db2cc.jar. Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper
Does not require a valid authentication alias. Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\temp\sampleDB;create=true )
The Cloudscape JDBC Provider (XA) provides the XA-compliant JDBC access to the Cloudscape database. This Cloudscape JDBC driver uses the embedded framework. You cannot use any Version 4.0 data sources with Cloudscape. Cloudscape JDBC Provider (XA) supports two phase data source:
com.ibm.db2j.jdbc.DB2jXADataSource
Requires the JDBC driver files in db2cc.jar. Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper
Does not require a valid authentication alias. Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\temp\sampleDB;create=true )
This Cloudscape driver takes advantage of the Network Server support that the DB2 universal Type 4 JDBC driver provides. You cannot use any Version 4.0 data sources with Cloudscape. Cloudscape uses the DB2 Universal Driver when using the Network Server. It supports one phase data source:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
Requires JDBC driver files:
<classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar</classpath> <classpath>${CLOUDSCAPE_JDBC_DRIVER_PATH}/db2j.jar</classpath> <classpath>${CLOUDSCAPE51_JDBC_DRIVER_PATH}/db2j.jar</classpath> <classpath>${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar</classpath>which means that the db2jcc.jar from DB2 always takes precedence. Note that this also means that set the DB2 environment variable DB2UNIVERSAL_JDBC_DRIVER_PATH in WebSphere when you set up your DB2 datasource. This is instead of hard coding the path of the db2jcc.jar for DB2 datasources.
Note: UNIVERSAL_JDBC_DRIVER_PATH is a WebSphere environment variable that is already defined to the location in Websphere Application Server where the license jar file above is located, and will only be used if the DB2UNIVERSAL_JDBC_DRIVER_PATH is not set. DB2 users should ensure that DB2UNIVERSAL_JDBC_DRIVER_PATH is set to avoid loading multiple versions of the db2jcc.jar file.
Note: DB2UNIVERSAL_JDBC_DRIVER_PATH is a WebSphere environment variable that set to point to the location of db2jcc.jar file (that comes with DB2). This variable is set only if you create a db2 provider.
Note: Cloudscape requires only db2jcc_license_c.jar; however, WebSphere Application Server uses db2jcc_license_cu.jar because this works for both DB2 UDB and Cloudscape.
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper
Note: The administrative console incorrectly lists the DB2UniversalDataStoreHelper as the default value for the DataStoreHelper class. You must change the default value to com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper . Also change the custom properties, using the instructions in the customer property section.
Requires a valid authentication alias.
Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\temp\sampleDB;create=true )
See the Cloudscape setup instructions for more information on configuring the Cloudscape Network Server.
For more information on IBM Cloudscape, visit the Cloudscape Web site at: http://www.ibm.com/software/data/cloudscape/.
The Derby JDBC Provider provides the JDBC access to the Derby database. This Derby JDBC driver uses the embedded framework. You cannot use any Version 4.0 data sources with Derby.
The Derby JDBC Provider supports one phase data source:
com.ibm.db2j.jdbc.DB2jConnectionPoolDataSource
Requires JDBC driver files: db2j.jar.
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
Does not require a valid authentication alias.
Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\ temp \ sampleDB ;create=true )
This Derby driver takes advantage of the Network Server support that the DB2 universal Type 4 JDBC driver provides. You cannot use any Version 4.0 data sources with Derby.
Use the following one phase data source for the Derby Network Server using Universal JDBC driver:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
Requires JDBC driver files:
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DerbyNetworkServerDataStoreHelper
Requires a valid authentication alias.
Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\ temp \ sampleDB ;create=true )
See the Cloudscape and Derby setup instructions for more information on configuring the Derby Network Server.
For more information on IBM Cloudscape, visit the Cloudscape Web site at: http://www.ibm.com/software/data/cloudscape/.
Derby
New version: Use Derby Version 10.1 as a production database.
The Derby JDBC driver provides JDBC access to the Derby database by using the framework that is already embedded in WebSphere Application Server for Derby. However, you cannot use any Version 4.0 data sources with Derby. The Derby JDBC Provider supports one phase data source:
org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
Requires JDBC driver files: derby.jar ; full path name: ${WAS_INSTALL_ROOT}/derby/lib/derby.jar
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
Does not require a valid authentication alias.
Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\ temp \ sampleDB ;create=true )
New version: Use Derby Version 10.1 as a production database.
The Derby JDBC driver (XA) provides JDBC access to the Derby database by using the framework that is already embedded in WebSphere Application Server for Derby. However, you cannot use any Version 4.0 data sources with Derby. The Derby JDBC Provider (XA) supports two phase data source:
org.apache.derby.jdbc.EmbeddedXADataSource
Requires JDBC driver files: derby.jar ; full path name: ${WAS_INSTALL_ROOT}/derby/lib/derby.jar
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
Does not require a valid authentication alias.
Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\temp\sampleDB;create=true )
Derby Network Server using Universal JDBC driver
Restriction: Use Derby Version 10.0 only for development and test purposes. You cannot use this first release of Derby as a production database.
This Derby driver takes advantage of the Network Server support that the DB2 universal Type 4 JDBC driver provides. You cannot use any Version 4.0 data sources with Derby. Use the following one phase data source for the Derby Network Server using Universal JDBC driver:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
Requires JDBC driver files:
<classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar</classpath> <classpath>${CLOUDSCAPE_JDBC_DRIVER_PATH}/otherJars/db2jcc.jar</classpath> <classpath>${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar</classpath>which means that the db2jcc.jar from DB2 always takes precedence. Note that this also means that set the DB2 environment variable DB2UNIVERSAL_JDBC_DRIVER_PATH in WebSphere Application Server when you set up your DB2 data source. This is instead of hard coding the path of the db2jcc.jar for DB2 data sources.
Note: UNIVERSAL_JDBC_DRIVER_PATH is a WebSphere environment variable that is already mapped to the location in Websphere Application Server where the license jar file is located, and will only be used if the DB2UNIVERSAL_JDBC_DRIVER_PATH is not set. DB2 users should ensure that DB2UNIVERSAL_JDBC_DRIVER_PATH is set to avoid loading multiple versions of the db2jcc.jar file.
Note: DB2UNIVERSAL_JDBC_DRIVER_PATH
is a WebSphere environment variable that set to point to the location of db2jcc.jar file (that comes with DB2). This variable is set only if you create a DB2 provider.
Note: Derby requires only db2jcc_license_c.jar; however, WebSphere Application Server uses db2jcc_license_cu.jar because this works for both DB2 UDB and Derby.
Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.DerbyNetworkServerDataStoreHelper
Requires a valid authentication alias. Requires properties:
If no database currently exists for the path name you want to specify, simply append ;create=true to the path name to create a database dynamically. (For example: c:\temp\sampleDB;create=true )
See the Configuring Derby Version 10 topic for more information on configuring the Derby Network Server.
For more information on Derby, visit the Derby Web site at: http://incubator.apache.org/derby/.
Informix
The Informix JDBC Driver is a Type 4 JDBC driver that provides JDBC access to the Informix database. Informix JDBC Driver supports one phase data source:
com.informix.jdbcx.IfxConnectionPoolDataSourceRequires JDBC driver files:
ifxjdbc.jar ifxjdbcx.jarRequires DataStoreHelper class:
com.ibm.websphere.rsadapter.InformixDataStoreHelper
Requires a valid authentication alias. Requires properties:
To support IPv6: On AIX and Solaris, IBM Informix Dynamic Server 10.00 with fix pack 1 supports the IPv6 standard. To enable IPv6 on your WebSphere Application Server connection with one of these Informix releases, input your full IPv6 host name for the ifxIFXHOST property.
The Informix JDBC Driver (XA) is a Type 4 JDBC driver that provides XA-compliant JDBC access to the Informix database.
Informix JDBC Driver (XA) supports two phase data source:
com.informix.jdbcx.IfxXADataSourceRequires JDBC driver files:
ifxjdbc.jar ifxjdbcx.jarRequires DataStoreHelper class:
com.ibm.websphere.rsadapter.InformixDataStoreHelper
Requires a valid authentication alias. Requires properties:
To support IPv6: On AIX and Solaris, IBM Informix Dynamic Server 10.00 with fix pack 1 supports the IPv6 standard. To enable IPv6 on your WebSphere Application Server connection with one of these Informix releases, input your full IPv6 host name for the ifxIFXHOST property.
For more information on Informix, visit the Informix Web site at: http://www.ibm.com/software/data/informix/
Sybase
The Sybase jConnect JDBC driver is a Type 4 JDBC driver that provides JDBC access to the Sybase database. Sybase jConnect JDBC driver supports one phase data source:
com.sybase.jdbc2.jdbc.SybConnectionPoolDataSource
Requires JDBC driver files: jconn2.jar.
For IPv6 support: For
applications that access Sybase in an IPv6 environment, use the Sybase jConnect JDBC driver version 6.0 EBF 12884. This implementation uses different classes and therefore requires a different JAR file and a different implementation class designation. You can define the jConnect JDBC driver v6.0 EBF 12884
in the administrative console by selecting User-defined as the database type on the New JDBC provider page. On the JDBC provider general configuration page, replace the default JAR file name with jconn3.jar . For the implementation class, input com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource . The data store helper class and required properties are the same for all Sybase JDBC drivers.Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.SybaseDataStoreHelper
Requires a valid authentication alias. Requires properties:
The Sybase jConnect JDBC driver (XA) is a Type 4 JDBC driver that provides XA-compliant JDBC access to the Sybase database.
Sybase jConnect JDBC driver (XA) supports two phase data source:
com.sybase.jdbc2.jdbc.SybXADataSource
Requires JDBC driver files: jconn2.jar .
For IPv6 support: For applications that access Sybase in an IPv6 environment, use the Sybase jConnect JDBC driver version 6.0 EBF 12884. This implementation uses different classes and therefore requires a different JAR file and a different implementation class designation. You can define the jConnect JDBC driver v6.0 EBF 12884 in the administrative console by selecting User-defined as the database type on the New JDBC provider page. On the JDBC provider general configuration page, replace the default JAR file name with jconn3.jar . For the implementation class, input com.sybase.jdbc3.jdbc.SybXADataSource . The data store helper class and required properties are the same for all Sybase JDBC drivers. Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.SybaseDataStoreHelper
Requires a valid authentication alias. Requires properties:
For more information on Sybase, visit the Sybase Web site at: http://www.sybase.com/
Oracle
The Oracle JDBC Driver provides JDBC access to the Oracle database. This JDBC driver supports both Type 2 JDBC access and Type 4 JDBC access. Oracle JDBC Driver supports one phase data source:
oracle.jdbc.pool.OracleConnectionPoolDataSource
Requires JDBC driver files: ojdbc14.jar . (Note: If you require Oracle trace, use ojdbc14_g.jar .) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.OracleDataStoreHelper(Note: If you are running Oracle10g, use com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper .
Requires a valid authentication alias. Requires properties:
The Oracle JDBC Driver (XA) provides XA-compliant JDBC access to the Oracle database. This JDBC driver supports both Type 2 JDBC access and Type 4 JDBC access. Oracle JDBC Driver (XA) supports two phase data source:
oracle.jdbc.xa.client.OracleXADataSource
Requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar .) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.OracleDataStoreHelper(Note: If you are running Oracle10g, use com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper .
Requires a valid authentication alias. Requires properties:
For more information on Oracle, visit the Oracle Web site at: http://www.oracle.com/
MS SQL Server
DataDirect ConnectJDBC type 4 driver for MS SQL Server is a Type 4 JDBC driver that provides JDBC access to the MS SQL Server database. This provider is for use only with the Connect JDBC driver purchased from DataDirect Technologies. This JDBC provider supports this data source:
com.ddtek.jdbcx.sqlserver.SQLServerDataSourceRequires JDBC driver files:
sqlserver.jar , base.jar and util.jar(The spy.jar file is optional. You need this file to enable spy logging. The spy.jar file is not in the same directory as the other three jar files. Instead, it is located in the ../spy/ directory.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper
Requires a valid authentication alias. Requires properties:
DataDirect ConnectJDBC type 4 driver for MS SQL Server (XA) is a Type 4 JDBC driver which provides XA-compliant JDBC access to the MS SQL Server database. This provider is for use only with the Connect JDBC driver purchased from DataDirect Technologies.
This JDBC provider supports this data source:
com.ddtek.jdbcx.sqlserver.SQLServerDataSource.Requires JDBC driver files:
sqlserver.jar , base.jar and util.jar.(The spy.jar file is optional. You need this file to enable spy logging. The spy.jar file is not in the same directory as the other three jar files. Instead, it is located in the ../spy/ directory.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper
Requires a valid authentication alias. Requires properties:
For more information on the DataDirect ConnectJDBC driver, visit the DataDirect Web site at: http://www.datadirect-technologies.com/
WebSphere embedded ConnectJDBC driver for MS SQL Server is a Type 4 JDBC driver that provides JDBC access to the MS SQL Server database. This JDBC driver ships with WebSphere Application Server. Only use this provider with the Connect JDBC driver embedded in WebSphere; it cannot be used with a Connect JDBC driver purchased separately from DataDirect Technologies. This JDBC provider supports this data source:
com.ibm.websphere.jdbcx.sqlserver.SQLServerDataSource .
Requires JDBC driver files:
sqlserver.jar base.jar and util.jar.(The spy.jar file is optional. You need this file to enable spy logging. The spy.jar file for the WebSphere embedded Connect JDBC driver ships with WebSphere Application Server. All the files are located in the WAS_HOME/lib/ directory.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper
Requires a valid authentication alias. Requires properties:
WebSphere embedded ConnectJDBC driver for MS SQL Server (XA) is a Type 4 JDBC driver that provides JDBC access to the MS SQL Server database. This JDBC driver ships with WebSphere Application Server. Only use this provider with the Connect JDBC driver embedded in WebSphere; it cannot be used with Connect JDBC driver purchased separately from DataDirect Technologies. This JDBC provider supports this data source:
com.ibm.websphere.jdbcx.sqlserver.SQLServerDataSource .Requires JDBC driver files:
sqlserver.jar base.jar and util.jar.(An additional file, the spy.jar file, is optional. You need spy.jar for spy logging, which is a form of JDBC driver-level trace.
All of the JAR files in the previous list are shipped with WebSphere Application Server and are installed automatically with the product. They are also updated automatically when you apply WebSphere Application Server service packs. Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper
Requires a valid authentication alias. Requires properties:
Patches to the IBM WebSphere Connect JDBC driver jar files are installed automatically when you apply WebSphere Application Server service packs. However, to update Microsoft SQL Server-side programs for this JDBC driver, go to the IBM FTP site for WebSphere Application Server embedded product updates. Use the following URL:
ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htm
An important server-side program is Stored Procedures for the Java Transaction API (JTA). Whether you need to run one or two phase transactions with the XA-enabled IBM WebSphere Connect JDBC driver, install Stored Procedures for JTA on all machines that run Microsoft SQL. The WebSphere Application Server installation disks contain a base level of Stored Procedures for JTA. Go to the previously listed FTP site for updates to this API. Install Stored Procedures for JTA by performing the following steps:
ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htm
This type 3 JDBC driver for MS SQL Server is deprecated in WebSphere Application Server Version 6.0. Therefore it is no longer an available choice among provider types in the administrative console.
For best results with WebSphere Application Server JDBC access to MS SQL Server, use only JDBC drivers that are not marked for deprecation. However, if continue using a deprecated driver for JDBC access to MS SQL Server, you can configure it through the WebSphere Application Server administrative console. Follow the steps listed in Configuring a JDBC provider using the administrative console. Be sure to select User-defined for the database type. This selection triggers the console to display default class files, data source interfaces, and so on for your user-defined JDBC provider type. Replace those defaults with the following settings that are specific to the DataDirect SequeLink type 3 JDBC driver. DataDirect SequeLink type 3 JDBC driver supports the following data source:
com.ddtek.jdbcx.sequelink.SequeLinkDataSourceRequires JDBC driver files:
sljc.jar and spy-sl.jar(The JDBC driver shipped with WebSphere Application Server requires the sljc.jar and the spy-sl.jar files. The JDBC driver purchased from DataDirect requires the sljc.jar and the spy.jar files. The spy.jar and spy-sl.jar files are optional. You need these files to enable spy logging.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.SequeLinkDataStoreHelper
Requires a valid authentication alias. Requires properties:
The DataDirect SequeLink type 3 JDBC driver requires installation of SequeLink Server on all machines running MS SQL Server. See the readme.html file found in the DataDirect folder on the WebSphere Application Server CD for instructions on how to install SequeLink Server. (Install SequeLink Server from the WebSphere Application Server CD only if you are using the SequeLink JDBC driver embedded in WebSphere. Otherwise, install a copy of SequeLink Server purchased from DataDirect Technologies.) Patches to the IBM WebSphere SequeLink JDBC driver jar files are installed automatically when applying WebSphere Application Server service packs. If updates are ever needed for the Microsoft SQL Server-side installables (SequeLink server) for the IBM WebSphere SequeLink JDBC driver, they will be made available from the following FTP site:
ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htmFor more information on the DataDirect SequeLink type 3 JDBC driver, visit the DataDirect Web site at:
http://www.datadirect-technologies.com/
This type 4 JDBC driver for MS SQL Server 2000 is deprecated in WebSphere Application Server Version 6.0. Therefore it is no longer an available choice among provider types in the administrative console.
For best results with WebSphere Application Server JDBC access to MS SQL Server, use only JDBC drivers that are not marked for deprecation. However, if continue using a deprecated driver for JDBC access to MS SQL Server, you can configure it through the WebSphere Application Server administrative console. Follow the steps listed in Configuring a JDBC provider using the administrative console. Be sure to select User-defined for the database type. This selection triggers the console to display default class files, data source interfaces, and so on for your user-defined JDBC provider type. Replace those defaults with the following settings that are specific to the Microsoft JDBC driver for MS SQL Server 2000. Microsoft JDBC driver for MS SQL Server 2000 supports the following data source:
com.microsoft.jdbcx.sqlserver.SQLServerDataSourceRequires JDBC driver files:
mssqlserver.jar , msbase.jar and msutil.jar(The spy.jar file is optional. You need it to enable spy logging. However, Microsoft does not ship the spy.jar file. Contact Microsoft about this issue.) Requires DataStoreHelper class:
com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper
Requires a valid authentication alias. Requires properties:
http://www.microsoft.com/sql
Related concepts
Data sources
Resource adapter
JDBC providers
Related tasks
Configuring a JDBC provider and data source
Configuring a JDBC provider using the administrative console
Configuring a data source using the administrative console
Creating and configuring a JDBC provider and data source using the Java Management