IBM WebSphere Development Studio Client for iSeries V5.1.2 迁移指南


目录

关于本信息
在开始之前
从 V5.0 或 5.1 移至 V5.1.2
必备软件迁移步骤
向导生成过程需要 JDK 1.4 的 Java 包
迁移程序调用 bean
将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.1 迁移到 V5.1.2
对于 Java 项目中的程序调用 bean:
对于 Web 项目中的程序调用 bean:
将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.0 迁移到 V5.1.2
对于 Java 项目中的程序调用 bean:
对于 Web 项目中的程序调用 bean:
将 iSeries Java和 Web 项目中的程序调用 bean 从 V4.0 迁移到 V5.1.2
对于 Java 项目中的程序调用 bean:
对于 Web 项目中的程序调用 bean:
迁移“远程系统资源管理器”设置
从 V4.0 迁移到 V5.1.2
迁移 WebFacing 项目
使用“WebFacing 导入”向导
手工步骤(如果项目中具有定制的文件)
迁移 iSeries Web 项目
将 V5.0.x 和 5.1 iSeries Web 项目迁移到 V5.1.2
阶段 1:使用现有 5.0.x 或 5.1 工作空间迁移项目
阶段 2:迁移 iSeries Web 项目内容
阶段 3:解决因迁移而生成的错误和警告
从 V4.0 iSeries Web 项目迁移到 V5.1.2
阶段 1:使用现有 V4.0.x 工作空间迁移项目
迁移至 J2EE 1.3
阶段 3:迁移 iSeries Web 工具项目内容
阶段 4:解决因迁移而生成的错误和警告
Web 项目迁移的警告和错误消息
迁移 iSeries 项目
将 iSeries 项目从 V5.0 迁移到 V5.1.2:
将 iSeries 项目从 V4.0 迁移到 V5.1.2:
如果已安装 Development Studio Client for iSeries V4.0:
如果已安装 Development Studio Client for iSeries V5.1.2,并且知道尚未将项目上载到远程主机
声明
版权许可:
编程接口信息
商标和服务标记

关于本信息

本信息描述如何从 IBM WebSphere Development Studio Client for iSeries V4.0、5.0 或 5.1 迁移项目。

通常,迁移是无缝且透明的。所需执行的操作是使用现有工作空间,继续将项目与新产品版本配合使用。

对于与 Java 工具、Web 工具和 WebFacing 项目定制相关的某些特殊情况,可能需要使用迁移工具或执行额外的手工步骤。

在开始之前

要点:如果当前安装了 Development Studio Client for iSeries V4.0、V5.0 或 5.1,并且要安装 WebSphere Development Studio Client V5.1.2,则安装过程卸载产品的先前版本。卸载 Development Studio Client for iSeries V4.0、5.0 或 5.1 之前,我们建议您注意 V4.0、5.0 或 5.1 工作空间的位置,并且备份此工作空间。如果未备份工作空间,则可能会丢失 V4.0、5.0 或 5.1 项目。(缺省情况下,不会卸载或删除这些项目。)

要查找 V5.0 或 5.1 工作空间的位置:

要查找 V4.0 工作空间的位置:

从 V5.0 或 5.1 移至 V5.1.2

快速安装后的步骤:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 或 5.1 工作空间的目录位置。
  2. 当提示确认是否要转换为新的工作空间格式时,单击“确定”

此指南包含安装 V5.1.2 之前应该阅读的其它信息。但是,如果已安装 V5.1.2,则可以查找到本指南,例如,在 X:\WDSC\install\help\migrate.htm 中。

如果需要有关迁移到 V5.1.2 如何影响工作空间或项目的特定信息,则可以阅读基本 WebSphere Studio 产品附带的迁移指南中适用的章节。该指南的位置取决于您系统上拥有的 Development Studio Client 的版本。

在安装之后也提供本指南,例如,位于下列位置,

必备软件迁移步骤

向导生成过程需要 JDK 1.4 的 Java 包

因为 JDK 1.4 中发生更改,所以使用“数据库 Web 页面”和“Java Bean Web 页面”向导生成在 V5.1.x 上运行的页面时必须指定 Java(TM) 包。如果“视图 Bean”模板用于“Java Bean Web 页面”向导或“IBM(R) 数据库访问 Java Bean - 主要详细信息模式”,则会发生此问题。这也适用于包含先前使用这些向导生成的页面和 .java 文件的项目,创建期间这些向导未指定软件包。对于先前创建的代码,将 .java 文件移至软件包。然后更新 .jsp 文件,更新 import 语句和类信息。在项目的 web.xml 文件中,更新 servlet-class 条目。

迁移程序调用 bean

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.1 迁移到 V5.1.2

本节描述如何将 Development Studio Client for iSeries V5.0 中创建的程序调用 bean 迁移到 V5.1.2。

对于 Java 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击“确定”
  3. 通过更改项目的 Java 构建路径除去旧的类路径。
    1. 右键单击该 Java 项目并选择“属性”
    2. 在左窗格中选择“Java 构建路径”
    3. 选择“库”选项卡,然后选择下列 JAR 文件并单击“除去”以将其从类路径中除去:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
      j2ee.jar
    4. 对所有 PCML 文件重新运行“程序调用”向导。

对于 Web 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击“确定”
  3. 使用“J2EE 迁移”向导:
    • 将项目结构转换为 V5.1.2
    • (可选)从 J2EE 级别 1.2 迁移至级别 1.3。
  4. 右键单击 Web 透视图中的项目名称,然后选择“迁移”>“iSeries Web 工具项目”
  5. “确认迁移”窗口指示将要迁移项目结构和内容。要继续此过程,单击“确定”
  6. 迁移将用 V5.1.2 jar 文件替换 WEB-INF\lib 文件夹中的 iwdtrt.jar 和 jt400.jar。
  7. 对所有 PCML 文件重新运行“程序调用”向导。
  8. 对所有的“Web 服务”bean 重新运行“Web 服务”向导。
  9. 此迁移仅适用于 Web 服务 bean 本身。“Web 服务”向导生成的代码需要手工迁移和清除。

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.0 迁移到 V5.1.2

本节描述如何将 Development Studio Client for iSeries V5.0 中创建的程序调用 bean 迁移到 V5.1.2。

对于 Java 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击“确定”
  3. 通过更改项目的 Java 构建路径除去旧的类路径。
    1. 右键单击该 Java 项目并选择“属性”
    2. 在左窗格中选择“Java 构建路径”
    3. 选择“库”选项卡,然后选择下列 JAR 文件并单击“除去”以将其从类路径中除去:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
      j2ee.jar
    4. 对所有 PCML 文件重新运行“程序调用”向导。

对于 Web 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击“确定”
  3. 使用“J2EE 迁移”向导:
    • 将项目结构转换为 V5.1.2
    • (可选)从 J2EE 级别 1.2 迁移至级别 1.3。
  4. 右键单击 Web 透视图中的项目名称,然后选择“迁移”>“iSeries Web 工具项目”
  5. “确认迁移”窗口指示将要迁移项目结构和内容。要继续此过程,单击“确定”
  6. 迁移将用 V5.1.2 jar 文件替换 WEB-INF\lib 文件夹中的 iwdtrt.jar 和 jt400.jar。
  7. 对所有 PCML 文件重新运行“程序调用”向导。
  8. 对所有的“Web 服务”bean 重新运行“Web 服务”向导。

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V4.0 迁移到 V5.1.2

本节描述如何将 Development Studio Client for iSeries V4.0 中创建的程序调用 bean 迁移到 V5.1.2。

对于 Java 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V4.0 工作空间的目录位置。
  2. 当提示确认是否要转换为新的用户界面格式时,单击“确定”
  3. 通过更改项目的 Java 构建路径除去旧的类路径。
    1. 右键单击该 Java 项目并选择“属性”
    2. 在左窗格中选择“Java 构建路径”
    3. 选择“库”选项卡,然后选择下列 JAR 文件并单击“除去”以将其从类路径中除去:

         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. 对所有 PCML 文件重新运行“程序调用”向导。
  5. 此迁移仅适用于程序调用 bean 本身。“程序调用”向导生成的代码需要手工迁移和清除。

对于 Web 项目中的程序调用 bean:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V4.0 工作空间的目录位置。
  2. 当提示确认是否要转换为新的工作空间格式时,单击“确定”
  3. 使用“J2EE 迁移”向导:
    • 将项目结构转换为 V5.1.2
    • (可选)从 J2EE 级别 1.2 迁移至级别 1.3。
  4. 右键单击 Web 透视图中的项目名称,然后选择“迁移”>“iSeries Web 工具项目”
  5. 要点:此时关闭该项目并重新打开它以避免发生与资源删除相关的异常。
  6. “确认迁移”窗口指示将要迁移项目结构和内容。要继续此过程,单击“确定”
  7. 迁移将从 WEB-INF\lib 文件夹除去 wdt400rt.jar 和 wdt400tb.jar,并将 V5.1.2 iwdtrt.jar 和 jt400.jar 复制到此文件夹中。
  8. 对所有 PCML 文件重新运行“程序调用”向导。
  9. 对所有“Web 服务”bean 重新运行“Web 服务”向导。
  10. 在 V5.0 中,可在缺省软件包中生成 Web 服务 bean。从 V5.1 开始,必须在指定的软件包中生成 bean,然后才能调用“Web 服务”向导。
  11. 此迁移仅适用于 Web 服务 bean 本身。“Web 服务”向导生成的代码需要手工迁移和清除。

迁移“远程系统资源管理器”设置

从 V4.0 迁移到 V5.1.2

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V4.0 工作空间的目录位置。
  2. 当提示确认是否要转换为新的工作空间格式时,单击“确定”
  3. 在主菜单中,单击“窗口”>“首选项”
  4. 在左窗格中,展开“LPEX 编辑器”并选择“解析器”
  5. 在右窗格中选择 ILErpg。在底部的“类名”字段中,将类名更改为 com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser。单击“设置”
  6. 在右窗格中选择 rpg。在底部的“类名”字段中,将类名更改为 com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser。单击“设置”
  7. 单击“应用”。单击“确定”

迁移 WebFacing 项目

如果具有来自 V4.0、5.0.x 或 5.1.x 的现有项目,则可以在启动 5.1.2 工作台时指定更早的工作空间,并且可以按现状运行项目。但是,项目的显示可能不完整。例如,前发行版的记录 JSP 文件和某些样式文件未出现在 5.1.2 树形视图中。

首次转换 DDS 文件时,更新项目结构以反映新的 5.1.2 布局。例如,导入新的运行时 jar 文件和模板文件。如果明确选择“导入”向导,此情况将以相同方式出现。

使用“WebFacing 导入”向导

如果具有来自 WebSphere Development Studio Client V4.0、5.0 或 5.1 的 WebFacing 项目,则可以使用“导入”向导将这些项目迁移到 Development Studio Client V5.1.2。遵循下列步骤:

安装之后:
  1. 选择“文件”>“导入”
  2. 选择“WebFacing 项目”。单击“下一步”
  3. “浏览”至包含要迁移到 V5.1.2 的 WebFacing 项目的文件夹。单击“下一步”
    注意:
    当升级到 V5.1.2 时,WebFacing 项目在原始工作空间目录中仍可用。
    • 如果打算从 Development Studio Client 5.0 或 5.1 迁移,请参阅在开始之前下面有关查找工作空间的章节。
  4. 向导找到的任何 WebFacing 项目将列示在“找到的 WebFacing 项目”窗格中。选择想要导入的项目。向导将为项目创建 EAR 文件。EAR 文件是一个 J2EE 企业应用程序归档文件。缺省情况下,EAR 文件使用 WebFacing 项目的名称,并将 _EAR添加到此名称。如果要使用其它名称或将若干项目合并到单个 EAR 文件中,可以在“企业应用程序项目”字段中更改此名称。
  5. 单击“完成”以将项目迁移到 V5.1.2 工作空间。
  6. 要在 WebFacing 透视图中查看此项目,选择“窗口”>“打开透视图”> WebFacing

手工步骤(如果项目中具有定制的文件)

原始文件具有下列格式的新名称:filename +_512_bak

如果定制 WebFacing 项目,可能需要将原始文件中的定制合并到下列文件中:

迁移 iSeries Web 项目

可以使用下列方法来迁移 iSeries Web 项目:

将 V5.0.x 和 5.1 iSeries Web 项目迁移到 V5.1.2

下列信息描述如何将 Development Studio Client for iSeries V5.0.x 和 5.1 中的 iSeries Web 项目迁移到 Development Studio Client for iSeries V5.1.2。

迁移活动涉及下列阶段:

  1. 使用现有 5.0.x 或 5.1 工作空间迁移项目
  2. 迁移 iSeries Web 项目内容
  3. 解决因迁移而生成的错误和警告

阶段 1:使用现有 5.0.x 或 5.1 工作空间迁移项目

在 V5.1.2 中,新 Web 项目的缺省 Web Content 和 Java source 文件夹名可通过首选项页进行配置。现在的缺省名称是 JavaResources 和 WebContent。这些缺省名将只用于新 Web 项目。V5.1.2 之前的版本中创建的 Web 项目将继续使用旧名称来工作。对于静态 Web 项目也是一样。

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0.x 或 5.1 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击“确定”
  3. 可选:在主菜单中,单击“窗口”>“首选项”。在左窗格中,展开“Web 工具”并选择“新建项目”。在右窗格中设置首选项中的缺省文件夹名。

