[Version 5.0.2 and later]Vendor-specific data sources minimum required settings

The following list contains descriptions for every JDBC provider that can be defined for use with WebSphere Application Server Versions 5.x and 5.1.x. It also shows the supported data source classes and their required properties.

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 properties list. Rather, inclusion in the list means that a value is typically required for that field.

Use this list to find the provider information:

DB2

  1. [Version 5.0.2 and later]DB2 Universal JDBC Provider

    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, you must install DB2 Version 8.1 or a later version. To use the Type 2 driver, you must install DB2 Version 8.1 Fix Pack 2 or a later version.

    This driver only supports one phase transactions. This JDBC driver allows applications to use both JDBC and Structured Query Language in Java (SQLJ) access.

    The DB2 Universal JDBC Driver supports one phase data source:

    com.ibm.db2.jcc.DB2ConnectionPoolDataSource

    The provider requires JDBC driver files:
    • db2jcc.jar After you install DB2, you can find this jar file in the DB2 java directory. For Type 4 JDBC driver support from a client machine where DB2 is not installed, copy this file to the local machine. If you install any fixes or upgrades to DB2, you must update this file as well. You must also set the DB2UNIVERSAL_JDBC_DRIVER_PATH path variable to point to the db2jcc.jar file. See the Cloudscape section for more information on the DB2UNIVERSAL_JDBC_DRIVER_PATH path variable.

      Note: To find out the version of the universal driver you are using, issue this DB2 command:

      java com.ibm.db2.jcc.DB2Jcc -version
      The output for the above example is:
      IBM DB2 JDBC Universal Driver Architecture 1.5.xx

    • db2jcc_license_cu.jar This is the DB2 Universal JDBC driver license file that allows access to the DB2 Universal database. Use this jar file or the next one to gain access to the database. This jar file ships with WebSphere Application Server in a directory defined by ${UNIVERSAL_JDBC_DRIVER_PATH}environment variable.
    • db2jcc_license_cisuz.jar This is the DB2 Universal JDBC driver license file that allows access to the following databases:
      • DB2 Universal
      • DB2 for iSeries
      • DB2 for z/OS
      • SQLDS

      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.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    If you use this provider to connect to DB2 for z/OS, you must change the data store helper class to:
    com.ibm.websphere.rsadapter.DB2390DataStoreHelper

    The driver requires a valid authentication alias.

    It requires the following properties:

    • databaseName This is an actual database name if the driverType is set to 4, or a locally cataloged database name if the driverType is set to 2.
    • driverType The JDBC connectivity type of a data source. There are two permitted values: 2 and 4. If you want to use Universal JDBC Type 2 driver, set this value to 2. If you want to use Universal JDBC Type 4 driver, set this value to 4.
    • serverName The TCP/IP address or host name for the Distributed Relational Database Architecture (DRDA) server. Provide a value for this property only if your driverType is set to 4. This property is not required if your driverType is set to 2.
    • portNumber The TCP/IP port number where the DRDA server resides. Provide a value for this property only if your driverType is set to 4. This property is not required if your driverType is set to 2.

  2. [Version 5.0.2 and later]DB2 Universal JDBC Provider (XA)

    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, you must 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 supports the two phase data source:

    com.ibm.db2.jcc.DB2XADataSource
    

    This provider requires JDBC driver files:

    • db2jcc.jar After you install DB2, you can find this .jar file in the DB2 java directory. For Type 4 JDBC driver support from a client machine where DB2 is not installed, copy this file to the local machine. If you install any fixes or upgrades to DB2, you must update this file as well. You must also set the DB2UNIVERSAL_JDBC_DRIVER_PATH environment variable to point to the db2jcc.jar file. See the Cloudscape section for more information on the DB2UNIVERSAL_JDBC_DRIVER_PATH environment variable.

      Note: 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 1.5.xx

    • db2jcc_license_cu.jar This is the DB2 Universal JDBC driver license file that allows access to the DB2 Universal database. Use this jar file or the next one to gain access to the database. This jar file ships with WebSphere Application Server in the WAS_HOME/universalDriver/lib directory.
    • db2jcc_license_cisuz.jar This is the DB2 Universal JDBC driver license file that allows access to the following databases:
      • DB2 Universal
      • DB2 for iSeries
      • DB2 for z/OS
      • SQLDS

      You must use the right license jar file to access a specific database backend.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    If you use this provider to connect to DB2 for z/OS, you must change the data store helper class to:
    com.ibm.websphere.rsadapter.DB2390DataStoreHelper

    The driver requires a valid authentication alias.

    It also requires the following properties:

    • databaseName This is a locally cataloged database name.
    • driverType This is the JDBC connectivity type of a data source. The only permitted value is 2.

  3. DB2 legacy CLI-based Type 2 JDBC Provider

    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

    This provider requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2DataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  4. DB2 legacy CLI-based Type 2 JDBC Provider (XA)

    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 

    This provider requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2DataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  5. DB2 JDBC Provider -- Deprecated

    This JDBC provider is the same as the DB2 Legacy CLI-based Type 2 JDBC Driver. This JDBC driver is deprecated. Use the DB2 Legacy CLI-based Type 2 JDBC Driver instead of this one.

    DB2 JDBC Provider supports one phase data source:

    COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource

    This provider requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2DataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  6. DB2 JDBC Provider (XA) -- Deprecated

    This JDBC provider is the same as the DB2 Legacy CLI-based Type 2 JDBC Driver (XA). This JDBC driver is deprecated. Use the DB2 Legacy CLI-based Type 2 JDBC Driver (XA) instead of this one.

    DB2 JDBC Provider (XA) supports two phase data source:

    COM.ibm.db2.jdbc.DB2XADataSource

    This provider requires JDBC driver files: db2java.zip (Note: If you run SQLJ in DB2 Version 8, db2jcc.jar is also required.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2DataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

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

  1. DB2 UDB for iSeries (Native - Version 5 Release 2 and later)

    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

    This provider requires JDBC driver files: db2_classes.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    It does not require an authentication alias.

    This driver requires the following properties:

    • databaseName The name of the relational database to which the data source connections are established. This name must appear in the iSeries Relational Database Directory. The default is *LOCAL.

  2. DB2 UDB for iSeries (Native XA - Version 5 Release 2 and later)

    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

    This provider requires JDBC driver files: db2_classes.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    It does not require an authentication alias.

    This driver requires the following properties:

    • databaseName The name of the relational database to which the data source connections are established. This name must appear in the iSeries Relational Database Directory. The default is *LOCAL.

  3. DB2 UDB for iSeries (Native - Version 5 Release 1 and earlier)

    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

    This provider requires JDBC driver files: db2_classes.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    It does not require an authentication alias.

    The driver requires the following properties:

    • databaseName The name of the relational database to which the data source connections are established. This name must appear in the iSeries Relational Database Directory. The default is *LOCAL.

    The V5R1 and earlier JDBC drivers, although still supported, will receive no further enhancements. We recommend that you replace them with the V5R2 JDBC driver providers.

  4. DB2 UDB for iSeries (Native XA - Version 5 Release 1 and earlier)

    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

    This provider requires JDBC driver files: db2_classes.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    It does not require an authentication alias.

    This driver requires the following properties:

    • databaseName The name of the relational database to which the data source connections are established. This name must appear in the iSeries Relational Database Directory. The default is *LOCAL.

    The V5R1 and earlier JDBC drivers, although still supported, will receive no further enhancements. We recommend that you replace them with the V5R2 JDBC driver providers.

  5. DB2 UDB for iSeries (Toolbox)

    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
    

    This provider requires JDBC driver files: jt400.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    This driver 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.

    It requires the following properties:

    • serverName The name of the server from which the data source obtains connections. Example: myserver.mydomain.com.

  6. DB2 UDB for iSeries (Toolbox XA)

    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

    This provider requires JDBC driver files: jt400.jar

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2AS400DataStoreHelper

    This driver 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.

    The driver requires the following properties:

    • serverName The name of the server from which the data source obtains connections. Example: myserver.mydomain.com.

For more information on DB2 UDB for iSeries, visit the DB2 Web site at: http://www.ibm.com/software/data/db2/

DB2 for z/OS

  1. DB2 for z/OS JDBC Provider

    The DB2 for z/OS JDBC Provider provides remote JDBC access to DB2 on z/OS. This is the Legacy CLI-based JDBC driver. You cannot use this driver locally on DB2 z/OS. Use the DB2 for z/OS Local JDBC Provider (RRS) on local z/OS systems. You cannot see this JDBC Provider on the JDBC Provider drop down list in the administrative console. To create DB2 for z/OS data sources, use the DB2 Legacy CLI-based Type 2 JDBC Driver instead of this one, and change the DataStoreHelper class to com.ibm.websphere.rsadapter.DB2390DataStoreHelper.

    DB2 for z/OS JDBC provider supports one phase data source:

    COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource 
    

    This provider requires JDBC driver files: db2java.zip

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2390DataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  2. DB2 for z/OS JDBC Provider (XA)

    The DB2 for z/OS JDBC Provider provides remote XA-compliant JDBC access to DB2 on z/OS. You cannot use this driver locally on DB2 z/OS. Use the DB2 for z/OS Local JDBC Provider (RRS) on local z/OS systems. You cannot see this JDBC Provider on the JDBC Provider drop down list in the administrative console. To create DB2 for z/OS XA data sources, use the DB2 Legacy CLI-based Type 2 JDBC Driver (XA) instead of this one, and change the DataStoreHelper class to com.ibm.websphere.rsadapter.DB2390DataStoreHelper.

    DB2 for z/OS JDBC (XA) provider supports two phase data source:

    COM.ibm.db2.jdbc.DB2XADataSource 
    

    This provider requires JDBC driver files: db2java.zip

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2390DataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  3. DB2 for z/OS Local JDBC Provider (RRS)

    The DB2 for z/OS Local JDBC Provider provides local JDBC access to DB2 on z/OS. This provider uses the native z/OS Resource Recovery Services (RRS) transaction manager to handle two-phase commit transactions. You cannot see this JDBC Provider on the JDBC Provider drop down list in the administrative console. This JDBC Provider is only used when accessing local databases in the z/OS system. Currently this JDBC Provider is only supported in WebSphere Application Server for z/OS.

    DB2 for z/OS Local JDBC provider supports two phase data source:

    COM.ibm.db2.jcc.DB2ConnectionPoolDataSource 
    

    This provider requires JDBC driver files: db2j2classes.zip

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.DB2390LocalDataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

For more information on DB2 for z/OS, visit the DB2 Web site at: http://www.ibm.com/software/data/db2/ .

Cloudscape

  1. Cloudscape JDBC Provider

    The Cloudscape JDBC Provider provides the JDBC access to the Cloudscape database. This Cloudscape JDBC driver used 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  

    This provider requires JDBC driver files: db2j.jar. (This file ships with WebSphere Application Server. If you are running Cloudscape Version 5.1, you can find this file in the WAS_HOME/cloudscape/lib directory).

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  2. Cloudscape JDBC Provider (XA)

    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 

    This provider requires JDBC driver files: db2j.jar (This file ships with WebSphere Application Server. If you are running Cloudscape Version 5.1, you can find this file in the WAS_HOME/cloudscape/lib directory).

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper

    This driver does not require a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database from which the data source obtains connections. Example: Sample or c:\sample.

  3. [Version 5.0.2 and later]Cloudscape Network Server using Universal JDBC driver

    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

    This provider requires JDBC driver files:

    • db2jcc.jar If you install and run DB2, you must use the db2jcc.jar file that comes with DB2. To do that, the classpath in the JDBC template for Cloudscape network server is set to be:
      <classpath>${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar</classpath>
      
      <classpath>${CLOUDSCAPE_JDBC_DRIVER_PATH}/otherJars/db2jcc.jar</classpath>
      
      <classpath>${CLOUDSCAPE_JDBC_DRIVER_PATH}/db2j.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 you must 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.
    • db2jcc_license_cu.jar This file is the DB2 Universal JDBC license file that provides access to the Cloudscape databases using the Network Server framework. Use this file to gain access to the database. This file ships with WebSphere and is located in ${UNIVERSAL_JDBC_DRIVER_PATH}.

      Note: UNIVERSAL_JDBC_DRIVER_PATHis 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 vesions of the db2jcc.jar file.

      Note: DB2UNIVERSAL_JDBC_DRIVER_PATH is a WebSphere environment variable that you must 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. See the DB2 section for more information on the DB2UNIVERSAL_JDBC_DRIVER_PATH path variable.

      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.

    The driver 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.

    This driver also requires a valid authentication alias.

    It requires the following properties:

    • databaseName The name of the database and the list of Cloudscape attributes. Example: c:\sample;create=true.
    • driverType Only the Type 4 driver is allowed.
    • serverName The TCP/IP address or the host name for the Distributed Relational Database Architecture (DRDA) server.
    • portNumber The TCP/IP port number where the DRDA server resides. The default value is port 1527.
    • retrieveMessagesfromServerOnGetMessage This property is required by WebSphere Application Server, not the database. The default value is false. You must set the value of this property to true, to enable text retrieval using the SQLException.getMessage() method.

    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/

Informix

  1. Informix JDBC Provider

    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.IfxConnectionPoolDataSource

    This provider requires JDBC driver files:

       ifxjdbc.jar
       ifxjdbcx.jar
    

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.InformixDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the Informix instance on the server. Example: ol_myserver.
    • portNumber The port on which the instances listen. Example: 1526.
    • ifxIFXHOST The physical name of the database server. Example: myserver.mydomain.com.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • informixLockModeWait Although not required, this property enables you to set the number of seconds that Informix software waits for a lock. By default, Informix code throws an exception if it cannot immediately acquire a lock. Example: 2.

  2. Informix JDBC Provider (XA)

    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.IfxXADataSource

    This provider requires JDBC driver files:

       ifxjdbc.jar
       ifxjdbcx.jar
    

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.InformixDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the Informix instance on the server. Example: ol_myserver.
    • portNumber The port on which the instances listen. Example: 1526.
    • ifxIFXHOST The physical name of the database server. Example: myserver.mydomain.com.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • informixLockModeWait Although not required, this property enables you to set the number of seconds that Informix software waits for a lock. By default, Informix code throws an exception if it cannot immediately acquire a lock. Example: 2.

For more information on Informix, visit the Informix Web site at: http://www.ibm.com/software/data/informix/

Sybase

  1. Sybase JDBC Provider

    The Sybase JDBC Driver is a Type 4 JDBC driver that provides JDBC access to the Sybase database.

    Sybase JDBC Driver supports one phase data source:

    com.sybase.jdbc2.jdbc.SybConnectionPoolDataSource 
    

    This provider requires JDBC driver files: jconn2.jar.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SybaseDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the database server. Example: myserver.mydomain.com.
    • [Version 5.0.1 and later] databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • portNumber The TCP/IP port number through which all communications to the server take place. Example: 4100.

  2. Sybase JDBC Provider (XA)

    The Sybase JDBC Driver (XA) is a Type 4 JDBC driver that provides XA-compliant JDBC access to the Sybase database.

    Sybase JDBC Driver (XA) supports two phase data source:

    com.sybase.jdbc2.jdbc.SybXADataSource 

    This provider requires JDBC driver files: jconn2.jar.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SybaseDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the database server. Example: myserver.mydomain.com
    • [Version 5.0.1 and later] databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • portNumber The TCP/IP port number through which all communications to the server take place. Example: 4100.

  3. Sybase 12.0 JDBC Provider -- Deprecated

    This JDBC Driver provider is the same as Sybase JDBC Driver. This JDBC driver is deprecated. Use Sybase JDBC Driver instead of this one.

    Sybase 12.0 JDBC Driver supports one phase data source:

     com.sybase.jdbc2.jdbc.SybConnectionPoolDataSource
    

    This provider requires JDBC driver files: jconn2.jar.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SybaseDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the database server. Example: myserver.mydomain.com
    • [Version 5.0.1 and later] databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • portNumber The TCP/IP port number through which all communications to the server take place. Example: 4100.

  4. Sybase 12.0 JDBC Provider (XA) -- Deprecated

    This JDBC Driver provider is the same as Sybase JDBC Driver (XA). This JDBC driver is deprecated. Use the Sybase JDBC Driver (XA) instead of this one.

    Sybase 12.0 JDBC Driver (XA) supports two phase data source:

    com.sybase.jdbc2.jdbc.SybXADataSource
    

    This provider requires JDBC driver files: jconn2.jar.

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SybaseDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the database server. Example: myserver.mydomain.com
    • [Version 5.0.1 and later] databaseName The name of the database from which the data source obtains connections. Example: Sample.
    • portNumber The TCP/IP port number through which all communications to the server take place. Example: 4100.

For more information on Sybase, visit the Sybase Web site at: http://www.sybase.com/

Oracle

  1. Oracle JDBC Provider

    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
    

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@myServer:1521:myDatabase, where myServer is the server name, 1521 is the port it is using for communication, and myDatabase is the database name.

  2. Oracle JDBC Provider (XA)

    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
    

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@myServer:1521:myDatabase, where myServer is the server name, 1521 is the port it is using for communication, and myDatabase is the database name.

  3. Oracle JDBC Thin Provider -- Deprecated

    Both the Oracle JDBC Thin Driver and the Oracle JDBC oci8 Driver are deprecated. Use the Oracle JDBC Driver instead of these two.

    Oracle JDBC Thin Driver is a Type 4 JDBC driver that provides JDBC access to the Oracle database. Oracle JDBC Thin Driver is deprecated. Use the Oracle JDBC Driver instead of this one.

    Oracle JDBC Thin Driver supports one phase data source:

     oracle.jdbc.pool.OracleConnectionPoolDataSource

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL. The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@localhost:1521:sample for thin driver and jdbc:oracle:oci8:@sample for thick driver, where localhost is the server name, 1521 is the port it is using for communication, and sample is the database name.

  4. Oracle JDBC Thin Provider (XA) -- Deprecated

    Both the Oracle JDBC Thin Driver (XA) and the Oracle JDBC oci8 Driver (XA) are deprecated. Use the Oracle JDBC Driver (XA) instead of these two.

    Oracle JDBC Thin Driver (XA) is a Type 4 JDBC driver that provides XA-compliant JDBC access to the Oracle database. Oracle JDBC Thin Driver (XA) is deprecated. Use the Oracle JDBC Driver (XA) instead of this one.

    Oracle JDBC Thin Driver (XA) supports two phase data source:

     oracle.jdbc.xa.client.OracleXADataSource
    

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@localhost:1521:sample for thin driver and jdbc:oracle:oci8:@sample for thick driver, where localhost is the server name, 1521 is the port it is using for communication, and sample is the database name.

  5. Oracle JDBC oci8 Provider -- Deprecated

    Both the Oracle JDBC Thin Driver and the Oracle JDBC oci8 Driver are deprecated. Use the Oracle JDBC Driver instead of these two.

    Oracle JDBC oci8 Driver is a Type 2 JDBC driver that provides JDBC access to the Oracle database. Oracle JDBC oci8 Driver is deprecated. Use the Oracle JDBC Driver instead of this one.

    Oracle JDBC oci8 Driver supports one phase data source:

    oracle.jdbc.pool.OracleConnectionPoolDataSource
    

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@localhost:1521:sample for thin driver and jdbc:oracle:oci8:@sample for thick driver, where localhost is the server name, 1521 is the port it is using for communication, and sample is the database name.

  6. Oracle JDBC oci8 Provider (XA) -- Deprecated

    Both the Oracle JDBC Thin Driver (XA) and the Oracle JDBC oci8 Driver (XA) are deprecated. Use the Oracle JDBC Driver (XA) instead of these two.

    Oracle JDBC oci8 Driver (XA) is a Type 2 JDBC driver that provides XA-compliant JDBC access to the Oracle database. Oracle JDBC oci8 Driver (XA) is deprecated. Use the Oracle JDBC Driver (XA) instead of this one.

    Oracle JDBC oci8 Driver (XA) supports two phase data source:

     oracle.jdbc.xa.client.OracleXADataSource
    

    This provider requires JDBC driver files: ojdbc14.jar. (Note: If you require Oracle trace, use ojdbc14_g.jar.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.OracleDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • URL The URL that indicates the database from which the data source obtains connections. Example: jdbc:oracle:thin:@localhost:1521:sample for thin driver and jdbc:oracle:oci8:@sample for thick driver, where localhost is the server name, 1521 is the port it is using for communication, and sample is the database name.

For more information on Oracle, visit the Oracle Web site at: http://www.oracle.com/

MS SQL Server

  1. DataDirect ConnectJDBC type 4 driver for 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 ConnectJDBC driver purchased from DataDirect Technologies.

    This JDBC provider supports this data source:

     com.ddtek.jdbcx.sqlserver.SQLServerDataSource

    It 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  2. DataDirect ConnectJDBC type 4 driver for MS SQL Server (XA)

    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 ConnectJDBC driver purchased from DataDirect Technologies.

    This JDBC provider supports this data source:

    com.ddtek.jdbcx.sqlserver.SQLServerDataSource.
    

    It 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

    For more information on the DataDirect ConnectJDBC driver, visit the DataDirect Web site at: http://www.datadirect-technologies.com/

  3. WebSphere embedded ConnectJDBC driver for MS SQL Server

    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.
    

    This provider 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  4. WebSphere embedded ConnectJDBC driver for MS SQL Server (XA)

    WebSphere embedded ConnectJDBC driver for MS SQL Server (XA) is a Type 4 JDBC driver which provides XA-compaint JDBC access to the MS SQL Server database. This JDBC driver ships with WebSphere Application Server. Use this provider with the Connect JDBC driver embedded in WebSphere. Do not use it with a Connect JDBC driver purchased separately from DataDirect Technologies.

    This JDBC provider supports this data source:

     com.ibm.websphere.jdbcx.sqlserver.SQLServerDataSource.
    

    This provider 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

    To view the instructions for installing Stored Procedures for JTA (required when enabling two-phase commit) on the WebSphere CD, refer to the following FTP site:

    How to install "Stored Procedures for JTA" from the WebSphere CD
    
    

    You can download the latest patches and upgrades to the WebSphere embedded ConnectJDBC drivers from the following FTP site:

    ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htm
    
    

  5. DataDirect SequeLink type 3 JDBC driver for MS SQL Server

    DataDirect SequeLink type 3 JDBC driver for MS SQL Server is a type 3 JDBC driver that provides JDBC access to MS SQL Server via SequeLink server. This JDBC driver provider is for use only with the SequelLink type 3 JDBC driver purchased from DataDirect Technologies.

    This JDBC provider supports the data source:

     com.ddtek.jdbcx.sequelink.SequeLinkDataSource
    

    This provider requires JDBC driver files:

     sljc.jar and
     spy-sl53.jar
    
    (The JDBC driver shipped with WebSphere Application Server requires the sljc.jar and the spy-sl53.jar files. The JDBC driver purchased from DataDirect requires the sljc.jar and the spy.jar files. The spy.jar and spy-sl35.jar files are optional. You need these files to enable spy logging.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SequeLinkDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which SequeLink Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that SequeLink Server uses for communication. By default, SequeLink Server uses port 19996.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  6. DataDirect SequeLink type 3 JDBC driver for MS SQL Server (XA)

    DataDirect SequeLink type 3 JDBC driver for MS SQL Server (XA) is a type 3 JDBC driver that provides XA-compliant JDBC access to MS SQL Server via the SequeLink server. This JDBC driver provider is for use only with the SequelLink type 3 JDBC driver purchased from DataDirect Technologies

    This JDBC provider supports the data source:

    com.ddtek.jdbcx.sequelink.SequeLinkDataSource
    

    This provider requires JDBC driver files:

     sljc.jar and
    spy-sl53.jar
    
    (The JDBC driver shipped with WebSphere Application Server requires the sljc.jar and the spy-sl53.jar files. The JDBC driver purchased from DataDirect requires the sljc.jar and the spy.jar files. The spy.jar and spy-sl35.jar files are optional. You need these files to enable spy logging.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.SequeLinkDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which SequeLink Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that SequeLink Server uses for communication. By default, SequeLink Server uses port 19996.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

    To view instructions for installing SequeLink Server from the WebSphere CD, refer to this FTP site:

    How to install SequeLink Server from the WebSphere CD
    
    
    Only install the SequeLink server from the WebSphere CD if you are using the SequeLink JDBC driver embedded in WebSphere. Otherwise, install the SequeLink server purchased from DataDirect Technologies.

    You can download the latest patches and upgrades to the WebSphere embedded SequeLink type 3 JDBC drivers from the following FTP site:

    ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htm
    
    

    For more information on the DataDirect SequeLink type 3 JDBC driver, visit the DataDirect Web site at:

    http://www.datadirect-technologies.com/
    
    

  7. [Version 5.0.1 and later]Microsoft JDBC driver for MSSQLServer 2000

    Microsoft JDBC driver for MSSQLServer 2000 is a type 4 JDBC driver that provides JDBC access to the MS SQL Server database.

    This JDBC provider supports this data source:

    com.microsoft.jdbcx.sqlserver.SQLServerDataSource
    

    This provider requires 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

  8. [Version 5.0.1 and later]Microsoft JDBC driver for MSSQLServer 2000 (XA)

    Microsoft JDBC driver for MSSQLServer 2000 (XA) is a type 4 JDBC driver that provides XA-compaint JDBC access to the MS SQL Server database.

    This JDBC provider supports this data source:

    com.microsoft.jdbcx.sqlserver.SQLServerDataSource
    

    This provider requires 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.)

    The driver requires DataStoreHelper class:

    com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper

    It also requires a valid authentication alias.

    This driver requires the following properties:

    • serverName The name of the server in which MS SQL Server resides. Example: myserver.mydomain.com
    • portNumber The TCP/IP port that MS SQL Server uses for communication. Port 1433 is the default.
    • databaseName The name of the database from which the data source obtains connections. Example: Sample.

For more information on the Microsoft JDBC driver, visit the Microsoft Web site at:

http://www.microsoft.com/sql


Related concepts
Data sources
Resource adapter
JDBC providers
Related tasks
Creating and configuring a data source using the administrative console
Creating and configuring a JDBC provider using the administrative console
Creating and configuring a JDBC provider and data source using the Java Management Extensions API



Searchable topic ID:   minreq
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/rdat_minreq.html

Library | Support | Terms of Use | Feedback