These properties vary according to the database vendor requirements for JDBC driver implementations. Set the appropriate properties on every data source that you configure. These settings are for MS SQL Server data sources. MS SQL Server 2005: WebSphere Application Server V6.10 supports JDBC transactions with the new Microsoft SQL Server 2005, as well as Microsoft SQL Server 2000. For access to either version of the database, use V3.5, Service pack 2, of either of the following JDBC providers:
These JDBC drivers provide the same function for MS SQL Server 2005 as MS SQL Server 2000. As long as you use only those new features of MS SQL Server 2005 that have no impact on JDBC transactions, you generally risk no exceptions by upgrading to the new version. WebSphere Application Server does, however, support two new options for setting isolation level in MS SQL Server 2005: SNAPSHOT and READ_COMMITTED_SNAPSHOT. The following chart describes these isolation levels as well as the few requirements and concerns for using MS SQL Server 2005 with Application Server v6.1.
Compatibility or New Usage concern | Resolution or Recommended action | |||||
---|---|---|---|---|---|---|
New requirements: | Specifying your database version | You do not have to specify your version of MS SQL Server. Specify the name of your database as usual. WebSphere Application Server detects the version and makes any necessary class attribute adjustments. | ||||
Parenthesis requirement for locking hints | MS SQL Server 2005 requires that you place parentheses
around locking hints. For example:
select value from t1 (holdlock) where name = ? | |||||
New syntax for joining multiple locking hints |
| |||||
Use of the alternate servers custom data source property | Verify that all application component clients of the data source issue commands that are valid for both database versions before you configure the alternate servers property to include both MS SQL Server 2005 and Server 2000 machines. | |||||
Deprecated data types | Microsoft deprecated three data types for SQL Server
2005, which are shown in the following list along with each replacement data
type:
| |||||
New features: | SNAPSHOT isolation level | This new isolation level implements optimistic locking
for transactions in which MS SQL Server 2005 serializes the data.You must
configure the ALLOW_SNAPSHOT_ISOLATION setting on the database, and then set
the isolation level in one of two ways:
READ_COMMITTED_SNAPSHOT isolation level
| This isolation level is a new implementation of Read
committed. The policy enforces optimistic locking for read operations with
MS SQL Server 2005.You must configure the isolation level on the database.
Then invoke the method setTransactionIsolation with the attribute:
| conn.setTransactionIsolation (java.sql.Connection.TRANSACTION_READ_COMMITTED) Transact-SQL enhancements, including: new functions,
additional data types, and the ability to create recursive queries
| WebSphere Application Server does not currently support
these features; do not use them with WebSphere Application Server Version
6.10.
| |
Consult the Backward Compatibility for MS SQL Server components Web page for a complete list of deprecated items, as well as backward compatibility provisions, for MS SQL Server 2005.
For the MS SQL Server JDBC drivers that support both database versions, perform the same steps and set the same class paths and properties that were previously required for MS SQL Server 2000. You can configure the following types of providers:
DataDirect ConnectJDBC type 4 driver for MS SQL Server is a Type 4 JDBC driver that provides JDBC access to the MS SQL Server 2005 and MS SQL Server 2000 databases. 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 2005 and MS SQL Server 2000 databases. 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:
WebSphere embedded ConnectJDBC driver for MS SQL Server is a Type 4 JDBC driver that provides JDBC access to the MS SQL Server 2005 and MS SQL Server 2000 databases. 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.)
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:
WebSphere embedded ConnectJDBC driver for MS SQL Server (XA) is a Type 4 JDBC driver that supports two-phase commit transactions on connections with the MS SQL Server 2005 and MS SQL Server 2000 databases. This JDBC driver ships with WebSphere Application Server. Use this provider with the IBM WebSphere Connect JDBC driver embedded in WebSphere Application Server. Do not use it with the DataDirect Connect JDBC driver purchased separately from DataDirect Technologies. The ConnectJDBC provider supports the following 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. Find the link at the end of this article.
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:
This type 3 JDBC driver for MS SQL Server is deprecated in WebSphere Application Server V6.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. Incompatible with MS SQL Server 2005: Use this JDBC driver for access to MS SQL Server 2000 only. 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 FTP site for MS SQL Server-side JDBC driver updates. See the FTP link at the end of this article.
This type 4 JDBC driver for MS SQL Server 2000 is deprecated in WebSphere Application Server V6.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: