DB2 V9.7 for Linux, UNIX, and Windows

安装 IBM Data Server Driver for JDBC and SQLJ

在安装 IBM® Data Server Driver for JDBC and SQLJ 之后，您可以准备并运行 JDBC 或 SQLJ 应用程序。

关于此任务

限制：如果将 IBM Data Server Driver for JDBC and SQLJ 安装在 Windows 64 位操作系统上，那么无法使用 IBM Data Server Driver for JDBC and SQLJ type 2 connectivity来从 32 位 Java 应用程序连接到 DB2 Database for Linux, UNIX, and Windows 实例。

请执行下列步骤，以便安装 IBM Data Server Driver for JDBC and SQLJ。

开始之前

在安装 IBM Data Server Driver for JDBC and SQLJ 之前，需要以下软件。

SDK for Java 1.4.2 或更高版本。
对于除 IBM Data Server Runtime Client 和 IBM Data Server Driver Package 以外的所有 DB2® 产品，DB2 Database for Linux, UNIX, and Windows 安装过程将自动安装 SDK for Java V5。

如果要使用 JDBC 4.0 功能，那么需要安装 SDK for Java 6 或更高版本。

如果要使用 JDBC 4.1 功能，那么需要安装 SDK for Java 7 或更高版本。

如果您计划在系统上运行 JDBC 或 SQLJ 应用程序，但无需准备这些应用程序，那么只需要 Java 运行时环境。

要点：建议您不要对 Java 例程使用对 SDK for Java 1.4.2 的支持，并且可能在将来的发行版中除去此支持。
JVM 本机线程支持
任何运行那些需要访问 DB2 数据库的 Java 应用程序的 JVM 都必须包括本机线程支持。通过将 THREADS_FLAG 环境变量设置为“native”，可以指定本机线程作为某些 JVM 的缺省线程支持。有关使本机线程成为系统上的缺省线程的指示信息，请参阅 Java 环境的文档。
System i® 服务器的 Unicode 支持
如果任何 SQLJ 或 JDBC 程序将使用 IBM Data Server Driver for JDBC and SQLJ type 4 connectivity连接到 DB2 i 版服务器，那么 System i 操作系统必须支持 Unicode UTF-8 编码方案。下表列示支持 Unicode UTF-8 所需的 System i PTF：
表 1. 用于支持 Unicode UTF-8 的 System i PTF
System i 版本 PTF 号

V5R3 或更高版本无（支持由产品附带提供）
HP-UX 客户机和服务器的 Java 支持
HP-UX 服务器：IBM Data Server Driver for JDBC and SQLJ 不支持使用 HP-UX 缺省字符集 Roman8 的数据库。因此，在 HP-UX 服务器上创建您计划通过 IBM Data Server Driver for JDBC and SQLJ 来访问的数据库时，必须创建使用另一字符集的数据库。

HP-UX 客户机和服务器：HP-UX 系统上的 Java 环境要求进行特殊的设置才能在 IBM Data Server Driver for JDBC and SQLJ 下运行存储过程。

表 1. 用于支持 Unicode UTF-8 的 System i PTF
System i 版本	PTF 号
V5R3 或更高版本	无（支持由产品附带提供）

过程

在 DB2 Database for Linux, UNIX, and Windows 的安装过程中，请选择 Java 支持（对于 UNIX 或 Linux）或 JDBC 支持（对于 Windows）。这些都是缺省选项。如果已安装不带 JDBC 支持的 DB2 Database for Linux, UNIX, and Windows，那么可以运行定制方式的安装过程以添加 JDBC 支持。

选择 Java 支持或 JDBC 支持将使安装过程执行下列操作：

安装 IBM Data Server Driver for JDBC and SQLJ 类文件。
这些文件将被放入 sqllib\java 目录（对于 Windows 系统）或 sqllib/java 目录（对于 UNIX 或 Linux 系统）。

文件名如下所示：
db2jcc.jar 或 db2jcc4.jar

如果您计划使用只包含 JDBC 3.0 或更低版本功能的 IBM Data Server Driver for JDBC and SQLJ 版本，请在 CLASSPATH 中包括 db2jcc.jar。
如果您计划使用包含 JDBC 4.0 或更高版本功能和 JDBC 3.0 或更低版本功能的 IBM Data Server Driver for JDBC and SQLJ 版本，请在 CLASSPATH 中包括 db2jcc4.jar。

sqlj.zip 或 sqlj4.zip

如果您计划准备只包含 JDBC 3.0 或更低版本功能的 SQLJ 应用程序，请在 CLASSPATH 中包括 sqlj.zip。
如果您计划准备包含 JDBC 4.0 或更高版本功能和 JDBC 3.0 或更低版本功能的 SQLJ 应用程序，请在 CLASSPATH 中包括 sqlj4.zip。
修改 CLASSPATH 以使其包括 IBM Data Server Driver for JDBC and SQLJ 类文件。
要点：仅对于 db2jcc.jar 和 sqlj.zip 文件才会自动执行此步骤。如果您正在使用 db2jcc4.jar 文件或 sqlj4.zip 文件，那么必须手动修改 CLASSPATH。将 CLASSPATH 中的 db2jcc.jar 更改为 db2jcc4.jar 或者将 sqlj.zip 更改为 sqlj4.zip。
还需要在打开的每个 DB2 命令行窗口中进行此更改。

要点：请在 CLASSPATH 中包括 db2jcc.jar 或 db2jcc4.jar。请不要同时包括这两个文件。

要点：请在 CLASSPATH 中包括 sqlj.zip 或 sqlj4.zip。请不要同时包括这两个文件。请不要同时包括 db2jcc.jar 和 sqlj4.zip 或者同时包括 db2jcc4.jar 和 sqlj.zip。