可以在 V5.1.2 中手工更改 5.0.x 或 5.1 项目的源文件夹名,方法是在“导航器”视图中右键单击文件夹名,然后单击“重命名”。“重命名”操作重命名文件夹名,并确定 5.0.x 或 5.1 Web 项目的 Java 构建路径。如果选择在 V5.1.2 中重命名 JavaResources 和 WebContent 文件夹名,则必须使用新文件夹名手工更新您所拥有的全部自动构建脚本。

阶段 2:迁移 iSeries Web 项目内容

要迁移“iSeries Web 工具”项目内容:

  1. 在 Web 透视图的“项目导航器”视图中右键单击项目名称,然后选择“属性”。在左窗格中选择“Web 项目功能部件”。从“可用 Web 项目功能部件”列表中,选择“添加 Struts 支持”(如果尚未选择)。单击“确定”。 在“Web 项目功能部件”窗口中单击“完成”以接受缺省 Struts 版本(1.1)。
    注意:
    如果遗漏此步骤,即会显示一个窗口,请求您添加 Struts 支持。
  2. 要点:此时关闭并重新打开项目以避免因删除资源而导致异常。
  3. 右键单击 Web 透视图中的项目名称,然后选择“迁移”>“iSeries Web 工具项目”。“确认迁移”窗口指示将要迁移项目结构和内容。
  4. 要继续此过程,单击“确定”。进度信息窗口显示迁移的进度。
  5. 当迁移完成时,将有消息指示结果。
  6. 如果迁移过程成功完成,则无需进行进一步的操作。如果迁移过程完成,但出现错误或警告,则继续阶段 3:解决因迁移而生成的错误和警告
  7. 迁移过程执行下列操作:

阶段 3:解决因迁移而生成的错误和警告

如果迁移过程遇到问题,则一个窗口将打开,它会指示发生了错误或警告,且这些错误或警告位于 Web 透视图中项目名称下的迁移日志文件 projectName_MigrationDetails.txt 中。

迁移日志文件顶部的『迁移结果』一节指示了迁移的整体状态并引用联机信息中的一个文件,该文件对错误和警告以及更正错误和警告所需的操作进行了描述。请参阅 Web 项目迁移的警告和错误消息

仅对 5.0.x 迁移而言,除日志文件中列示的任何迁移警告之外,还应清楚“文本条目 Web 组件”的“最大长度”(maxLength)属性不再受到支持。这可能会影响 Web 页面的外观。

从 V4.0 iSeries Web 项目迁移到 V5.1.2

下列信息描述如何将 Development Studio Client for iSeries V4.0 中的 iSeries Web 项目迁移到 Development Studio Client for iSeries V5.1.2。

迁移活动涉及下列阶段:

  1. 使用现有的 V4.0.x 工作空间来迁移项目
  2. 迁移 Web 项目结构和(可选)项目的 J2EE 版本
    注意:
    将 Web 项目迁移到 J2EE 1.3 是可选的。然而,J2EE 1.2 不支持 JCA(Java 连接器体系结构)。
  3. 迁移“iSeries Web 工具”项目内容
  4. 解决因迁移而生成的错误和警告

阶段 1:使用现有 V4.0.x 工作空间迁移项目

此方法仅部分受到支持,它会导致迁移不完整。用户界面设置、调试设置以及大部分的首选项都将丢失。保留项目名称、项目源文件和项目 Java 构建路径(类路径),但不能保证其它事项。仅当未使用支持的软件配置管理(SCM)系统并且此方法对于保留项目构建路径信息至关重要时才使用方法,将从 V4.0 导出的项目导入 V5.1.2 时,此项目构建路径信息将丢失。可以通过执行下列操作来使用现有 V4.0.x 工作空间:

安装之前:
  1. 将任何暂挂的更改提交(发布)至资源库。
  2. 关闭所有透视图并关闭 V4.0 产品。
  3. 备份 workspace_directory 的内容,其中 workspace_directory 是包含 V4.0.x 工作空间的全限定目录名称。在缺省情况下,V4.0.x 工作空间子目录位于安装产品同一目录中。如果您在任何时候想要再次使用 V4.0.x 的产品,则将需要此备份。从 V5.1.2 IDE 指向 V4.0.x 工作空间之后,不能再次使用 V4.0.x 产品中的工作空间。
  4. 安装 Development Studio Client for iSeries V5.1.2。
