IBM DB2 Manual page 494

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
478
Application Programming Guide and Reference for Java
– IBM Informix Connect or the IBM Informix Client Software Development Kit
(Client SDK), Version 3.50 or later
– A primary server and one or more secondary servers of any type (HDR
secondary, SD secondary, or RS secondary)
Client requirements:
IBM Data Server Driver for JDBC and SQLJ version 3.52 or later
v
v WebSphere Application Server, Version 5.1 or later
The following procedure is an example of enabling the IBM Data Server Driver for
JDBC and SQLJ the workload balancing function with WebSphere Application
Server. The values that are specified are not intended to be recommended values.
You need to determine values based on factors like these:
v Availability of system resources
v The number of physical connections available
v The desired ratio of connection objects to transport objects
1. Verify that the IBM Data Server Driver for JDBC and SQLJ is at the correct level
to support workload balancing by following these steps:
a. Issue the following command in a command line window:
java com.ibm.db2.jcc.DB2Jcc -version
b. Find a line in the output like this, and check that nnn is 3.52 or later.
[jcc] Driver: IBM Data Server Driver for JDBC and SQLJ Architecture nnn xxx
2. Set IBM Data Server Driver for JDBC and SQLJ properties to enable workload
balancing. You can set the properties in the following ways.
v Set IBM Data Server Driver for JDBC and SQLJ configuration properties to
enable the same workload balancing behavior for all DataSource or
Connection instances that are created under the driver. To do that:
a. Create a DB2JccConfiguration.properties file or edit the existing
DB2JccConfiguration.properties file.
b. Set the following configuration properties:
– db2.jcc.minTransportObjects
– db2.jcc.maxTransportObjects
– db2.jcc.maxTransportObjectWaitTime
– db2.jcc.dumpPool
– db2.jcc.dumpPoolStatisticsOnSchedule
– db2.jcc.dumpPoolStatisticsOnScheduleFile
Start with settings similar to these:
db2.jcc.minTransportObjects=0
db2.jcc.maxTransportObjects=1500
db2.jcc.maxTransportObjectWaitTime=-1
db2.jcc.dumpPool=0
db2.jcc.dumpPoolStatisticsOnSchedule=60
db2.jcc.dumpPoolStatisticsOnScheduleFile=/home/WAS/logs/srv1/poolstats
c. Add the directory path for DB2JccConfiguration.properties to the
WebSphere Application Server IBM Data Server Driver for JDBC and
SQLJ classpath.
v If you do not want the same workload balancing behavior for all DataSource
or Connection instances, you can set the workload balancing properties on
individual Connection or DataSource instances.
3. Set IBM Data Server Driver for JDBC and SQLJ data source properties to enable
workload balancing:
In the WebSphere Application Server administrative console, set the following
properties for the DataSource that your application uses to connect to the data
™