如果 IBM Data Server Driver for JDBC and SQLJ客户机许可证文件存在，那么安装进程会安装这些文件以及修改 CLASSPATH 以包括这些文件。

这些文件将被放入 sqllib\java 目录（对于 Windows 系统）或 sqllib/java 目录（对于 UNIX 或 Linux 系统）。文件名如下所示：

表 2. IBM Data Server Driver for JDBC and SQLJ 许可证文件
许可证文件	许可证文件所允许连接到的服务器	包含许可证文件的产品
db2jcc_license_cisuz.jar	DB2 for z/OS® DB2 i 版	所有 DB2 Connect™ 产品

从 IBM Data Server Driver for JDBC and SQLJ V3.50 或更高版本连接到 DB2 Database for Linux, UNIX, and Windows、Cloudscape 或 IBM Informix® 数据库并不需要客户机许可证文件。直接连接到 DB2 for z/OS 并不需要客户机许可证文件（如果已执行 DB2 Connect Unlimited Edition for System z® 服务器许可证激活）。

建议：如果直接连接到 DB2 for z/OS 数据服务器，而不是通过 DB2 Connect 网关进行连接，并且使用 DB2 Connect Unlimited Edition for System z 9.7 FP3 或更高版本，那么应该激活 DB2 Connect Unlimited Edition for System z 的服务器许可证密钥。需要激活您将连接的每个 DB2 for z/OS 子系统或数据共享组上的许可证密钥。请参阅 DB2 Connect 信息，以获取有关服务器许可证激活的详细信息。

安装 IBM Data Server Driver for JDBC and SQLJ 本机库，以便支持 IBM Data Server Driver for JDBC and SQLJ type 2 connectivity。
这些文件将被放入 sqllib\bin 目录（对于 Windows 系统）或 sqllib/lib 目录（对于 UNIX 或 Linux 系统）。

文件名如下所示：
libdb2jcct2.so

用于 AIX®、基于 IPF 的 HP-UX、Linux 以及 Solaris

db2jcct2.dll

用于 Windows

如果任何缺省值不适用，请定制驱动程序范围的配置属性。
配置 TCP/IP。
在下列情况下，必须为 TCP/IP 通信配置服务器：
- JDBC 或 SQLJ 应用程序使用了 IBM Data Server Driver for JDBC and SQLJ type 4 connectivity。
- JDBC 或 SQLJ 应用程序使用了 IBM Data Server Driver for JDBC and SQLJ type 2 connectivity，并在连接 URL 中指定了 server 和 port。
确保 TCP/IP 侦听器处于运行状态。要激活 TCP/IP 侦听器，请执行下列操作：
1. 将环境变量 DB2COMM 设置为 TCP/IP：
```
   db2set DB2COMM=TCPIP
```
2. 使用服务文件中指定的 TCP/IP 服务名称来更新数据库管理器配置文件：
```
   db2 update dbm cfg using SVCENAME TCP/IP-服务名称
```
  用于 applet 和 SQLJ 程序的端口号必须与数据库管理器配置文件中使用的 TCP/IP SVCENAME 号相同。
3. 执行 db2stop 和 db2start 命令，以使服务名称设置生效。
在您计划运行 Java 存储过程或用户定义的函数的 DB2 Database for Linux, UNIX, and Windows服务器上，确保未设置 DB2_USE_DB2JCCT2_JROUTINE 环境变量，或者在那些数据库服务器上将其设置为缺省值 YES、yes、ON、on、TRUE、true 或 1。此设置表明 Java 存储过程在 IBM Data Server Driver for JDBC and SQLJ 下运行。
如果需要在 DB2 JDBC Type 2 Driver for Linux, UNIX and Windows 下运行存储过程，请将 DB2_USE_DB2JCCT2_JROUTINE 环境变量设置为 OFF。
在您计划运行 Java 存储过程或用户定义的函数的 DB2 Database for Linux, UNIX, and Windows服务器上，请更新数据库管理器配置以使其包括 SDK for Java 的路径。
要完成此任务，请在服务器命令行上输入类似于以下的命令：
- 对于 UNIX 或 Linux 上的数据库系统：
```
db2 update dbm cfg using JDK_PATH /home/db2inst/jdk15
```
  /home/db2inst/jdk15 是 SDK for Java 的安装路径。
- 对于 Windows 上的数据库系统：
```
db2 update dbm cfg using JDK_PATH c:\Program Files\jdk15
```
  c:\Program Files\jdk15 是 SDK for Java 的安装路径。
要验证 DB2 数据库管理器配置中 JDK_PATH 字段的值是否正确，请在数据库服务器上输入以下命令：
```
db2 get dbm cfg
```
您可能需要将输出重定向至文件以方便查看。JDK_PATH 字段将显示在输出开头附近。
如果您计划从 Java 程序中调用 DB2 Database for Linux, UNIX, and Windows服务器上的 SQL 过程，并且与数据库服务器的地域代码相关联的日期和时间格式不是 USA 格式，请执行下列操作：
1. 在数据库服务器上设置 DB2_SQLROUTINE_PREPOPTS 注册表变量，以指示缺省日期时间格式是 ISO：
```
   db2set DB2_SQLROUTINE_PREPOPTS="DATETIME ISO"
```
2. 重新定义您计划从 Java 程序中调用的任何现有 SQL 过程。
要确保调用应用程序正确地接收日期和时间值，必须执行这些步骤。
如果计划使用 Java 应用程序来访问 DB2 for z/OS 数据库服务器，请遵循“用于从 Java 程序访问 DB2 for z/OS 服务器的特殊设置”中的指示信息。