安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V4.0.x 工作空间的目录位置。
  2. 当提示确认是否要更新通过产品先前版本创建的工作空间时,单击“确定”
  3. 进行任何重建或验证工作空间中的任何项目之前,在“资源”透视图的“导航器”视图中选择全部项目,然后从弹出菜单中选择“刷新”。这可确保所有文件与它们相应的元数据同步。
  4. 打开任何已关闭的项目(请参阅已知问题和局限性)。
  5. 验证类路径变量(请参阅已知问题和局限性)。
  6. 已在此版本中添加、除去或修改了一些构建器和验证器。为确保正确显示错误和警告,必须重建全部项目,方法是选择“项目”>“全部重建”,然后为每个 Java 项目选择“运行验证”
  7. 可能会保留某些用户首选项,但其它许多用户首选项不会保留。检查 V5.1.2 中的首选项设置以确保其符合您的要求。

迁移后除去 EAR 和“服务器配置”绝对路径引用

V4.0 EAR application.xml 文件和服务器配置文件包含了绝对路径引用。将这些文件迁移到 V5.1.2 之后,需要使用编辑器打开它们(此操作自动将其旧的绝对路径引用更改为新的相对路径引用)。

  1. 对于每个 EAR 项目,更新 application.xml 文件。
    1. 在“导航器”视图中,右键单击 META-INF/application.xml 并选择“打开方式”>“部署描述符编辑器”
    2. 单击“是”以显示消息
      IBM 扩展文件包含不必要的绝对路径。这是可以自动纠正的... 是否要自动纠正?
    3. 保存并关闭编辑器窗口。
  2. 对于每个服务器配置,更新配置文件。
    1. 在“服务器”透视图的“服务器配置”视图中,右键单击服务器名称,然后选择“打开”
    2. 将打开一个类似的自动纠正窗口。
    3. 单击“是”
    4. 保存并关闭编辑器窗口。

已知问题和局限性

如果通过在 V5.1.2 产品中打开 V4.0 工作空间来尝试迁移,可能会出现下列问题。

JRE_LIB 类路径变量中存在不正确的值

要将 JRE_LIB 类路径变量重新设置为有效的位置,请遵循这些步骤。第一次打开“首选项”窗口时,即使值看起来正确也要执行此操作

  1. 选择“窗口”>“首选项”> Java >“已安装的 JRE”
  2. 在此列表中,为缺省的 JRE 位置(已将 JRE_LIB 设置到此位置)选择复选框。
  3. 选择“编辑”,然后单击“确定”以关闭“编辑 JRE”对话框。

如果不这样做的话,JRE_LIB 的值就可能是不正确的,从而导致 Java 文件中有许多构建错误。

作为一项常规检查,请验证所有其它类路径变量的值。

对于先前 SCM 共享项目,小组菜单包含共享项目

在 Eclipse 1.0 与 2.0 之间已对小组支持作了显著的更改。同时更改了通过资源库共享项目的方法。

工作空间目录外部创建的项目

缺省情况下,项目是在工作空间目录中创建的。如果覆盖了缺省值以便在别处创建项目,则现在在关闭工作台之前打开所有项目。这将使得该项目的 .project 文件被写入正确的位置。无法打开其目录位于工作空间外部的已关闭项目会导致某一项目屏蔽实际项目,使得该项目当中只有一个 .project 文件。

阶段 2:将 Web 项目结构迁移至 J2EE 1.3 项目结构

注意“J2EE 迁移向导”可以执行两项功能:

要迁移至 J2EE 项目结构:

  1. 如果没有打开,则通过从“开始”>“程序”菜单选择此产品来打开 V5.1.2 IDE。
  2. 在 IDE 中,选择“窗口”>“打开透视图”> Web 以打开 Web 透视图。
  3. 在 Web 透视图的“项目导航器”视图中右键单击项目名称并选择“迁移”>“J2EE 迁移向导”
  4. 遵循向导页上的指示信息。如果想要使用 JCA(Java 连接器体系结构)支持,应确保选择了复选框“将项目从版本级别 J2EE 1.2 迁移至 J2EE 1.3”
  5. 单击“完成”以迁移选择的 Web 项目。

阶段 3:迁移“iSeries Web 工具”项目内容

必须先如前一节所描述的那样成功地将 Web 项目迁移至 J2EE 项目结构,然后才能执行以下迁移过程。

