© Copyright International Business Machines Corporation 2000, 2007. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
1.0 关于本发行版
2.0 安装信息
2.1 硬件要求
2.2 软件要求
2.3 其他要求
2.4 安装指示信息
2.4.1 将 WebSphere Development Studio Client V7.0.0.1 作为更新来安装
2.4.2 下载修订包以在本地进行安装
2.5 卸载修订包
3.0 此发行版中包含的修订
4.0 已知局限性、问题与变通方法
4.1 数据工具文档中引用了不受支持的功能
4.2 在 WebSphere Application Server 上调用 Axis Web Service 时发生内部服务器错误“SAXException：文件过早结束”
4.3 J2C“相同的输入和输出”样本链接在 Linux 操作系统上不起作用
4.4 由于发生异常而未能将启用了 Web 站点导航功能的静态 Web 项目转换为动态 Web 项目
4.5 由于发生错误而未能发布具有多个源目录的 EJB
4.6 回滚功能在 Installation Manager V1.0.0.2 中不受支持
5.0 IBM WebSphere 软件支持
6.0 声明与商标
此修订包中包含对 IBM® WebSphere® Development Studio Client for iSeries V7.0 发行版的修订。
如果已经在计算机上安装了 IBM WebSphere Development Studio Client for iSeries V7.0，可以将此修订包作为它的更新来安装；也可以在安装 IBM WebSphere Development Studio Client for iSeries V7.0 的同时安装此修订包。
要查看此自述文件的最新版本，请访问以下网址：http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/7001/documents/readme/readme.html。
另外，请参阅此产品的 V7.0 的发行说明，以了解它的新功能部件以及在发行时就存在的任何已知局限性或问题。在以下网址提供了 V7.0 的发行说明：http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/70/documents/readme/readme.html
本节描述了此修订包的安装要求和特定安装指示信息。
有关安装 WebSphere Development Studio Client for iSeries V7.0 以及必备软件的信息，请参阅以下网址在线提供的《安装指南》： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/70/documents/install_instruction/install.html。
安装此修订包时对处理器或内存没有更多要求。但是，根据您是在安装 WebSphere Development Studio Client V7.0 的同时就安装此修订包还是将此修订包作为更新来安装，需要的磁盘空间会有所不同：
（可选）如果选择下载压缩文件形式的更新并在本地进行安装，则大约需要 335 MB 磁盘空间来存储该压缩文件和对它进行解压缩。
本节描述了安装 WebSphere Development Studio Client for iSeries V7.0.0.1 时的其他软件要求；要了解安装 WebSphere Development Studio Client 7.0 时的要求，请参阅《安装指南》。
必须安装了 IBM Installation Manager V1.0.0.2，才能安装此修订包。在 Installation Manager 中，如果尚未禁用缺省设置以在安装和更新期间搜索链接的存储库，则当您尝试使用较早版本的 Installation Manager 来更新或安装软件包时，就会在计算机上自动安装 IBM Installation Manager V1.0.0.2。
有关 Installation Manager V1.0.0.2 的其他信息，请参阅 http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/im/1002/docs/readme/readme.html。
通常，需要访问因特网。这是因为缺省情况下更新位于 WebSphere Development Studio Client V7.0 的 IBM 更新存储库中，并且由 Installation Manager 直接从此更新存储库中进行安装。
要点：安装了 WebSphere Development Studio Client 之后，其更新存储库所在的位置会自动嵌入在 Installation Manager 中。要让 Installation Manager 搜索缺省更新存储库，必须在“存储库首选项”页面上选择在安装和更新期间搜索相链接的存储库首选项。缺省情况下将选择此首选项。
要从其他存储库位置来安装修订包（例如，如果修订包位于共享驱动器或者 HTTP 或 HTTPS 服务器上），则必须在 Installation Manager 中添加该存储库位置。要添加存储库位置：
以下是用于安装此更新的两种常用方法：
缺省情况下，从 IBM 更新存储库中直接安装更新。但是，也可下载更新。有关详细信息，请参阅下述有关 WebSphere Development Studio Client V7.0.0.1 的特定安装指示信息。
2.4.1 将 WebSphere Development Studio Client V7.0.0.1 作为更新来安装
使用安装了该产品的同一用户帐户来安装修订包。
限制：
要查找 WebSphere Development Studio Client V7.0.0.1 并将它作为更新来安装：
可以下载包含 WebSphere Development Studio Client V7001 修订包的压缩文件，将该压缩文件解压缩之后所获得的文件将组成修订包的存储库。 可以从您自己电脑上的存储库中安装修订包，也可以将存储库复制到一个共享驱动器或者 HTTP 或 HTTPS 服务器中。
要下载并安装修订包，请完成下列步骤：
注意：
在从本地存储库进行更新的过程中，Installation Manager 可能会提示您输入 WebSphere Development Studio Client V7.0 的存储库所在的位置。如果您是从 CD 或者其他介质中安装该产品，则它们在您使用更新功能时必须可用。
尽管已在本文档中提及，但 Installation Manager V1.0.0.2 中仍未启用“卸载软件包”向导中的回滚功能。因此，如果您安装了 WebSphere Development Studio Client V7.0 并已经将它更新为 V7.0.0.1，则使用“卸载软件包”向导将无法把它还原为 V7.0。
要还原为 WebSphere Development Studio Client V7.0，必须卸载整个软件包。单个卸载过程将除去 V7.0 软件包和已升级的 V7.0.0.1 软件包。卸载之后，就可以重新安装 V7.0 软件包。
卸载 WebSphere Development Studio Client V7.0.0.1 之前，请执行下列步骤：
要卸载 WebSphere Development Studio Client V7.0.0.1，请执行以下操作：
有关卸载 WebSphere Development Studio Client 的其他指示信息，请参阅《安装指南》或 Installation Manager 联机帮助。
在此发行版中修订了下列 APAR：
有关所有 WebSphere Development Studio Client APAR 的信息，请参阅：http://www-1.ibm.com/support/search.wss?rs=3239&lang=en&loc=en_US&r=10&cs=utf-8&rankfile=0&cc=&spc=&stc=&apar=include&q1=5722WDS03+OR+5722WDS04+OR+5722WDS05+OR+5722WDS05+OR+5722WDS06+OR+5722WDS07+OR+5722WDS08+OR+5722WDS09&q2=7.0.0.1&Go.x=0&Go.y=0&sort=desc&tc=SSZND2&dc=DB550+D100&dtm
在此发行版中，已经修正了 V7.0 发行说明中所列示的下列已知局限性或问题：
有关本发行版中已更新的修订列表，请参阅以下网址提供的此自述文件的已更新版本： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/7001/documents/readme/readme.html。
IBM 支持 Web 站点 http://www.ibm.com/software/awdtools/wdt400/support 中以技术说明（technotes）形式记录了有关 WebSphere Development Studio Client for iSeries V7.0 的更新、局限性和已知问题。
随着局限性和问题的发现和解决，IBM 软件支持团队更新了知识库。通过搜索知识库，您可以快速找到问题的变通方法或解决方案。WebSphere Development Studio Client for iSeries Web 站点的“自助帮助”部分中的技术说明（Technotes）链接启动实时支持知识库的定制查询。要缩小搜索范围，指定 V7 作为搜索项。要创建您自己的查询，请转至 IBM 软件支持 Web 站点的高级搜索（Advanced search）页面。
4.1 数据工具文档中引用了不受支持的功能
在信息中心的“开发数据访问应用程序”一节中，“例程和 JAR 文件部署”这一主题中不正确地引用了支持对 Java™ 存储过程的 JAR 文件进行部署的功能。
不支持部署 JAR 文件，并且应该忽略引用。本主题中的其他信息是准确的。4.2 在 WebSphere Application Server 上调用 Axis Web Service 时发生内部服务器错误“SAXException：文件过早结束”
调用使用 WebSphere Application Server 服务器上的 Web Service 向导创建的 Axis Web Service 时，可能会发生“（500）内部服务器错误”，并且在服务器控制台中显示以下消息：
org.apache.axis.InternalException: org.apache.axis.ConfigurationException: org.xml.sax.SAXException: Fatal Error: URI=null Line=-1: Premature end of file.
之所以发生此错误，是由于 Web 项目的 WebContent/WEB-INF 目录中的 server-config.wsdd 文件是空的。
变通方法：在 WebSphere Application Server 上创建 Axis Web Service 之前，选择一个非缺省位置作为 Web 项目的 Java 输出目录。
要更改 Java 输出目录：
- 在“项目资源管理器”视图中，右键单击 Web 项目，然后选择“属性”。
- 在“属性”窗口左边的窗格中，单击 Java 构建路径。
- 单击源代码选项卡。
- 在“构建路径”页面上的“源文件夹”中，选中允许源文件夹的输出文件夹复选框，然后将缺省输出文件夹条目更改为除 WebProject/WebContent/WEB-INF/classes 之外的其他内容，其中 WebProject 是 Web 项目的名称。例如，将输出文件夹更改为 WebProject/output/classes。
4.3 J2C“相同的输入和输出”样本链接在 Linux 操作系统上不起作用
在 Linux 操作系统中运行应用程序时发生错误。当您打开帮助 > 样本库 > 技术样本 > J2C Java Bean 技术样本 >“相同输入和输出”样本并且单击“导入样本（适用于 WAS 6.0）”链接时将发生错误。将不会打开导入向导，并且控制台中将出现“NULL 指针异常”消息：
Exception in GalleryWizardAction: java.lang.NullPointerException
wizard = com.ibm.etools.project.interchange.generic.CustomProjectInterchangeImportWizard
java.lang.NullPointerException
at com.ibm.etools.project.interchange.generic.CustomProjectInterchangeIm portWizard$1.getAllProjectMap(Unknown Source)
at com.ibm.etools.project.interchange.generic.CustomProjectInterchangeIm portWizard$1.doAddPages(Unknown Source)
at com.ibm.etools.emf.workbench.ui.wizard.datamodel.WTPWizard.addPages(U nknown Source)
at org.eclipse.jface.wizard.WizardDialog.createContents(Unknown Source)
at org.eclipse.jface.window.Window.create(Unknown Source)
at org.eclipse.jface.dialogs.Dialog.create(Unknown Source)
at com.ibm.samplegallery.GalleryWizardAction$RunnableWizardDelegate.run( Unknown Source)
at org.eclipse.swt.widgets.RunnableLock.run(Unknown Source)
at org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown Source)
at org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown Source)
at org.eclipse.swt.widgets.Display.readAndDispatch(Unknown Source)
at org.eclipse.ui.internal.Workbench.runEventLoop(Unknown Source)
at org.eclipse.ui.internal.Workbench.runUI(Unknown Source)
at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Unknown Sourc e)
at org.eclipse.ui.PlatformUI.createAndRunWorkbench(Unknown Source)
at org.eclipse.ui.internal.ide.IDEApplication.run(Unknown Source)
at org.eclipse.core.internal.runtime.PlatformActivator$1.run(Unknown Sou rce)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runAppli cation(Unknown Source)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(Un known Source)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown Source)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown Source)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at org.eclipse.core.launcher.Main.invokeFramework(Unknown Source)
at org.eclipse.core.launcher.Main.basicRun(Unknown Source)
at org.eclipse.core.launcher.Main.run(Unknown Source)
at org.eclipse.core.launcher.Main.main(Unknown Source)变通方法：选择“导入样本（适用于 WAS 6.1）”链接，它在 WebSphere Application Server 6.0 或 6.1 上都将起作用。
4.4 由于发生异常而未能将启用了 Web 站点导航功能的静态 Web 项目转换为动态 Web 项目
尝试将启用了 Web 站点导航功能的静态 Web 项目转换为动态 Web 项目时（转换方法是：在“项目资源管理器”视图中选择该静态 Web 项目，然后从“项目”菜单中选择转换为动态 Web 项目），由于发生以下异常而转换失败：“无法除去 org.eclipse.wst.common.modulecore.ModuleCoreNature 性质，因为它是 com.ibm.etools.siteedit.WebSiteNature 性质的先决条件”。
原因：将具有 Web 站点导航功能的静态 Web 项目转换为动态 Web 项目这一内部过程中，需要除去具有从属性质（WebSiteNature）的项目性质（ModuleCoreNature）。
变通方法：要成功转换该项目，首先应通过执行下列步骤来编辑静态 Web 项目的 .project 文件：现在就可以成功地将该项目转换为动态 Web 项目了。
- 单击窗口 > 打开透视图 > 其他 > 资源。“资源”透视图将打开。
- 在“导航器”视图中，展开项目文件夹并打开该项目的 .project 文件。缺省情况下，XML 编辑器将打开。
- 在“设计”视图中，展开 projectDescription 节点，然后展开性质节点。
- 选择 com.ibm.etools.siteedit.WebSiteNature 性质，单击右键，然后选择除去。这就从“性质”节点中删除了 com.ibm.etools.siteedit.WebSiteNature 性质。
- 保存 .project 文件。
4.5 由于发生错误而未能发布具有多个源目录的 EJB
如果尝试发布包含多个源文件夹的 EJB 项目（例如，具有备用源文件夹的注释项目），则会因发生错误而发布失败。
在“控制台”视图中，您可能会看到与以下示例相似的错误：
[1/11/07 15:28:36:906 PST] 00000027 SystemErr R
*** ERROR ***: Thu Jan 11 15:28:36 PST 2007 org.eclipse.jst.j2ee.commonarchivecore.internal.exception.OpenFailureException: IWAE0023E Unable to open module file "AuctionV60EJB.jar" in EAR file "C:\v7001workspaces\7001Week2\AuctionV60EAR"
Stack trace of nested exception:
org.eclipse.jst.j2ee.commonarchivecore.internal.exception.OpenFailureException: IWAE0006E Archive is not a valid EJB JAR File because the deployment descriptor can not be found (case sensitive): META-INF/ejb-jar.xml变通方法：执行下列步骤来编辑已生成的 looseconfig.xmi 文件：
如果服务器仍在运行，则重新启动服务器以使更改生效。
- 在计算机上浏览至工作空间目录，并在编辑器中打开 /.metadata/.plugins/com.ibm.etools.wrd.websphere/looseconfigurations/EAR project name/looseconfig.xmi 文件，其中 EAR project name 是 EAR 项目的名称。
- 更改 binariesPath 和 resourcesPath 这两个路径属性，使它们引用 EJB jar 文件的“ejbModule”而不是“gen/src”。
- 保存更改。
现在，您就应该能够成功发布 EJB 了。
4.6 在 Installation Manager V1.0.0.2 中未启用回滚功能
在 Installation Manager V1.0.0.2 中未启用“卸载软件包”向导中的回滚功能以及用于静默安装的 rollback 命令。同样，无法还原先前已安装的软件包版本。
例如，如果您安装了 WebSphere Development Studio Client V7.0，然后已经将它更新为 V7.0.0.1，则使用“卸载软件包”向导或上述命令将无法把它还原为 V7.0。
变通方法：要还原为软件包的较早版本，必须卸载整个软件包。单个卸载过程将除去 V7.0 软件包和已升级的 V7.0.0.1 软件包。卸载之后，需要重新安装 V7.0 软件包。
IBM WebSphere 软件支持为您提供了技术帮助。
有关当您需要支持时所需的联系信息和指南或参考材料，请阅读 IBM 软件支持手册。
有关 FAQ、已知问题与修订的列表以及其他支持信息，请访问 IBM WebSphere 软件支持 Web 站点。
有关 WebSphere 软件产品新闻、事件和其他信息，请访问 IBM WebSphere 软件 Web 站点。
在与 IBM WebSphere 软件支持机构联系之前，请收集描述您的问题将需要的背景信息。向 IBM 软件支持机构的专家描述问题时，应尽可能地具体并包括所有相关的背景信息，以便该专家能够有效地帮助您解决问题。为了节省时间，需要知道下列问题的答案：
- 您在运行软件的哪个版本时发生了此问题？
- 是否有与问题相关的日志、跟踪和消息？
- 是否可以重现问题？如果可以，您执行了哪些步骤？
- 该问题有变通方法吗？如果有，请描述变通方法。
在新闻组上发布问题
要在新闻组上发布您的问题，请使用下列资源：
新闻服务器：
推荐的新闻组：
- ibm.software.websphere.studio400
其他推荐的论坛：
© Copyright IBM Corporation 2007. All Rights Reserved.
本信息是为在美国提供的产品和服务编写的。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 站点带来的风险将由您自行承担。
本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：
Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7
只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。
本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。
此处包含的任何性能数据都是在受控环境中测得的。因此，在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的，因此不保证与一般可用系统上进行的测量结果相同。此外，有些测量是通过推算而估计的，实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。
涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。
所有关于 IBM 未来方向或意向的声明都可随时更改或收回，而不另行通知，它们仅仅表示了目标和意愿而已。
本信息包含在日常业务操作中使用的数据和报告的示例。为了尽可能完整地说明这些示例，示例中可能会包括个人、公司、品牌和产品的名称。所有这些名称都是虚构的，与实际商业企业所用的名称和地址的任何雷同纯属巧合。
商标和服务标记
以下各项是 IBM Corporation 在美国和／或其他国家或地区的商标：
- ClearCase
- IBM
- i5/OS
- iSeries
- Rational
- System i
- WebSphere
Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和／或其他国家或地区的商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和／或其他国家或地区的商标。
UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。
Linux 是 Linus Torvalds 在美国和／或其他国家或地区的注册商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。