IBM 开发者工作台版本 9.1.0.2 － 发行说明

目录

1.0 关于此发行版

开发者工作台版本 9.1.0.2 包含对版本 9.1 发行版的增强和修正内容。

返回到目录。

1.1 此发行版中的新增内容

开发者工作台版本 9.1.0.2 提供下列新功能：

• 支持 DB2 z/OS 版版本 9：
  • 可以在数据库资源管理器中创建与 DB2 z/OS 版版本 9 的 JDBC 连接。
  • 可以使用工作台创建、测试和部署下列类型的例程，这些例程面向数据开发项目中的 DB2 z/OS 版版本 9：
    • SQL 本机存储过程，包括多个版本的本机存储过程
    • SQL 外部存储过程
    • Java（JDBC 和 SQLJ）存储过程
    • 用户定义的 SQL 标量函数
  • 可以使用工作台来开发面向 DB2 z/OS 版版本 9 的 Java 存储过程，这些存储过程取决于 JAR 文件（在其中部署存储过程的 JAR 文件除外）中的类。可以将 JAR 文件导入数据开发项目，以便允许在本地编译和打包这种类型的 Java 存储过程。还可以使用工作台部署或删除数据库服务器中的 JAR 文件，以及通过数据库资源管理器查看已部署 JAR 文件的属性。
  • 可以使用工作台中的集成存储过程调试器来调试面向 DB2 z/OS 版版本 9 的存储过程。
• 已翻译 OLE DB 和 XML UDF 的文档和用户界面文本。请参阅这些发行说明的文档纠错部分，以了解有关在创建 OLE DB 或 XML UDF 之前必须完成的一些必备步骤的信息。
• 支持对包含 SQL 语句和脚本的文件使用 .db2 扩展名。除具有 .sql 和 .ddl 扩展名的文件外，还可以编辑和导入具有 .db2 扩展名的 SQL 文件。
• 支持为 SQLJ 存储过程创建单个程序包。要创建单个程序包，请在“部署例程”向导的绑定选项字段中指定隔离级别。
• 支持保存包含错误的例程。在“例程编辑器”中保存包含错误的例程时，您将看到一条消息，它表明源代码中存在错误，但可以保存此带有错误的源代码，这样您就不会丢失所作的工作。

返回到目录。

1.2 产品修订历史

已修正版本 9.1 或 9.1.0.1 中的下列已知问题：

• 删除项目之前，请关闭属于该项目的已打开例程和 SQL 编辑器。如果未关闭打开的例程和 SQL 编辑器，虽仍会删除项目及其内容，但您将看到错误消息。
• 如果要调试调用另一 Java 存储过程的 Java 存储过程，则不能调试那个被调用的存储过程。不能单步跳入嵌套存储过程，而且您在该嵌套存储过程中设置的任何断点都将被忽略。DB2 UDB Linux 版、UNIX 版和 Windows 版都会受到这样的限制。

1.3 已知局限性和问题

此发行版包含下列已知局限性和问题。

• 一般信息
• 例程开发
• 存储过程调试器

一般信息

• 要启动 Red Hat Enterprise Linux 3 上的开发者工作台，请将 export MOZILLA_FIVE_HOME=<location of mozilla> 添加至 /opt/IBM/DWB/V9.1/dwb_prod/shortcut_dwb。
• 如果定义一个包含 XML 数据但不包括主键的表，则在表编辑器中更新 XML 列将失败。必须向包含 XML 数据的表添加主键或唯一索引。
• 只有与 DB2 Linux 版、UNIX 版和 Windows 版版本 9 连接关联的数据开发项目中才支持 XQuery 构建器中的 XQuery 开发。
• 在数据库资源管理器中创建联合服务器后，新创建的服务器不会自动显示在“定义的服务器”文件夹中。必须刷新该文件夹才能看到新服务器。
• 在 Linux 上，如果您的系统使用 JDK 1.4.1 作为它的缺省 JDK，则在退出 DWB 时，开发者工作台进程可能不会关闭。为了避免此问题，请使用 DWB 提供的 JDK：/opt/IBM/DWB/V9.1/dwb_prod/eclipse/jdk/bin。

例程开发

