本信息描述如何从 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.1.2 之前应该阅读的其它信息。但是,如果已安装 V5.1.2,则可以查找到本指南,例如,在 X:\WDSC\install\help\migrate.htm 中。
如果需要有关迁移到 V5.1.2 如何影响工作空间或项目的特定信息,则可以阅读基本 WebSphere Studio 产品附带的迁移指南中适用的章节。该指南的位置取决于您系统上拥有的 Development Studio Client 的版本。
在安装之后也提供本指南,例如,位于下列位置,
因为 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 条目。
本节描述如何将 Development Studio Client for iSeries V5.0 中创建的程序调用 bean 迁移到 V5.1.2。
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
本节描述如何将 Development Studio Client for iSeries V5.0 中创建的程序调用 bean 迁移到 V5.1.2。
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
本节描述如何将 Development Studio Client for iSeries V4.0 中创建的程序调用 bean 迁移到 V5.1.2。
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
如果具有来自 V4.0、5.0.x 或 5.1.x 的现有项目,则可以在启动 5.1.2 工作台时指定更早的工作空间,并且可以按现状运行项目。但是,项目的显示可能不完整。例如,前发行版的记录 JSP 文件和某些样式文件未出现在 5.1.2 树形视图中。
首次转换 DDS 文件时,更新项目结构以反映新的 5.1.2 布局。例如,导入新的运行时 jar 文件和模板文件。如果明确选择“导入”向导,此情况将以相同方式出现。
如果具有来自 WebSphere Development Studio Client V4.0、5.0 或 5.1 的 WebFacing 项目,则可以使用“导入”向导将这些项目迁移到 Development Studio Client V5.1.2。遵循下列步骤:
原始文件具有下列格式的新名称:filename +_512_bak。
如果定制 WebFacing 项目,可能需要将原始文件中的定制合并到下列文件中:
可以使用下列方法来迁移 iSeries Web 项目:
此迁移涉及到使用 V5.1.2 中 IDE 的现有工作空间和运行 iSeries Web 工具迁移例程。
此迁移涉及到使用 V5.1.2 中 IDE 的现有工作空间和运行 iSeries Web 工具迁移例程。此例程将 Web 项目转换至最新的 J2EE 级别。
下列信息描述如何将 Development Studio Client for iSeries V5.0.x 和 5.1 中的 iSeries Web 项目迁移到 Development Studio Client for iSeries V5.1.2。
迁移活动涉及下列阶段:
在 V5.1.2 中,新 Web 项目的缺省 Web Content 和 Java source 文件夹名可通过首选项页进行配置。现在的缺省名称是 JavaResources 和 WebContent。这些缺省名将只用于新 Web 项目。V5.1.2 之前的版本中创建的 Web 项目将继续使用旧名称来工作。对于静态 Web 项目也是一样。
可以在 V5.1.2 中手工更改 5.0.x 或 5.1 项目的源文件夹名,方法是在“导航器”视图中右键单击文件夹名,然后单击“重命名”。“重命名”操作重命名文件夹名,并确定 5.0.x 或 5.1 Web 项目的 Java 构建路径。如果选择在 V5.1.2 中重命名 JavaResources 和 WebContent 文件夹名,则必须使用新文件夹名手工更新您所拥有的全部自动构建脚本。
要迁移“iSeries Web 工具”项目内容:
如果迁移过程遇到问题,则一个窗口将打开,它会指示发生了错误或警告,且这些错误或警告位于 Web 透视图中项目名称下的迁移日志文件 projectName_MigrationDetails.txt 中。
迁移日志文件顶部的『迁移结果』一节指示了迁移的整体状态并引用联机信息中的一个文件,该文件对错误和警告以及更正错误和警告所需的操作进行了描述。请参阅 Web 项目迁移的警告和错误消息。
仅对 5.0.x 迁移而言,除日志文件中列示的任何迁移警告之外,还应清楚“文本条目 Web 组件”的“最大长度”(maxLength)属性不再受到支持。这可能会影响 Web 页面的外观。
下列信息描述如何将 Development Studio Client for iSeries V4.0 中的 iSeries Web 项目迁移到 Development Studio Client for iSeries V5.1.2。
迁移活动涉及下列阶段:
此方法仅部分受到支持,它会导致迁移不完整。用户界面设置、调试设置以及大部分的首选项都将丢失。保留项目名称、项目源文件和项目 Java 构建路径(类路径),但不能保证其它事项。仅当未使用支持的软件配置管理(SCM)系统并且此方法对于保留项目构建路径信息至关重要时才使用方法,将从 V4.0 导出的项目导入 V5.1.2 时,此项目构建路径信息将丢失。可以通过执行下列操作来使用现有 V4.0.x 工作空间:
V4.0 EAR application.xml 文件和服务器配置文件包含了绝对路径引用。将这些文件迁移到 V5.1.2 之后,需要使用编辑器打开它们(此操作自动将其旧的绝对路径引用更改为新的相对路径引用)。
IBM 扩展文件包含不必要的绝对路径。这是可以自动纠正的... 是否要自动纠正?
如果通过在 V5.1.2 产品中打开 V4.0 工作空间来尝试迁移,可能会出现下列问题。
要将 JRE_LIB 类路径变量重新设置为有效的位置,请遵循这些步骤。第一次打开“首选项”窗口时,即使值看起来正确也要执行此操作。
如果不这样做的话,JRE_LIB 的值就可能是不正确的,从而导致 Java 文件中有许多构建错误。
作为一项常规检查,请验证所有其它类路径变量的值。
在 Eclipse 1.0 与 2.0 之间已对小组支持作了显著的更改。同时更改了通过资源库共享项目的方法。
缺省情况下,项目是在工作空间目录中创建的。如果覆盖了缺省值以便在别处创建项目,则现在在关闭工作台之前打开所有项目。这将使得该项目的 .project 文件被写入正确的位置。无法打开其目录位于工作空间外部的已关闭项目会导致某一项目屏蔽实际项目,使得该项目当中只有一个 .project 文件。
注意“J2EE 迁移向导”可以执行两项功能:
要迁移至 J2EE 项目结构:
必须先如前一节所描述的那样成功地将 Web 项目迁移至 J2EE 项目结构,然后才能执行以下迁移过程。
要迁移“iSeries Web 工具”项目内容:
迁移过程执行下列操作:
如果迁移过程遇到问题,则一个窗口将打开,它会指示发生了错误或警告,且这些错误或警告在 Web 透视图中项目名称下的迁移日志文件 projectName_MigrationDetails.txt 中。
迁移日志文件顶部的『迁移结果』一节指示了迁移的整体状态并引用联机信息中的一个文件,该文件对错误和警告以及更正错误和警告所需的操作进行了描述。另请参阅 Development Studio Client for iSeries >“Web 应用程序”> iSeries Web Development >“参考”>“迁移错误和警告详细信息”下的联机帮助。
除了在上面阶段 4 描述的日志文件中列示的所有迁移错误外,还需要处理以下适用的情况:
除了在上面阶段 4 描述的日志文件中列示的所有迁移警告外,还应了解下列可能影响 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 属性,且大多数浏览器不再支持该属性 | 无。 |
如果在 5.0 工作台中打开了 5.0“构建状态”视图,则会在 5.1.2 中出现以下错误:
无法复原工作台布局
单击“确定”以继续。这与用“远程系统资源管理器”透视图中的“iSeries 作业状态”视图替换“iSeries 项目”透视图中的“构建状态”视图相关。在最初的“构建状态”视图中列示的任何构建不会在新视图中出现。当重建关联的 iSeries 项目时,在“作业状态”视图和正在进行的函数中出现的新构建将不受影响。
在迁移之后如果在您的 iSeries 项目上有红色标志,这可能是由于与项目相关联的远程系统资源管理器连接不复存在所导致的。要解决此问题:
则在卸载 Development Studio Client V4.0 之前应将项目内容导出至主机。然后,安装 Development Studio Client V5.1.2。安装之后,通过从远程系统资源管理器运行操作可以重新创建这些项目。
如果已经安装了 Development Studio Client for iSeries V5.1.2,并且知道没有将项目上载到远程主机,请跳过本节。
注意:从“远程系统资源管理器”中的库中选择“创建 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 | *
![]() |
* 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 的注册商标。
其他公司、产品和服务名称可能是其他公司的商标或服务标记。