要迁移“iSeries Web 工具”项目内容:

  1. 在 Web 透视图的“项目导航器”视图中,右键单击项目名称并选择“属性”。选择左边面板中的“Web 项目功能部件”。从“可用 Web 项目功能部件”列表中选择“添加 Struts 支持”(如果尚未选择)。 按“确定”。在“Web 项目功能部件”窗口中按“完成”以接受缺省 Struts 版本(1.1)。
    注意:
    如果漏掉此步骤,将会出现一个窗口要求添加 Struts 支持。
  2. 要点:此时关闭该项目并重新打开它以避免发生与资源删除相关的异常。
  3. 在 Web 透视图的“项目导航器”视图中右键单击项目名称并选择“迁移”>“iSeries Web 工具项目”
  4. “确认迁移”窗口指示将要迁移项目结构和内容。要继续此过程,请单击“确定”
  5. 将打开“进度信息”窗口,指示正在发生的迁移操作并显示迁移进度。
  6. 迁移过程完成时,将会出现“警告”、“错误”或“成功”消息窗口以指示迁移的结果。
  7. 如果迁移过程成功完成,则无需进行进一步的操作。如果迁移过程带有错误或警告而完成,请继续阶段 4:解决因迁移而生成的错误和警告

迁移过程执行下列操作:

阶段 4:解决因迁移而生成的错误和警告

如果迁移过程遇到问题,则一个窗口将打开,它会指示发生了错误或警告,且这些错误或警告在 Web 透视图中项目名称下的迁移日志文件 projectName_MigrationDetails.txt 中。

迁移日志文件顶部的『迁移结果』一节指示了迁移的整体状态并引用联机信息中的一个文件,该文件对错误和警告以及更正错误和警告所需的操作进行了描述。另请参阅 Development Studio Client for iSeries >“Web 应用程序”> iSeries Web Development >“参考”>“迁移错误和警告详细信息”下的联机帮助。

其它迁移考虑事项

除了在上面阶段 4 描述的日志文件中列示的所有迁移错误外,还需要处理以下适用的情况:

除了在上面阶段 4 描述的日志文件中列示的所有迁移警告外,还应了解下列可能影响 Web 页面外观的更改:

Web 项目迁移的警告和错误消息

错误代码 描述 操作
E100 在 JSP 文件的迁移过程中出现了未确定的错误。 解决或处理迁移日志文件中的所有其它错误或警告并再次运行迁移工具。
E101 JSP 文件中的 iSeries Web 组件有错误。 解决 iSeries Web 组件错误。
E200 处理导致未确定错误的 .wit 文件。 双击具有错误的 .wit 文件以调用“Web 交互作用”向导。完成向导的所有页并进行必要的更改。单击“完成”。
E201 在此交互作用所使用的页中定义的一个或多个 Web 组件名无效。 双击具有错误的 .wit 文件以调用“Web 交互作用”向导。此时会出现一个窗口,指示 Web 组件名无效并询问是否要进行更改。单击“是”。转至向导页“将输入参数映射并链接至输入字段”(在前面的向导页中进行必要的更改)。为更改了名称的任何 Web 组件(输入字段)指定“在会话中命名”、“保存至会话”和“链接”选项。转至向导页“将输出参数映射并链接至输出字段”。为更改了名称的任何 Web 组件(输出字段)指定“在会话中命名”、“从会话复原”和“链接”选项。完成向导的所有页并进行必要的更改。单击“完成”。
E202 在此交互作用中定义的输出参数的“消息指示符”值设置为真。在此发行版中,高级消息处理功能有了很大更改。需要重新定义“消息处理”选项。 双击具有错误的 .wit 文件以调用“Web 交互作用”向导。转至向导页“将输出参数映射并链接至输出字段”。在输出参数的属性窗口中,在“消息控制器”值设置为“真”的情况下,选择值“真”。此时会有一个按钮可见 - 单击此按钮以定义消息控制规范。
E300 处理 DTC 和/或随后的 iSeries Web 组件时出现未确定的错误。 解决或处理迁移日志文件中的所有其它错误或警告。重命名迁移日志文件并再次运行迁移工具。
E301-E302 按钮 DTC 属性“下一步”/“上一步”不再受支持。按钮 Web 组件按钮类型属性将被定义为“提交”。 使用“Web 交互作用”向导创建交互作用,将包含“下一步”/“上一步”按钮的页指定为输入 JSP 页,并将“下一步”按钮的目标页指定为输出 JSP 页。在 V4.0 中,“下一步”/“上一步”按钮与多个输入页一起使用。请参阅“帮助”>“帮助内容”下的信息,然后参阅位于“参考”>“用户界面参考”>“iSeries Web 应用程序”>“多个输入页和输出页”的帮助系统。
警告代码 描述 操作
W100 JSP 页上的 iSeries Web 组件有警告。 处理 iSeries Web 组件警告。
W300 列表框或组合框的“定界符”属性包含多个字符。“定界符”属性中的第一个字符用于相应的 iSeries Web 组件定界符属性。 确保正确定义了选择框或组合框 Web 组件的所有选项的“名称”和“值”属性。
W301-W302 列表框或组合框在“数据”属性 [密钥] 或 [值] 中包含预选字符 *。 确保正确定义了选择框或组合框 Web 组件的所有选项的“名称”和“值”属性。
W303 JSP 文件内组名属性相同的所有单选按钮 DTC 现在作为单选按钮组 Web 组件的选项出现。在 JSP 页中第一个单选按钮的“字体”选项卡和“颜色”选项卡上定义的属性用作“单选按钮组”的“颜色”和“字体”属性。也就是说,同一个组中后面的单选按钮将缺少“颜色”选项卡和“字体”选项卡属性。 通过选择相关的 JSP 文件并在服务器上运行此文件,确保“单选按钮组”在 JSP 页中以所期望的外观出现。通过选择相关的 JSP 文件并在服务器上运行,确保“单选按钮组”的“字体”和“颜色”属性按预期出现。
W304 按钮属性标签不再受支持。 按钮属性值已映射至相应按钮 Web 组件的“标签”属性。在按钮 Web 组件上出现的文本与按钮 DTC 的不同。 如果在按钮 Web 组件上显示的文本不合适,请更改“标签”属性的值。
W305 子文件或表 DTC 现在出现在 HTML FORM 标记外面。表 Web 组件不能出现在 HTML FORM 标记内。如果 DTC 类型为子文件,则相应的 iSeries Web 组件为表 Web 组件。 确保表 Web 组件在 JSP 页上以所期望的外观出现。
W306-W320 DTC 事件属性不再受支持。 若有必要,定义具有不同事件的关联操作。
W306 OnDblClick
W307 OnMouseDown
W308 OnMouseOut
W309 OnMouseOver
W310 OnSelect
W312 对单选按钮进行 OnChange 操作
W313 对复选框进行 OnChange 操作
W314 OnMouseUp
W315 对单选按钮进行 OnKeyDown 操作
W316 对单选按钮进行 OnKeyPress 操作
W317 对单选按钮进行 OnKeyUp 操作
W318 对按钮进行 OnKeyDown 操作
W319 对按钮进行 OnKeyPress 操作
W320 对按钮进行 OnKeyUp 操作
W321 Web 组件定义了不再受支持的属性,原因为:1) 大多数浏览器不支持关联的 CSS 属性 2) 在 HTML 4.0 中已不推荐关联的 HTML 属性,且大多数浏览器不再支持该属性 无。