• 不支持将用户定义的类型（UDT）作为例程的参数。
• Visual Explain 不可用于面向 DB2 z/OS 版数据库的用户定义的函数。工作台仅支持用于 z/OS 用户定义的函数的表达式，而不是语句。
• 第一次在数据开发项目中创建例程时，“新建存储过程”向导、“新建用户定义的函数”向导或例程编辑器中的 Visual Explain 选项可能不可用。要解决此问题，请关闭工作空间，然后将其重新打开，此时 Visual Explain 选项将已启用。
• 使用 Ant 部署功能来部署存储过程或用户定义的函数时，如果类路径中没有 tools.jar 文件，则可能会出现以下消息：找不到 tools.jar。期望在 F:\jre\1.4.2\lib\tools.jar 中找到该文件。请忽略此消息。tools.jar 是 Java 运行时环境（JRE）的一部分，不是 Ant 部署功能的一部分。
• 要通过使用 Ant 部署功能部署文件系统中面向 DB2 UDB iSeries 版的 Java 存储过程，必须确保系统类路径中存在 jt400.jar。
• 创建 Java 存储过程和更改方法名时，在编辑器中右键单击然后单击保存不起作用。要保存已更新的存储过程，请单击文件 > 保存。
• 如果尝试通过使用 DeployInstructions.txt 中的指示信息来部署已导出的存储过程，则可能会遇到提示以下信息的错误消息：...[createsp] 无法连接至目标数据库。[createsp] com.ibm.db2.jcc.DB2Driver...。要解决此问题，请确保系统类路径中存在 db2jcc.jar 和相应的许可证文件。
• 删除数据开发项目之前，请关闭属于该项目的已打开例程和 SQL 编辑器。如果未关闭打开的例程和 SQL 编辑器，虽仍会删除项目及其内容，但您将看到错误消息。
• 部署或运行 Java 存储过程时，可能会看到不能装入类的错误。如果 RAD V7 的 JDK 版本与 DB2 服务器的 JDK 版本不一致，且 DB2 服务器的 JDK 版本较低，则会发生此错误。为了防止此错误，当您针对使用 JDK 1.4 级别的服务器部署 Java 存储过程时，应该在“部署例程”向导的编译选项字段中指定“-source 1.4”选项。例如，DB2 通用数据库 Linux 版、UNIX 版和 Windows 版版本 8.2 服务器。一般说来，使用适当的编译选项“-source JDK level”来匹配数据库服务器上的 JDK 级别。
• 如果在不相似的服务器之间拖放存储过程或 UDF（例如，从 DB2 UDB Linux 版、UNIX 版和 Windows 版服务器拖放到 DB2 UDB z/OS 版服务器），则在执行拖放操作期间将看到警告，该警告提示两个服务器不能完全兼容。如果继续操作，然后尝试打开存储过程或 UDF，则您可能会看到错误。
• 如果服务器缺少 JCC 驱动程序用来检索错误消息文本所需的必备存储过程 SYSIBM.SQLCAMESSAGECCSID，则对 DB2 UDB Linux 版、UNIX 版和 Windows 版版本 8.2 服务器运行 SQL 概要分析时，可能会导致 NULL 指针异常。要解决此问题，可以在未将 retrieveMessagesFromServerOnGetMessage 设置为 true 的情况下创建与该服务器的连接。
• 在对 SQL 过程的执行进行监视期间，将为在过程中发出的 DML 语句（例如，INSERT、SELECT、DELETE 和 UPDATE）生成概要分析事件。但是，不会以确定方式为用于变量赋值的过程语句和控制结构（例如，WHILE 或 IF）生成事件。因此，将不会为这些过程语句捕获调整数据。

存储过程调试器

