本文档包含了 WebSphere Development Tools for AS/400 产品所需先决条件的信息。另外，它还包含了文档中未包括的任何产品限制和信息。
目录
一般规则
不要使用响应文件。不支持它们。
在安装期间询问您是否要重新启动时，总是回答“是”。 对于某些语言，重新启动对话框只有“是”和“否”按钮。总是回答“是”。
应用程序 msiexec.exe 可能会生成下列错误消息：“'...' 处的指令引用了 '...' 上的内存。不能“读取”该内存。”单击“确定”。这好象不会对产品安装产生副面影响。
安装偶而出现停顿，但不超过 5 分钟。这是正常的。仅当出现完成对话框时，安装才完成。
可选组件| 组件 | 包含在 产品中 | 需要 重新启动 | 安装类型 | 注释 |
|---|---|---|---|---|
| MS JVM (msjava.dll) |
是 | 是 | 交互式 - 从安装中启动 | 运行 Studio 时必需的。 |
| J2SDK 1.2.2 | 是 | 否 | 交互式 - 从安装中启动 | 执行所有 CODE/400 和 VARPG 功能时必需的。请参阅 JDK 注意事项。 | Netscape Communicator | 是，(V4.7) 在一张 单独的 CD 上 |
否 | 通过选择 CD 和适当的语言目录来手工安装 |
| Microsoft Internet Explorer | 否，可 从供应商处获得 |
是 | 手工安装版本 4.0 或更新版本 | 如果没有安装，一些主要的 Studio 功能将无法工作。 |
Web 浏览器
“帮助”已在 Netscape Navigator 4.7 和 Internet Explorer 4 及以上版本上测试过。
安装后，请确保 Web 浏览器将服务器名称 "localhost" 绕过了代理服务器。
有时，浏览器不能与本地 Web 服务器 httpdl.exe 连接，因为它试图通过代理服务器定位名为 "localhost" 的机器。通常这种情况发生在浏览器设置为手工或自动代理配置。如果使用手工代理配置，
可以修改浏览器设置以阻止浏览器试图通过代理服务器解析 "localhost"。如果使用自动代理配置，
则需要向自动代理配置文件的所有者要求将 127.0.0.1 作为代理例外添加在代理服务器上。
要确定浏览器是否设置手工代理配置，并在需要时添加代理重设项，请执行这些步骤。 这些指令是针对指明的浏览器版本的；如果使用另一个浏览器版本，步骤可能会不同：
对于 Netscape 4.7：
127.0.0.1 作为代理例外添加在代理服务器上。对于 Internet Explorer 5.0：
如果文件 %SystemRoot%\system32\drivers\etc\hosts 中没有下面这行：
127.0.0.1 localhost
，还应该通过添加它来更新文件。如果更改这个值，可能需要退出并重新启动浏览器，使更改生效。
如果对浏览器配置或 "...\etc\hosts" 文件进行了任何更改，请尝试在浏览器中重新装入帮助主页。如果在尝试与 locahost:49213 连接时仍然得到错误消息， 请与 IBM 支持联系。
如果尝试查看帮助时不能访问自动代理服务器，则浏览器可能不能将 localhost 解析为本地地址 127.0.0.1。 在上面的第 4 步 (Netscape) 或第 3 步 (Internet Explorer) 中通过更改为直接连接因特网， 可以暂时解决这一问题（但代理服务器仍不可用）。
这是 Windows 2000 中有关“帮助搜索”功能的已知 Netscape 问题。请参阅 Windows 2000 中的 Netscape，获得描述。要使用 Internet Explorer 获得帮助， 启动 Internet Explorer 并对消息“您希望将它设置为缺省浏览器吗？”选择“是”。在缺省浏览器更改生效时，必须关机并启动产品功能。
在 Windows 95 或 Windows 98 上安装
如果接收到一条错误消息指出无法安装 NetQuestion，
这是由于在 autoexec.bat 文件中的 PATH 语句长度超过了 200 个字符。缩短 PATH 语句以改正这个问题。
Windows 95 工作站必须是版本 4.00.950a 或更新版本， 还必须在安装此产品之前已安装了 Internet Explorer 5 版本 5.00.2314.1003 或更新版本。
在 Windows NT 或 Windows 2000 上安装
由于在 Windows NT 和 2000 中在使用的环境变量中对 Microsoft Installer 做了更改，请遵循这些规则：
x: 指安装产品的驱动器。
| 系统变量名 | 必须包括此项 |
| CLASSPATH | x:\wdt400\java |
| HELP | x:\wdt400\help |
| IPF_PATH32 | x:\wdt400\system |
| LOCPATH | x:\wdt400\system |
| PATH | x:\wdt400 |
产品卸载
要卸载 WebSphere Development Tools for AS/400，在命令提示处从原始安装源中运行 wdt4imain.exe，并使用“程序维护”屏幕中的“除去”选项。不要使用 Windows 的“添加／删除程序”方法并且不要手工除去个别功能部件，
因为这样不能正确除去它们。在卸载该产品之后一定要重新启动您的机器。
卸载或取消安装可能会留下不需要的文件、目录和注册表项。要将工作站恢复为原始状态，请执行下列过程。
wdclean.exe 下载到选择的工作站目录中。wdclean.exe 不再需要，就删除它。c:\wdt400。确保该路径是正确的。在路径中仅使用短名称。win95、win98、winnt 还是 win2k。cd %temp% 以访问解压文件。如果解压到特定目录，请更改至该目录。cleanup [path] [OS]，其中 [path] 是安装路径，[OS] 是操作系统。finish 以删除清除文件。
产品修改
要更改此产品中可用的功能部件，将安装 CD 1 插入 CD 驱动器，在命令提示处输入 x:\wdt4imain.exe
（其中 x: 是 CD 盘符）并使用“程序维护”屏幕中的“修改”选项。不要使用 Windows 的“添加／删除程序”方法并且不要手工除去个别功能部件，
因为这样不能正确除去它们。在修改产品后一定要重新启动您的机器。
取消安装
如果安装期间单击“取消”，就会如产品卸载一节中描述的那样卸载产品，
以确保除去所有文件。
国家语言安装
该产品将根据系统语言环境安装一种语言。如果在安装完成后更改语言环境，那么产品功能和帮助屏幕可能无法显示正确的语言。
要更改语言，请完全卸载产品（如产品卸载部分中描述的那样），
更改语言环境然后重新安装产品。
安装韩语或西班牙语
以韩语或西班牙语安装可能会在开始->程序->IBM WebSphere Development Tools for AS400 菜单中出现两个 WebSphere Studio 项。
可以执行下列步骤，从 WDT/400 Web 站点获得对此的修订。
wsmerge.exe 下载到选项的工作站目录。win95、win98、winnt 还是 win2k。cd %temp% 以访问解压文件。如果解压到特定目录，请更改至该目录。wsmerge [OS]，其中 [OS] 是操作系统。
对 WebSphere Studio for AS/400 指南的更改
封装 Web 应用程序中引用的程序名更改如下：
对 WebSphere Studio 设计时控件的更改
对于与下列 WebSphere Studio for AS/400 设计时控件 (DTC) 相关的运行时属性特性的“操作数 1”和“操作数 2”，
联机帮助描述得不够完整：
Checkbox、Combobox、Entryfield、Label、Listbox、Pushbutton 和 Radiobutton。
操作数 1 的描述应该是：
输入操作数的字段名。该字段可以是 JSP 页面上的任何唯一字段名。
指定的名称必须与您在 Web 交互向导中指定 ILE 程序的输入和输出参数页面上指定的输出参数名称匹配。
操作数 2 的描述应该是：
输入此操作数的常量值，以与操作数 1 进行比较。
如果选择字段名操作数，还可以输入操作数 2 的字段名。该字段可以是 JSP 页面上的任何唯一字段名。
指定的名称必须与您在 Web 交互向导中指定 ILE 程序的输入和输出参数页面上指定的输出参数名称匹配。
对 WebSphere Studio Web 交互向导的更改
Web 交互向导提供“小服务程序 URL”字段，以准备要调用的超文本链接的模板并将数据传递到小服务程序。
对话框“指定 Web 交互的名称”显示 URL。显示创建小服务程序的最后一个框允许更改数据。例如，小服务程序 URL 可能显示为：
"/servlet/NuthinServlet?Custno=#1&Custna=#2".
如果 "12345" 和 "Smith" 替换占位符 "#1" 和 "#2"，则等价调用为：
"servlet/NuthinServlet with Custno=12345 and Custna=Smith".
VisualAge RPG 的附加信息
下列“部件”属性已添加到 VisualAge RPG 中。
| 部件 | 属性 | 类型 | 描述 | 操作 代码 |
可操作 运行时 |
|---|---|---|---|---|---|
| 子文件 | EditColumn | 数字 | 返回正打开用于编辑的单元的列号。 | setatr getatr |
否 是 |
| EditIndex | 数字 | 返回正打开用于编辑的单元的行号。 | setatr getatr |
否 是 |
|
| EditText | 文本 | 返回正在编辑的单元的当前编辑文本。 如果没有打开任何单元，则返回空字符串。 |
setatr getatr |
否 是 |
|
| 窗口 | PrintAsIs | 文本 | 打印图像和维护长宽比。 | setatr getatr |
是 否 |
| 图像 | PrintAsIs | 文本 | 打印图像和维护长宽比。 | setatr getatr |
是 否 |
帮助概述样本
已将用于“子文件 DTC”的“子文件 API 服务程序”的名称从 SFLIBSRV 更改为 QDTSSFL。
这一更改会影响以下部分中的“帮助”文档：
概述
WebSphere Development Tools for AS/400 入门
创建 Web 应用程序
样本：使用 WebSphere Studio for AS/400 创建一个 Web 应用程序。
所有读取“. . . API 模块 SFLIBSRV”的描述都应该读取“. . . API 服务程序 QDTSSFL”。
JDK 注意事项
IBM WebSphere Development Tools for AS/400 是与 IBM 的 Java 2 Software Development Kit (J2SDK)，标准版 v1.2.2 一起提供的。J2SDK 包含了 JavaDoc。如果选择使用另一个 JDK，那么它必须是版本 1.2 或更高版以确保 Java 代码的所有部分都可正确运行。
要使用不同的 JDK，请确定它的 JRE（Java 运行时环境）主目录。在 CODE 编辑器中，输入命令 "SET GLOBAL.JREHOME x:\dir"， 其中 x:\dir 是 JRE 主目录。例如， "SET GLOBAL.JREHOME C:\JDK1.2\JRE"。
当 J2SDK 安装完成时，请更新 PATH 和 CLASSPATH 环境系统变量以包含适当的 J2SDK 目录。这样就允许 VARPG 使用 Java。例如， 如果在目录 x:\jdk12 中安装 J2SDK，那么将下列信息添加到 PATH 变量中：x:\jdk12\bin。
如果计划使用 VisualAge RPG Media 组件，那么请安装 Java Media Framework API。
VisualAge RPG GUI 设计器和 Java Plug-in
Netscape Navigator 和 Microsoft 的 Internet Explorer 当前并不支持 VisualAge RPG 使用的同一级别的 J2SDK。因此，用 VisualAge RPG GUI 设计器创建的小应用程序不会直接在这些浏览器上运行。要在任意一个浏览器上运行 VisualAge RPG 小应用程序，就必须安装了 Java Plug-in 1.2（包括在 J2SDK 中）
和 HTML Converter（可从 JavaSoft 中获得）。
可以通过 Sun 公司的 Web 站点 sun.com 的
The Source for Java Technology Web 页面中的链接下载它们。HTML Converter 允许您转换带有 applet 标记的 HTML 页面以使用 Java Plug-in。转换会创建一个 object 标记，告诉 Web 浏览器使用 Java Plug-in 来替代它自己的 Java 2 运行时环境。
Distributed Debugger
当正在调试从 Web 页面（该页面由 WebSphere Studio for AS/400 生成）启动的“程序”或“服务程序”时，
“程序”完成或“服务程序”入口点完成不会使调试器终止。这会防止随后的调试会话。要再次进行调试，可使用“停机”按钮，关闭未完成的调试会话。
对象级跟踪
如果在 Windows 95 或 Windows 98 上不能启动“对象级跟踪”，请确保环境空间设置为最大值。
在 CONFIG.SYS 中，查找 SHELL 伪指令并确保 /E 值设置为 32768。
例如: SHELL=C:\WINDOWS\COMMAND.COM /p /E:32768
如果目录 DbgProf 中的环境文件被毁坏，OLT 查看器将失败。如果发生这种情况，删除 DbgProf 目录中的所有文件。每个用户都有一个单独的目录。当 OLT 查看器启动时，它将再次创建文件。
当第一次启动 OLT 查看器时或删除目录 DbgProf 中的环境文件之后， OLT 查看器显示错误信息“无法打开 dertrdfl 的输入流。”。这个错误信息不影响 OLT 查看器的执行。
Netscape Navigator 不一致性
Netscape Navigator 不符合 HTML 4 的标准。
由 WebSphere Studio for AS/400 生成并
由 Netscape Navigator 显示的 Web 页面有下表中描述的 DTC 问题。当使用 Internet Explorer 时，不会发生这些问题。
| DTC 类型 | 外观问题 | 事件问题 | 属性问题 |
|---|---|---|---|
| Entryfield | 不能重设颜色和背景色缺省值。 | 不支持 OnSelect、OnClick、OnDblClick、OnMouseOver、OnMouseDown、OnMouseUp 和 OnMouseOut。 | “对齐”属性移动整个字段，而不仅仅是文本。 不支持“只读”属性，但可以按照下面的方法修正这个问题： - 选择 DTC - 显示“控件属性”对话框 - 选择“事件”选项卡 - 单击 onFocus 事件 - 在脚本框中输入 "this.blur();"。 |
| Checkbox | 没问题 | 不支持 OnChange。 | 没问题 |
| Combobox | 不能重设颜色和背景色缺省值。 忽略字体。 |
没问题 | 没问题 |
| Listbox | 不能重设颜色和背景色缺省值。 忽略字体。 |
没问题 | 没问题 |
| MLE | 不能重设颜色和背景色缺省值。 忽略字体。 文本不能正确地自动换行。 |
不支持 OnSelect。 | 没问题 |
| Pushbutton | 背景色始终显示为淡灰色。 | 不支持 OnKeyPress、OnKeyUp、OnKeyDown、OnMouseOut 和 OnMouseOver。 | 没问题 |
| Radiobutton | 没问题 | 不支持 OnMouseOut、OnMouseOver、OnKeyUp、OnKeyDown、OnKeyPress 和 OnChange。 | 没问题 |
Windows 2000 中的 Netscape
在一些 Windows 2000 机器上存在已知的 Netscape（版本 4.5 到 4.74，可能还有其它版本）问题，
可能会使搜索联机帮助时异常缓慢。当从这些版本的 Netscape 中提交表单时，Netscape 应用程序会使用机器上的绝大部分可用处理器周期，
直到接收到远程系统的响应。通常，执行远程搜索（如在 Web 站点上）时这不是问题。但是，因为产品的搜索程序正在您自己的本地机器上运行，
所以 Netscape 占用过多 CPU 时间的这一事实意味了只有很少 CPU 时间供搜索程序执行它的搜索。因此，
应该立即返回结果的搜索操作在 Windows 2000 上可能会花几分钟的时间。
每次提交搜索后通过选择另一个非 Netscape 窗口，可以避免这一性能问题。这通常会使 Netscape 在等待响应时停止使用过多的 CPU 周期， 而且搜索结果常会在执行这一窗口切换后立即显示。
或者，可以使用 Microsoft Internet Explorer 来查看帮助。使用这个浏览器不会发生性能问题。
Norton AntiVirus
如果在 Windows 95 或 Windows 98 机器上安装了 Norton AntiVirus，并且 WebSphere Development Tools 中的任何部件
（如“调试器”或“对象级跟踪”）不工作，请禁用 Norton Antivirus 并重试。
帮助不工作
安装后，如果“帮助”由于浏览器没有启动而不工作，则重新配置“帮助”系统。下列过程不需要使用安装 CD。
| 1. | 确定工作站的操作系统 YY。 |
YY 是 |
||
95 表示 Windows 95 |
98 表示 Windows 98 |
|||
NT 表示 Windows NT |
2K 表示 Windows 2000 |
|||
| 2. | 确定目录 WDT400\help 所在的驱动器 W。 |
W 是 |
安装产品的驱动器。 | |
| 3. | 确定目录 imnnq_YY 所在的驱动器 X。 |
X |
通常指安装产品的驱动器。 | |
| 4. | 确定安装的语言 zz_ZZ。 | zz_ZZ 是 |
||
en_US 表示英文 |
fr_FR 表示法语 |
|||
de_DE 表示德语 |
pt_BR 表示巴西葡萄牙语 |
|||
it_IT 表示意大利语 |
es_ES 表示西班牙语 |
|||
ko_KR 表示韩语 |
ja_JP 表示日语 |
|||
zh_CN 表示简体中文 |
zh_TW 表示繁体中文 |
|||
| 5. | 打开“命令提示”窗口。 | |||
| 6. | 更改为驱动器 X。替换 X 并输入命令： | X: |
||
| 7. | 将目录更改为 imnnq_YY。 替换 YY 并输入命令： |
cd imnnq_YY |
||
| 8. | 要除去帮助系统， 请替换 X、YY 和 zz_ZZ 并输入此命令： |
vahcfgw.exe remove /p va400 /f X:\imnnq_YY /l zz_ZZ |
||
| 9. | 要恢复帮助系统， 请替换 W 和 zz_ZZ 并输入此命令： |
vahcfgw.exe install /w W:\wdt400\help /l zz_ZZ |
||
| 10. | 等待重新配置“帮助”完成， 然后关闭“命令提示”窗口。 |
|||
发行说明文档提供有关产品的主要功能部件、硬件和软件需求以及迁移过程的信息。
请访问我们的万维网页面：
ibm.com/software/awdtools/wdt400/
也以从 IBM Software 主页 ibm.com/software/ 中的链接获得这些页面。使用以下的 newsgroup 并提出您的问题：
News 服务器：
news.software.ibm.com
建议的 newsgroup：
ibm.software.code400
ibm.software.vajava
ibm.software.varpg
本信息针对美国境内所提供的产品和服务。IBM 可能未在其它国家提供本文档中讨论的产品、 服务和功能。请咨询当地的 IBM 代理，以获取您所在地区目前提供的产品和服务的信息。 对 IBM 产品、程序或服务的任何引用并非表明或暗示只能使用 IBM 的产品、程序或服务。 凡是同等功能的产品、程序或服务，只要不侵犯 IBM 的知识产权，都可以代替。但是， 评估和验证任何非 IBM 产品、程序或服务则是用户的责任。
IBM 可能已经申请或正在申请与本文档有关的各项专利权。提供本文档并不表示允许您使用这些专利。 可以用书面形式将特许查询寄往：
Director of Licensing以下这段不适用于英国或任何其它本地法律与这些条例不一致的国家： 国际商业机器公司“照原样”提供本出版物，并不保证任何形式的显式的或隐式的担保， 包括（但不限于）对不违法、适销性或适于特定目的之隐式担保。 一些国家不允许在特定交易中推卸明确或隐式的担保，因此本声明可能不适用于您。
本信息可能有技术方面的不准确或印刷错误。信息将会定期更改； 这些更改将融汇到出版物的新版本中。IBM 随时都可能改进和／或更改本出版物中描述的产品和／或程序，恕不另行通知。
本信息中引用的任何非 IBM Web 站点仅为方便起见， 在任何情况下都不能作为对那些 Web 站点的认同。那些站点中的资料不是 IBM 产品的一部分， 使用那些 Web 站点请风险自负。
为了以下目的：（i）允许在独立创建的程序和其它程序 （包括本程序）之间进行信息交换（ii）允许对已经交换的信息进行相互使用， 而希望获取本程序有关信息的合法用户请与下列地址联系：
IBM Canada Ltd. Department 071只要遵照适当的条款和条件，包括某些情况下的有偿服务，都可得到这方面的信息。
本信息中说明的特许程序和所有可用的特许资料是由 IBM 按照 IBM 客户协议、IBM 国际 程序特许协议或我们之间任何等价协议的条款所提供的。
本文档描述由 IBM WebSphere Development Tools for AS/400 提供的通用编程接口及相关指导信息。
下列是国际商业机器公司在美国和／或其它国家的商标或注册商标：
|
|
|
|
InstallShield 是 InstallShield 公司的商标。
Intel 和 Pentium 是 Intel 公司的注册商标。
Java 及所有基于 Java 的商标是 Sun Microsystems 公司在美国和／或其它国家的商标或注册商标。
Netscape Navigator 是 Netscape Communications 公司的商标。
Lotus、Lotus Notes 和 Domino 是 Lotus 开发公司在美国和／或其它国家的商标。
ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、Windows NT、Win32、Win32s 和 Windows 徽标是 Microsoft 公司在美国和／或其它国家的商标或注册商标。
UNIX 是经由 The Open Group 独家特许的在美国和其它国家的注册商标。
其它公司、产品和服务的名称可能是其它公司的商标或服务标记。