迁移 iSeries 项目

将 iSeries 项目从 V5.0 迁移至 V5.1.2:

安装之后:
  1. 当启动 V5.1.2 产品(“开始”>“程序”> IBM WebSphere Studio > Development Studio Client for iSeries)时,WebSphere Studio 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 当提示确认是否要转换为新的用户界面格式时,单击“确定”

如果在 5.0 工作台中打开了 5.0“构建状态”视图,则会在 5.1.2 中出现以下错误:

无法复原工作台布局

单击“确定”以继续。这与用“远程系统资源管理器”透视图中的“iSeries 作业状态”视图替换“iSeries 项目”透视图中的“构建状态”视图相关。在最初的“构建状态”视图中列示的任何构建不会在新视图中出现。当重建关联的 iSeries 项目时,在“作业状态”视图和正在进行的函数中出现的新构建将不受影响。

在迁移之后如果在您的 iSeries 项目上有红色标志,这可能是由于与项目相关联的远程系统资源管理器连接不复存在所导致的。要解决此问题:

  1. 右键单击 iSeries 项目,然后选择“属性”>“iSeries 项目”
  2. 设置丢失的连接,并单击“确定”

将 iSeries 项目从 V4.0 迁移至 V5.1.2:

如果还安装了 Development Studio Client for iSeries V4.0:

则在卸载 Development Studio Client V4.0 之前应将项目内容导出至主机。然后,安装 Development Studio Client V5.1.2。安装之后,通过从远程系统资源管理器运行操作可以重新创建这些项目。

安装之前:

如果已经安装了 Development Studio Client for iSeries V5.1.2,并且知道没有将项目上载到远程主机,请跳过本节。

  1. 在 V4.0 中,右键单击 iSeries 项目并选择“推送更改”。这应会将所有代码更改上载至与该项目相关联的库。(如果不能确定此项目以哪个主机和库为目标,则右键单击此项目并选择“属性”>“iSeries 项目”。)
  2. 关闭 V4.0 并卸载它。
  3. 继续安装 Development Studio Client for iSeries V5.1.2。