• 连接至 UNIX DB2 服务器之后，如果添加断点或通过调试方式运行，则会发生超时异常。
• 对于名称中同时包含英文和中文字符的存储过程，调试器不会运行。
• 仅动态 Java 存储过程支持监视表达式。SQL 和 SQLJ 存储过程不支持动态监视表达式。
• 如果断点未放置在可执行语句（例如，SET）的第一个标记处，则调试器在该断点不会停止。此外，调试器在遇到 DECLARE CONTINUE、CLOSE CURSOR 或 ROLLBACK 时也不会停止。
• 如果要调试 Java 存储过程，而且选择了“终止”操作，则调试会话可能需要几分钟才能完全终止。在此期间启动的新调试会话可能不稳定。
• 调试从另一个 SQL 或 Java 存储过程调用的 Java 存储过程时，单步返回按钮将被禁用。要解决此问题，可以在调用存储过程的下一行中添加一个断点，然后单击继续以返回到调用存储过程。
• 如果在 Java 存储过程调用另一个存储过程时您单步返回到该 Java 存储过程中，则您可能在中间某个 Java 代码处停止。要解决此问题，请使用单步返回 按钮返回到 Java 存储过程堆栈帧。
• 调试 Java 存储过程时，如果遇到等待数据包时发生了超时错误，则尝试增大 Java 超时设置的值。要增大 Java 超时设置的值，请从工作台菜单栏中单击窗口 > 首选项。展开 Java 节点并单击调试。在“调试首选项”页上的通信超时部分中，增大调试器超时（ms）的值。建议至少将超时值设置为缺省值的两倍。
• 调试 Java 存储过程时，如果使用更改值操作来修改值为空字符串的变量，则编辑对话框中的确定按钮可能不会变为启用。要启用该按钮，请选择输入求值单选按钮，将值设置为非空字符串（例如，“a”），然后选择输入文字文本单选按钮。确定按钮随后将变为可用。
• 如果在调试 Java 存储过程期间时，未看到局部变量，则该存储过程在部署时可能未指定 -g 编译器选项。请确保在部署 Java 存储过程时指定 -g 编译器选项。
• 如果在“变量”视图中看到“堆栈帧无效”消息，则转至“调试”视图并单击该堆栈帧之上的线程对象，然后单击堆栈帧。这样就会刷新“变量”视图，而且此错误不会再出现。
• 调试一个在 DB2 UDB iSeries 版 V5R4 上运行的 SQLJ 存储过程时，如果尚未应用 iSeries PTF 以将行图更新为与 SQLJ 源代码（而不是 Java 源代码）相对应，则当前正被执行的行将不会与“调试”视图中显示的指示 SQLJ 源代码行相对应。
• 不能识别会话管理器超时的“调试器”首选项。请按照以下方法设置这些首选项：单击窗口 > 首选项，展开运行／调试节点，然后单击 DB2 存储过程调试器，并修改会话管理器超时（m）字段。
• 在 DB2 Linux 版、UNIX 版和 Windows 版上，调试器不能处理具有大量变量的存储过程。最大的变量数目为 200。
• 在调试会话中移动光标：在某些情况下，如果过程中有多个变量声明，则必须多次单击单步跳入或单步跳过才能移至下一行。例如，必须单击以下行两次：DECLARE v_dept, v_actdept CHAR(3); 单击以下行三次：DECLARE v_bonus, v_deptbonus, v_newbonus DECIMAL(9,2); 即单击次数必须与变量声明的数目相等。
• 如果对 Java 存储过程启动调试会话，然后添加并禁用断点，这些断点仍处于启用状态。要解决此问题，在启动新调试会话时，应该先除去所有旧断点，然后添加新断点。
• 在某些情况下，如果您处理多个数据开发项目，则在尝试调试一个存储过程时，可能会看到错误，该错误指示“无法找到存储过程 PROCNAME。过程可能已从工作空间中删除”或“找不到源代码”。
• 如果在终止 Java 存储过程的调试会话之后就直接调试 SQL 存储过程，则该调试器可能会显示“用户定义的函数...已被用户中断。”要解决此问题，请再次尝试调试该 SQL 存储过程。

1.4 文档纠错

在标题为“将 Visual Explain 用于例程”的主题中，关于支持 Visual Explain 的服务器的声明是不正确的。下列操作系统和服务器上支持 Visual Explain：

Visual Explain 可在 Windows(R) 平台上使用。支持下列服务器：

• DB2 UDB Linux 版、UNIX 版和 Windows 版，版本 8.2
• DB2 Linux 版、UNIX 版和 Windows 版，版本 9
• DB2 UDB z/OS 版，版本 7 和版本 8

使用开发者工作台创建 OLE DB UDF 之前，必须满足下列先决条件：

