使用 DB2 通用 JDBC 驱动程序来访问 DB2 for z/OS

z/OS® 操作系统要求配置 DB2® 通用 JDBC 驱动程序和数据库以确保互操作性。在 WebSphere® Application Server 中,配置 Java™ 数据库连接 (JDBC) 提供程序对象和数据源对象以实现应用程序的驱动程序功能。

开始之前

连接至 z/OS 上的 DB2 的可用 DB2 通用 JDBC 驱动程序版本如下所示:
  • DB2 UDB z/OS 版版本 8 中的 DB2 通用 JDBC 驱动程序。此版本同时支持 2 类和 4 类驱动程序。
  • DB2 UDB OS/390® 和 z/OS 版版本 7 的 DB2 通用 JDBC 驱动程序,如 APAR PQ80841 中所述。此版本支持 2 类和 4 类驱动程序。
  • 带有“z/OS 应用程序与 DB2 for z/OS 的连接”功能(仅提供 4 类连接)的 DB2 通用 JDBC 驱动程序。如果您安装了此版本的驱动程序,那么必须配置 DB2 通用 JDBC 驱动程序提供程序 (XA) 来访问远程 DB2 数据库。
查看 DB2 服务更新以获取所使用版本上的可用增强功能。
迁移提示: 如果要将旧的 DB2 390 版和 z/OS 版 JDBC 提供程序替换为 DB2 通用 JDBC 驱动程序,那么可以迁移现有的 JDBC 提供程序设置。有关更多信息,请参阅“Information Management Software for z/OS 解决方案信息中心”中的“从 OS/390 和 z/OS 的 JDBC/SQLJ 驱动程序迁移至 DB2 通用 JDBC 驱动程序”主题。