安装之后:
  1. 在 V5.1.2 中,打开“远程系统资源管理器”透视图:单击“窗口”>“打开透视图”>“远程系统资源管理器”
  2. 浏览至 iSeries 项目的相关联库。此库包含所有从 iSeries 项目上载的源。
  3. 选择此库中作为 iSeries 项目一部分的源物理文件,右键单击它们并选择“采用脱机方式”。这将重新创建映射至此库的 iSeries 项目并将所有源成员以本地方式下载到您的项目中。现在,您可以继续进行开发。

    注意:从“远程系统资源管理器”中的库中选择“创建 iSeries 项目”是重新创建项目的另一种快速方法,但它不从该库下载任何源成员。它只是创建和设置映射至该库和主机的 iSeries 项目。

如果已安装 Development Studio Client for iSeries V5.1.2,并且知道尚未将项目上载到远程主机

安装之后:
  1. 在主菜单中,单击“窗口”>“打开透视图”>“资源”。单击“确定”
  2. 通过单击“文件”>“新建”>“其它”>“简单”>“项目”来创建一个简单项目,并将它命名为 Temp。此项目是用于将 V4.0 的项目导入至 V5.1.2 工作空间的容器。
  3. 选择“文件”>“导入”>“文件系统”。单击“下一步”
  4. 浏览旧的工作空间并导入想要重新创建的项目。(请参阅“在开始之前”下面有关查找工作空间的章节。)
  5. 创建映射至刚刚导入的 V4.0 项目的库和主机的 iSeries 项目。
    • 右键单击“导航器”视图的任何位置并选择“新建”>“项目”> iSeries >“本地”>“iSeries 项目”
    • 如果不记得库和主机,可以在 Temp 项目下名为 .iseries_project_properties 的 XML 文件中找到此信息。
  6. 重新创建已存在于 V4.0 项目中的源物理文件:
    • 单击“文件”>“新建”>“其它”> iSeries >“本地”>“iSeries 源物理文件”
    • 如果不能确定文件的 CCSID 和文件的记录长度,可以直接在每个源物理文件下名为 .iseries_srcpf_properties 的 XML 文件中找到此信息。
  7. 现在将源成员从旧项目拖放至新的 V5.1.2 项目中。
  8. 删除不再需要的 Temp 项目并打开“iSeries 项目”透视图:单击“窗口”>“打开透视图”>“iSeries 项目”

声明

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往:

IBM Director of Licensing
 IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

有关双字节(DBCS)信息的许可查询,请与您所在国家或地区的 IBM 知识产权部门联系,或用书面方式将查询寄往:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

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

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

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

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

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

Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

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

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

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

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

版权许可:

本信息包括源语言形式的样本应用程序,这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口(API)进行应用程序的开发、使用、经销或分发为目的,您可以任何形式对这些样本程序进行复制、修改、分发,而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此,IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序,则可以任何形式复制、修改和分发这些样本程序,而无须向 IBM 付费。

凡这些样本程序的每份拷贝或其任何部分或任何衍生产品,都必须包括如下版权声明:

(C)(贵公司的名称)(年)。此部分代码是根据 IBM 公司的样本程序衍生出来的。(C) Copyright IBM Corp. 1992, 2004. All rights reserved.

编程接口信息

编程接口信息旨在帮助您使用本程序来创建应用软件。

通用编程接口允许您编写获得此程序工具服务的应用软件。

然而,本信息还可能包含诊断、修改和调整信息。它提供诊断、修改和调整信息以帮助您调试应用软件。

警告:切勿使用此诊断、修改和调整信息作为编程接口,因为它随更改而变化。

商标和服务标记

下列各项是国际商业机器公司在美国和/或其他国家或地区的商标:

* AIX * DB2 Extenders * Operating System/400
* AIX windows * DB2 Universal Database * OS/2
* Application System/400 * eserver 图形 * Open Class
* AS/400 * IBM * OS/390
* AS/400e * IBMLink * OS/400
* C Set ++ * Integrated Language Environment * RPG/400
* COBOL/2 * iSeries * SQL/400
* COBOL/400 * Language Environment * VisualAge
* DB2 * MQSeries * WebSphere

InstallShield 是 InstallShield Corporation 的商标。

Intel 和 Pentium 是 Intel Corporation 在美国和/或其他国家或地区的商标。

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

Rational 是国际商业机器公司和 Rational Software Corporation 在美国和/或其他国家或地区的商标。

ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、Windows NT、Win32、Win32s 和 Windows 徽标是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

UNIX 是 The Open Group 的注册商标。

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