• DB2 UDB Linux 版、UNIX 版和 Windows 版，版本 8 或更新版本。
• OLE DB 2.0 或更新版本，可从 Microsoft 获得，网址为 http://www.microsoft.com。如果尝试在未先安装 OLE DB 的情况下调用 OLE DB 表函数，则 DB2^(R) 将发出 SQLCODE -465、SQLSTATE 58032 和原因码 35。有关系统要求和可用于数据源的 OLE DB 提供程序，请参阅您的数据源文档。有关 OLE DB 规范，请参阅 Microsoft 出版社于 1998 年出版的 Microsoft OLE DB 2.0 Programmer's Reference and Data Access SDK。
• 您的计算机上必须注册了 db2olefn.dll。要注册此 DLL 文件，在命令行中输入 regsvr32 DB2installdir\sqllib\function\db2olefn.dll，其中 DB2installdir 是安装了 DB2 的根目录。

使用开发者工作台创建 XML UDF 之前，必须满足下列先决条件：

• DB2 UDB Linux 版、UNIX 版和 Windows 版，版本 8 或更新版本。
• 如果要在处理之前对 XML 文档执行 XSL 变换，则必须对 DB2 XML Extender 启用目标数据库。启用 DB2 XML Extender 时，可以使用目标数据库上由数据库引擎提供的 XSLTransform UDF 来执行 XSL 变换。对于本地数据库，将会自动启用 DB2 XML Extender。要对 XML Extender 启用远程数据库，在命令行上的 DB2installdir\sqllib\bin 目录中输入 dxxadm enable_db sample，其中 sample 是目标数据库，而 DB2installdir 是安装了 DB2 的目录。

在数据库资源管理器中使用脱机连接时，不能执行下列操作。标题为“数据库资源管理器中脱机连接的局限性”的主题中缺少此信息：

• 指定运行例程前后要运行的 SQL 语句，以及通过运行设置菜单操作设置输入或输入参数。
• 针对当前服务器调试存储过程。

返回到目录。

2.0 安装信息

• 2.1 硬件和软件要求

• 2.2 安装概述

• 2.3 安装先决条件

• 2.4 安装修订包

• 2.5 下载修订包以进行本地安装

• 2.6 客户支持
  

2.1 硬件和软件要求

硬件要求

磁盘空间：50 MB

内存：512 MB（建议使用 1 GB 内存）

软件要求

• Microsoft Windows 2000 Server、Microsoft Windows 2000 Professional、Microsoft Windows 2003 Server 和 Microsoft XP Professional
• Red Hat Enterprise Linux 3 和 SUSE Linux Enterprise Server 9

返回到目录。

2.5 下载修订包以进行本地安装

您应该直接从 IBM 更新服务器安装修订包；但是，也可以下载修订包。在下列情况下，您可能想要下载并安装修订包：

• 因特网连接速度较慢或者不稳定，并且您想要使用可以继续下载的下载管理器。
• 不容易穿过防火墙访问实时 IBM 更新服务器。
• 您选择下载修订包，并在以后进行安装。

要下载并安装修订包，请完成下列步骤：

1. 从 ftp://ftp.software.ibm.com/software/data/db2/udb/developerworkbench/91/zips/dwb_9102.zip 下载修订包。
2. 将修订包解压缩到一个临时目录，例如，C:\temp。
3. 有关安装指示信息，请浏览至 C:\temp\dwbfp2\ 并打开 install_local_9102.html。

2.6 客户支持

有关产品新闻、事件、支持和其他信息，请参阅 DB2 主页，网址为：http://www-306.ibm.com/software/data/db2/9/。

3.0 声明与商标

3.1 声明

本信息是为在美国提供的产品和服务编写的。IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594 U.S.A。

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：

INTERNATIONAL BUSINESS MACHINES CORPORATION“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。

本资料中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。

本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：

只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

所有关于 IBM 未来方向或意向的声明都可随时更改或收回，而不另行通知，它们仅仅表示了目标和意愿而已。

本信息包含在日常业务操作中使用的数据和报告的示例。为了尽可能完整地说明这些示例，这些示例中包括个人、公司、品牌和产品的名称。所有这些名称都是虚构的，与实际商业企业所用的名称和地址的任何雷同纯属巧合。

3.2 商标

IBM、Derby、Rational、DB2 Universal Database 和 zSeries 是 IBM Corporation 在美国和／或其他国家或地区的商标或注册商标。

Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和／或其他国家或地区的商标。

Linus Torvalds 在美国和／或其他国家或地区对 Linux 保留版权。

Microsoft、Windows 2000、Windows 2003 和 Windows XP 是 Microsoft Corporation 在美国和／或其他国家或地区的商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。

返回到目录。