过程

  1. 将驱动程序类文件和任何必需的本机文件安装在可用的 HFS 目录中。

    本机文件是使某些版本的 DB2 通用 JDBC 驱动程序在 z/OS 操作系统上运行所必需的类文件。

  2. 配置驱动程序和数据库以进行互操作
    1. 绑定必需的 DB2 包

      对于在 DB2 for z/OS 中执行 SQL 语句的任何应用程序,通用 JDBC 驱动程序必须先将 DB2 与表示要执行的 SQL 语句的包绑定在一起。

      随已安装的 DB2 通用 JDBC 驱动程序一起提供的自述文件描述了绑定实用程序和绑定进程的特定详细信息。请参阅此自述文件,以了解有关如何设置和执行必需的绑定的详细信息。

      该实用程序需要服务器名或 IP 地址、端口号以及目标 DB2 的数据库名称(z/OS 上的数据库位置)。要获取此信息,请在目标 DB2 系统上发出 DB2 -DISPLAY DDF 命令。此命令显示 IPADDR(IP 地址)、SQL DOMAIN(服务器名)、TCPPORT 编号以及要用作该实用程序的输入的 LOCATION(数据库名称/位置)。

      必须为将使用 DB2 通用 JDBC 驱动程序来访问的每个目标 DB2 执行该绑定进程。

    2. 处理未确定事务的设置

      对使用 DB2 通用 JDBC 驱动程序 4 类 XA 支持访问的每个目标 DB2 for z/OS V7 位置执行一次此设置。

      DB2 for z/OS V7 未实现 Java Platform, Enterprise Edition (Java EE) XA 支持,因此,4 类驱动程序 XA 处理在每个位置(数据库)使用 DB2 V7 两阶段落实协议和表来存储未确定或已完成但未落实的全局事务列表。

      在访问的每个 DB2 V7 位置上,都必须设置此表。为执行设置,请使用“未确定”实用程序,它作为已安装的 DB2 通用 JDBC 驱动程序的一部分来提供。此实用程序创建存储有关未确定全局事务的信息的 SYSIBM.INDOUBT 表。此实用程序还绑定包 T4XAIndbtPkg,该包包含要对 SYSIBM.INDOUBT 表进行插入和删除的 SQL 语句。包 T4XAIndbtPkg 是使用 SQLJ 来编写的。

      此安装过程要求目标 DB2 子系统已配置且为传入 TCP/IP 连接启用了 DDF。
      1. 要对目标 DB2 启用 DDF,请在该系统上发出 DB2 -START DDF 命令。
      2. 此实用程序需要服务器名或 IP 地址以及目标 DB2 V7 的端口号。要获取此信息,请在目标 DB2 V7 系统上发出 DB2 -DISPLAY DDF 命令。将显示可用作实用程序输入的 IPADDR(IP 地址)、SQL DOMAIN(服务器名称)和 TCPPORT 编号。

      要查找有关“未确定”实用程序的更详细信息,请参阅 DB2 Universal Database™ for z/OS Version 7 Application Programming Guide and Reference for JavaTM 一书。可从 DB2 Universal Database for z/OS V7 产品信息 Web 页面的“库”部分下载此书。在此书中,请从 DB2T4XAIndoubtUtil 下面搜索有关该实用程序的讨论,它的正式名称为“未确定”实用程序。

      注: 先前描述的未确定事务设置对于 DB2 for z/OS V8 服务器而言并非必需,因为 DB2 for z/OS V8 本机支持基于 DRDA® 的 XA 命令并以内部方式管理未确定全局事务。
    3. 定义 db2.jcc.propertiesFile

      可以在 WebSphere Application Server for z/OS 下创建供 DB2 通用 2 类 JDBC 驱动程序处理使用的 db2.jcc.propertiesFile,并且可以将它指定为驱动程序的输入。此运行时属性文件供在指定 DB2 通用 JDBC 驱动程序用于 2 类连接的各个运行时选项的过程中使用。这些选项以 parameter=value 的格式指定为属性。请参阅随已安装的 DB2 通用 JDBC 驱动程序一起打包的自述文件,以了解每个这样的属性的详细描述。

      此文件不是必需的;但是,如果不提供它,那么会执行通用驱动程序缺省处理。

      特别需要注意的是 db2.jcc.ssid 属性。此属性指定将 DB2 通用 2 类 JDBC 驱动程序要使用的 DB2 子系统标识(而不是位置名)作为它连接的本地子系统名称来处理。如果未提供此属性,那么驱动程序会使用在 DSNHDECP 装入模块中找到的子系统标识。如果安装需要使用 DSNHDECP 装入模块来指定子系统标识,那么此装入模块必须包括在服务方区域 PROC 中的 steplib 数据集中,这些服务方区域 PROC 与将使用由子系统标识进行标识的 DB2 的各个服务器相关联。请参阅随通用驱动程序一起打包的自述文件,以了解有关使用此装入模块的更多信息。如果该 DSNHDECP 装入模块不会准确地反映目标子系统,或如果多个子系统可能使用类属 DSNHDECP,那么必须指定 db2.jcc.ssid 属性。

      虽然 db2.jcc.propertiesFile 不是必需的,但如果选择定义该文件,那么必须指定标准 HFS 文件名称作为 JVM 系统属性,如下所示:
      • db2.jcc.propertiesFile = <fully-qualified-hfs-filename>
      因为驱动程序的通用属性通常特定于驱动程序负载(例如,服务器)而不是使用 JDBC 提供程序的所有服务器,所以最好在服务器级别设置此 JVM 属性。要使用 WebSphere Application Server for z/OS 管理控制台来将 db2.jcc.propertiesFile= 属性定义为服务器级别,请执行以下步骤:
      1. 在 WebSphere Application Server for z/OS 管理控制台中,转至服务器 > 应用程序服务器,然后单击需要添加该 JVM 属性的服务器。
      2. 在所选择的服务器页面上,展开 Java 和进程管理并单击进程定义 > 服务方
      3. 在“服务方”页上,单击其他属性,然后单击 Java 虚拟机
      4. 在“Java 虚拟机”页上,单击其他属性,然后单击定制属性
      5. 在“定制属性”页上,向下滚动并单击新建来为所选择的服务器配置新的 JVM 属性。该属性的名称为 db2.jcc.propertiesFile。该属性的值为使用 DB2 通用 JDBC 驱动程序属性创建并初始化的标准 HFS 文件名。2 类驱动程序对所选服务器使用这些属性
      6. 单击确定
      7. 单击保存以保存新的 JVM 属性。
  3. 定义 DB2 通用 JDBC 驱动程序的 JDBC 提供程序。 JDBC 提供程序对象包含供在 WebSphere Application Server 进行实现的驱动程序类。
    1. 在 WebSphere Application Server for z/OS 管理控制台中,单击资源 > JDBC > JDBC 提供程序
    2. 选择范围,应用程序将可以在该范围中使用该 JDBC 提供程序。此范围将成为与此提供程序相关联的任何数据源的范围。 您可以选择单元、节点、集群或服务器。有关更多信息,请参阅“管理控制台范围设置”主题。
    3. 单击新建 此操作将启动创建新 JDBC 提供程序向导。
    4. 使用第一个下拉列表来选择 DB2 for z/OS 作为数据库类型。
    5. 在第二个下拉列表中选择 DB2 通用 JDBC 驱动程序提供程序作为 JDBC 提供程序类型。
    6. 从第三个下拉列表中选择应用程序所需的实现类型。
      如果应用程序不要求连接支持两阶段落实事务,而且您打算使用 4 类连接,请选择连接池数据源。但是,如果您将连接池数据源与 2 类连接配合使用,那么 z/OS 上的应用程序服务器就会使用 RRS 来同时处理一阶段和两阶段事务。
      限制: 如果安装对 WebSphere Application Server for z/OS 定义了“z/OS 应用程序与 DB2 for z/OS 的连接” 功能,请不要选择连接池数据源。仅 DB2 通用 JDBC 驱动程序的 XA 实现才支持此功能。

      如果您打算使用 4 类驱动程序,而且您的应用程序要求连接支持两阶段落实事务,那么选择 XA 数据源。对 XA 数据源仅使用 4 类驱动程序连接。

      选择实现类型后,向导将填写 JDBC 提供程序的名称和描述字段。您可以对这些字段输入不同的值;他们仅用于管理。

    7. 在定义数据库类型、提供程序类型和实现类型之后,单击下一步 现在,您将看到“输入数据库类路径信息”向导页面。

      通常情况下,不需要更改字段中现有的类路径。(类路径是此页面上显示的 WebSphere 环境变量值,格式为 ${DATABASE_JDBC_DRIVER_PATH}。)此外,您极可能不需要更改本机库路径或数据源实现类名。

    8. 单击下一步以查看 JDBC 提供程序设置摘要。
    9. 如果您对整个 JDBC 提供程序配置感到满意,请单击完成 将显示“JDBC 提供程序集合”页面,该页面在表中显示新 JDBC 提供程序及为同一范围配置的其他提供程序。
  4. 定义数据源。 WebSphere Application Server 使用数据源对象来获取并管理数据库连接。
    1. 在 WebSphere Application Server for z/OS 管理控制台中,访问您的应用程序所需的数据源版本的页面。 如果您需要对两阶段事务的支持,那么仅使用最新的标准版数据源。V4 数据源不支持参与两阶段事务的连接。
      通过下列两种方式的其中一种浏览至相应页面:
      • 单击资源 > JDBC > 数据源数据源 (WebSphere Application Server V4)
      • 单击资源 > JDBC > JDBC 提供程序 > JDBC_provider > 数据源数据源 (WebSphere Application Server V4)
    2. 选择范围,应用程序将可以在该范围中使用该数据源。 您可以选择单元、节点、集群或服务器。有关更多信息,请参阅“管理控制台范围设置”主题。
      仅 V4: 从这里开始,创建“数据源 (WebSphere Application Server V4)”的步骤有别于创建最新的标准版数据源的步骤。要配置 V4 数据源,请完成以下步骤:
      • 单击新建以进入定义必需属性的控制台页面。
      • 在此属性页面上,指定分组到配置标题下面的字段的值。应用程序服务器需要这些属性以实现 JDBC 驱动程序类;请参阅“按供应商排序的数据源最小必需设置”主题以了解可接受的值。
      • 通过单击确定来保存配置。现在,您已完成主要的数据源配置任务。
      • 可选:定义其他受 DB2 通用 JDBC 提供程序支持的属性。应用程序服务器称这些属性为定制属性,同时还要求您对数据源设置这些属性。首先单击管理控制台页面上当前显示的“定制属性”链接。可在适用于您的 DB2 for z/OS 版本的 Application Programming Guide and Reference for Java 中了解可选数据源属性。
    3. 单击新建 此操作将启动创建数据源向导并显示“输入基本数据源信息”页。 第一个字段是范围字段,它是只读的。此字段将显示先前选择的范围。
    4. 在“数据源名”字段中输入数据源名。 此名称标识数据源,仅供进行管理时使用。
    5. 在“JNDI 名称”字段中输入 Java 命名和目录接口 (JNDI) 名称。 WebSphere Application Server 使用该 JNDI 名称来将应用程序资源引用与此数据源绑定。有关 JNDI 的更多信息,请参阅“命名”主题。
    6. 如果您打算使用 DB2 通用 JDBC 驱动程序来实现 4 类驱动程序连接,那么配置组件管理的别名以保护您的数据源。 如果您打算使用 2 类驱动程序连接,那么不必设置别名。在这种情况下,连接管理器使用缺省认证别名,该别名是线程在传递 getConnection 请求时所使用的用户标识。

      组件管理的别名包含在应用程序中指定、用于数据源认证的标识和密码。因此,对数据源设置的别名必须与应用程序代码中的别名完全相同。有关 Java 2 连接器 (J2C) 安全性的更多信息,请参阅“管理 Java 2 连接器体系结构认证数据条目”主题。

      要设置组件管理的别名,请选择现有的别名或创建新别名。

      • 使用下拉列表来选择现有的组件管理的认证别名。
      • 要创建别名,请单击创建新别名链接。此操作将关闭数据源向导并使管理控制台显示 J2C 认证数据集合页面。单击新建以定义新别名。单击确定以保存设置并在 J2C 认证数据集合页面上查看新别名。通过执行以下操作来重新启动数据源向导:回到数据源集合页面,选择相应范围,然后单击新建
    7. 单击下一步以查看“选择 JDBC 提供程序”向导页面。
    8. 选择现有的 JDBC 提供程序,或者创建提供程序。
      要选择现有的 JDBC 提供程序:
      1. 单击选择现有 JDBC 提供程序
      2. 从下拉列表中选择 JDBC 驱动程序。
      3. 单击下一步。 现在,您将看到标题为“输入特定于数据库的数据源属性”页。
      要创建 JDBC 提供程序,请执行以下操作:
      1. 单击创建新的 JDBC 提供程序
      2. 单击下一步以查看“创建 JDBC 提供程序”页。
      3. 使用第一个下拉列表来选择 DB2 for z/OS 作为数据库类型。
      4. 在第二个下拉列表中选择 DB2 通用 JDBC 驱动程序提供程序作为 JDBC 提供程序类型。
      5. 从第三个下拉列表中选择应用程序所需的实现类型。
        如果应用程序不要求连接支持两阶段落实事务,请选择连接池数据源。DB2 通用 JDBC 驱动程序的 2 类驱动程序和 4 类驱动程序连接实现都支持连接池数据源。
        限制: 如果安装对 WebSphere Application Server for z/OS 定义了“z/OS 应用程序与 DB2 for z/OS 的连接”功能,请不要选择此提供程序。仅 DB2 通用 JDBC 驱动程序的 XA 实现才支持此功能。

        如果应用程序要求连接支持两阶段落实事务,那么选择 XA 数据源。使用此数据源配置的应用程序将能够利用容器管理的事务恢复功能。 对 XA 实现仅使用 4 类驱动程序连接。

        选择实现类型后,向导将填写 JDBC 提供程序的名称和描述字段。您可以对这些字段输入不同的值;他们仅用于管理。

      6. 在定义数据库类型、提供程序类型和实现类型之后,单击下一步。现在,您将看到“输入数据库类路径信息”向导页面。

        通常情况下,不需要更改字段中现有的类路径。(类路径是此页面上显示的 WebSphere 环境变量值,格式为 ${DATABASE_JDBC_DRIVER_PATH}。)此外,您极可能不需要更改本机库路径或数据源实现类名。

      7. 单击下一步。 现在,您将看到标题为“输入特定于数据库的数据源属性”页。
    9. 如果容器管理的持久性 (CMP) 企业 Bean 必须访问此数据源,请单击在容器管理的持久性 (CMP) 中使用此数据源
    10. 指定在实现 DB2 通用 JDBC 驱动程序时所必需的所有剩余属性。 这些属性包括:
      • 数据库名称,当使用此数据源建立连接时使用的目标数据库的位置名
      • 驱动程序类型,数据源使用的 JDBC 连接类型
      • 服务器名,Distributed Relational Database Architecture™ (DRDA) 服务器的 TCP/IP 地址或主机名。

        仅当 driverType 设置为 4 时,此属性才是必需的。当 driverType 设置为 2 时,不使用此属性。

      • 端口号,DRDA 服务器驻留的 TCP/IP 端口号。

        仅当 driverType 设置为 4 时,才提供此属性的值。当 driverType 设置为 2 时,不设置此属性。

    11. 单击完成以保存配置并退出向导。 将显示“数据源集合”页面,该页面在表中显示新配置及为同一范围配置的其他数据源。

下一步做什么

可以覆盖某些数据源属性的缺省值。单击表中的新数据源链接以查看必需数据源属性的常规配置页面。还可以定义其他受 DB2 通用 JDBC 驱动程序支持的属性。应用程序服务器要求您在数据源上将这些属性设置为定制属性。在适用于您的 DB2 for z/OS 版本的 Application Programming Guide and Reference for Java 中了解可选数据源属性。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jdbcdb2cfg
文件名:tdat_jdbcdb2cfg.html