WebSphere^TM Development Tools for iSeries V5.1 自述文件

本文档包含了 WebSphere Development Tools for iSeries 产品的先决条件信息。另外，它还包含了文档中未包括的任何产品限制和信息。

安装注意事项文档包含所有安装注意事项和过程。这包括响应文件的使用和如何卸载，以及如何添加或除去产品组件。

发行说明文档描述产品组件、详细的系统需求和迁移方案，以及 VisualAge(R) for Java(TM) 版本 3.5.3 Enterprise Toolkit for AS/400(R)“发行说明”。

目录

• 文档更改
• 要点：如何选择性地安装或除去组件
• VisualAge(R) RPG (VARPG)
• WebSphere Studio for iSeries
• Distributed Debugger 和“对象级跟踪”
• 已知问题和替代办法
• JDK 注意事项
• VisualAge RPG GUI 设计器和 Java Plug-in
• VisualAge RPG IFS 名
• 问题帮助
• WebSphere Studio for iSeries：调用 Subfile DTC API
• 使用 Enterprise Toolkit for iSeries 中的样本
• CODE 中被截断的显示消息
• 浏览器问题
• Windows 2000 中的 Netscape 搜索
• Netscape Navigator 不一致性
• Internet Explorer 和 AS/400 Toolbox for Java 的帮助
• Distributed Debugger
• 对象级跟踪
• Norton AntiVirus
• 其它信息源
• 信息和更新的 Web 站点
• 至新闻组的链接
• 合法信息
• 如何查找“许可证协议”
• 通告
• 编程接口信息
• 商标和服务标记

文档更改

要添加丢失的组件，确保它的复选框是选中的。
要除去组件，可清除它的复选框。

VisualAge RPG (VARPG)

对于 V5.1，VARPG“GUI 设计器”帮助已得到更新，它包括以下各项的新帮助信息：

• SelPending 事件
• 使用消息标识的字符串“别名”
• “GUI 设计器”菜单的通信控制台选项

VARPG 出版物的 HTML 和 PDF 版本没有更新。 如所指的，它们包含下列错误：

• 对旧的“安装 VisualAge RPG 和 CODE/400 AS/400 版"，SC09-2446 出版物的引用
• 对先前产品名的引用
• 旧的“本发行版中的新增功能”部分。

DLL 和 LINKAGE 关键字不在下列“语言相关”帮助的关键字列表中：

• Definition of Prototype or Procedure Interface
• Prototype and Procedure Interface Keywords
• Definition of Prototyped Parameter
• Prototyped Parameter Keywords

下列“部件”属性已添加到 VisualAge RPG 中。

部件	属性	类型	描述	有效的 操作 代码
子文件	EditColumn	数字	返回正打开用于编辑的单元的列号。	getatr
	EditIndex	数字	返回正打开用于编辑的单元的行号。	getatr
	EditText	文本	返回正在编辑的单元的当前编辑文本。 如果没有打开任何单元，则返回空字符串。	getatr
	下列 Subfile 属性用于更改 Subfile 数据列的显示次序。 “数据列”指在设计时在特性笔记本的“字段列表”页面中指定的列的次序（用 ColNumber 属性指定“数据列”）。“查看列”指列的显示次序（用新的 ViewColumn 属性指定“查看列”）。 缺省情况下，数据列和查看列是相同的。如果用户移动一个列的显示位置，那么查看列也会发生更改。
	MapViewCol	数字	当设置为 1 时，这将按照属性 ColNumber 和 ViewColumn 重新排列列来显示子文件。 ColNumber 设置为要移动的数据列号，ViewColumn 设置为目的地列。注意，列是不可切换的。查看列可以根据需要向左或向右移动。	setatr
	ViewColumn	数字	设置为 MapViewCol 目的地列	setatr
	将数据列 2 映射到查看列 4 的代码例子		C Eval %Setatr('FRA000000B':'SUBF':'ColNumber')=2 C Eval %Setatr('FRA000000B':'SUBF':'ViewColumn')=4 C Eval %Setatr('FRA000000B':'SUBF':'MapViewCol')=1
	DColFRVCol	数字	返回对应于 ViewColumn 指定的列的数据列。	getatr
	获取查看列 4 的数据列的代码例子		C Eval %Setatr('WIN':'SBF':'ViewColumn')=4 C Eval DataCol4 = %Getatr('WIN':'SBF':'DCOLFRVCOL')
	VColFRDCol	数字	返回对应于 ColNumber 指定的列的查看列。	getatr
	获取数据列 4 的查看列的代码例子		C Eval %Setatr('WIN':'SBF':'ColNumber')=4 C Eval ViewCol4 = %Getatr('WIN':'SBF':'VCOLFRDCOL')
	SortAsc	数字	设置成升序排序子文件数据的数据列。	setatr
	将第 3 列升序排序的代码例子		C Eval %Setatr('WIN':'SBF':'SortAsc')=3
	SortDesc	数字	设置成降序排序子文件数据的数据列。	setatr
	将第 3 列降序排序的代码例子		C Eval %Setatr('WIN':'SBF':'SortDesc')=3
窗口	PrintAsIs	文本	打印图像和维护长宽比。	setatr
图像	PrintAsIs	文本	打印图像和维护长宽比。	setatr
静态文本	DropValue	数字	设置为 1，允许下降操作更改标签值。设置为 0，防止在下降操作之后更改值。 缺省值是 1。例如，静态文本部件的标签为“发送邮件”，指示用户将电子邮件地址拖放到该标签， 启动对话框发送电子邮件。将 DropValue 设置为 0，使该标签不更改为电子邮件地址。	setatr
笔记本页面	OnTop	数字	设置为 1，将指定页面更改到当前页面。 先前，为了使第 N 个页面成为当前页，用户将笔记本部件的 "PageNumber" 设置为 N。 因为运行时将从笔记本部件删除页面，所以当页面设置成不可见时这种方法会引起混淆。 （当页面再次设置成可见时，运行时会将它添加回笔记本中。）例如，如果执行下列代码： C EVAL %SetAtr('frame':'page3':'visible')=0 C EVAL %SetAtr('frame':'notebook':'PageNumber')=3 那么，当前页面是第 4 个页面（现在是第 3 个页面，因为最初的第 3 个页面已被删除）。 用户现在可以使用该行，将第 4 个页面设置成当前页： C EVAL %SetAtr('frame':'page4':'OnTop')=1 如果不使用索引号，那么哪个页面是当前页就更加清楚了。 GETATR 可用于获取笔记本页面的 OnTop 属性的值。如果页面是当前页，它将返回 1，否则，它将返回 0。	setatr getatr

 C     NBP_1         BEGACT    SELPENDING    FRA_1
 C                   if        %getatr('FRA_1':'cusno':'text')=*blank
 C     *msg0001      dsply                   rc1               9 0      Display an error message;
 C                   eval      RC='*NODEFAULT  '
 C                   else
 C                   eval      RC='*DEFAULT    '
 C                   endif
 C                   ENDACT    RC

WebSphere Studio for iSeries

有关先决条件信息和特定于 IBM WebSphere Studio for iSeries 的限制信息， 请参考 WebSphere Studio 自述文件和自述文件 3.5 FixPack 2 文件。 可以从 Windows 的“开始”菜单（选择“程序” > IBM WebSphere Development Tools for iSeries > IBM WebSphere Studio for iSeries）查看这些注意事项。

关于 BiDi 支持
现在，WebSphere Studio for iSeries 中的每个 DTC 都有一个 directionality 属性， 可指定文本的方向。此特性在控件特性的“常规”页面中。选项有：

LTR	文本方向从左到右
RTL	文本方向从右到左
NONE	文本方向是语言的缺省值

另外，对于“字段特性”页面中的每个字段，Subfile 还有 'directionality' 属性。 Subfile 的“常规”特性页面中的 'directionality' 属性定义如何排列列／字段。 “字段特性”页面中的 'directionality' 属性定义如何呈现字段的文本。

在“Web 交互”向导的“程序调用定义”页面中，添加了新的属性 bidistringtype。下面描述选项。

字符串类型	类型 文本	方向	对称 交换	数字 形状	文本 形状
缺省值	非 BiDi 数据的缺省字符串输入 (LTR)
ST4	可视	LTR	否	额定	形状
ST5	隐式	LTR	是	额定	额定
ST6	隐式	RTL	是	额定	额定
ST7	可视	上下文 LTR	否	额定	额定
ST8	可视	RTL	否	额定	形状
ST9	可视	RTL	是	额定	形状
ST10	隐式	上下文 LTR	是	额定	额定
ST11	隐式	上下文 LTR	是	额定	额定

注意：每个 CCSID 都有一个缺省 CDRA 字符串类型，它定义一组 BiDi 标志。 当在转换 BiDi 字符串时使用这些常数时，参数字符串类型应该始终是 ST5 (LTR)、ST6 (RTL)、ST10（上下文 LTR）或 ST11（上下文 RTL）之一。

关于两个新字段
“发布向导”的第一个页面有两上新字段，WAS 应用程序服务器名和 WAS 小服务程序引擎名。 它们有以前硬编码的缺省值 Wdt400AppServer 和 Wdt400ServletEngine。

关于字段标签更改
“发布向导”的第一个页面有一个标签为 WAS 节点名的字段， 它以前标签为 XML 节点名。当在发布向导中指定 WAS 节点名时， 使用您在管理控制台中看到的节点名。

Distributed Debugger 和“对象级跟踪”

有关先决条件信息和特定于 IBM Distributed Debugger 和“对象级跟踪”的限制信息， 请参考 IBM Distributed Debugger 和“对象级跟踪”发行说明。 可从 Windows 的“开始”菜单（选择“程序” > IBM WebSphere Development Tools for iSeries > IBM Distributed Debugger > 自述文件）查看这些发行说明。

已知问题和替代办法

JDK 注意事项
IBM's 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"。

如果计划使用 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 中）。 可以从 The Source for Java Technology Web 页面站点 java.sun.com 下载 J2SDK。

VisualAge RPG IFS 名
一直使用 IFS 目录名，其长度为 1 到 8 个字符且没有空格。

问题帮助
WebSphere Development Tools for iSeries 使用“VisualAge 帮助系统”， 经由 Web 浏览器传递它的联机帮助信息。 如果在启动、使用或搜索帮助时遇到问题，可从安装媒体获得问题解答文档。 将 CD 1 或 DVD 放入其驱动器并使用 Windows Explorer 转至文件 x:\install\help\helpyyy\helpTroubleshooting.htm， 其中，x 是盘符， yyy 是如下所示的语言代码：

语言	代码	语言	代码	语言	代码	语言	代码	语言	代码
德语	deu	英语	enu	西班牙语	esp	法语	fre	意大利语	ita
日语	jpn	韩语	kor	葡萄牙语 （巴西）	bra	中文 （简体）	chs	中文 （繁体）	cht

安装之后，疑难解答文档位于产品目录 install\help 中。

WebSphere Studio for iSeries：调用 Subfile DTC API
当用户主机程序需要调用 Websphere Studio for iSeries Subfile DTC API 时，需要主机服务程序 QGPL/QDTSSFL.SRVPGM。

对于安装

1. 安装步骤需要具有 *ALLOBJ 和 *SAVSYS 权限的主机标识。
2. 将 qdtssfl.sav savefile 从工作站传送到 iSeries 主机 QGPL 库:
   1. 打开命令提示窗口
   2. 更改到 qdtssdfl.sav 的源目录 x:\WDT400\Studio35\Affinity，其中，x:\WDT400 是产品的安装驱动器和目录
   3. 输入这些命令：
      ftp iSeriesHost
cd QGPL
binary
      put qdtssfl.sav QDTSSFL（假设已经创建 QDTSSFL SAVFILE， 例如，CRTSAVF FILE(QGPL/QDTSSFL)）
3. 将 QDTSSFL SRVPGM 从下面的 savefile 恢复到 QGPL 库：
   RSTOBJ OBJ(*ALL) SAVLIB(QGPL) DEV(*SAVF) SAVF(QGPL/QDTSSFL) RSTLIB(QGPL)

对于“开发”环境

1. 确保 QGPL 库在库列表中。
2. 将产生 Subfile DTC API 调用的用户程序绑定到 QGPL\QDTSSFL.SRVPGM

对于“运行时”环境，确保 QGPL 库在库列表中。

V5.1 之前的用户注意事项：

1. 所有绑定到 QSYS\QDTSSFL.SRVPGM 的现有程序都重新绑定到新的 QGPL\QDTSSFL.SRVPGM。
2. 在上面提到的所有现有程序都已绑定到新的 SRVPGM 之后， 除去 QSYS 库中 V5.1 之前的 QDTSSFL.SRVPGM 是安全的。

使用 Enterprise Toolkit for iSeries 中的样本
为了使用 ET/400 中提供的样本，必须恢复 ADTSLAB 库。对于 WebSphere Development Studio for iSeries V5R1，该库位于 QPDA 中。

CODE 中被截断的显示消息
“CODE 编辑器”中的长消息有时被截断。选择该消息并单击“帮助”或按 F1，查看完整消息。

浏览器问题

某些 WebSphere Development Tools 组件需要 Internet Explorer 作为浏览器（请参阅“发行说明”中的软件需求）。 下面描述了一些 Netscape 的问题。使用 Internet Explorer 作为缺省浏览器，可避免这些约束和问题。

Windows 2000 中的 Netscape 搜索
在一些 Windows 2000 机器上存在已知的 Netscape（版本 4.5 到 4.74，可能还有其它版本）问题， 可能会使搜索联机帮助时异常缓慢。当从这些版本的 Netscape 中提交表单时，Netscape 应用程序会使用机器上的绝大部分可用处理器周期， 直到接收到远程系统的响应。通常，执行远程搜索（如在 Web 站点上）时这不是问题。但是，因为产品的搜索程序正在您自己的本地机器上运行， 所以 Netscape 占用过多 CPU 时间的这一事实意味了只有很少 CPU 时间供搜索程序执行它的搜索。因此， 应该立即返回结果的搜索操作在 Windows 2000 上可能会花几分钟的时间。

每次提交搜索后通过选择另一个非 Netscape 窗口，可以避免这一性能问题。这通常会使 Netscape 在等待响应时停止使用过多的 CPU 周期， 而且搜索结果常会在执行这一窗口切换后立即显示。

或者，可以使用 Microsoft Internet Explorer 来查看帮助。使用这个浏览器不会发生性能问题。

Netscape Navigator 不一致性
Netscape Navigator 不符合 HTML 4 的标准。 由 WebSphere Studio for AS/400 生成并 由 Netscape Navigator 显示的 Web 页面有下表中描述的 DTC 问题。当使用 Internet Explorer 时，不会发生这些问题。

Internet Explorer 和 AS/400 Toolbox for Java 的帮助
一些 Toolbox for Java 帮助页面在 Internet Explorer 中显示时没有使用正确的字符集。每种语言的正确字符集是：

语言		字符集的名称
简体中文		简体中文 (GB2312)
繁体中文		繁体中文 (Big5)
韩国语		韩国语
日语		日语 (Shift-JIS)

1. 单击菜单栏中的“查看”，打开下拉列表。
2. 将光标放在“编码”上，打开字符集列表。
   1. 如果需要的字符集在该列表中，则单击它。
   2. 如果需要的字符集没有在该列表中，将光标放在“其他”上，打开更长的字符集列表。
   3. 单击所需的字符集。

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 查看器的执行。

Norton AntiVirus
如果在 Windows 98 机器上安装了 Norton AntiVirus， 并且 WebSphere Development Tools 中的任何部件 （如 Debugger 或“对象级跟踪”）都不工作，那么请禁用 Norton Antivirus 并重试。

其它信息源

请访问我们的万维网页面：

ibm.com/software/awdtools/wdt400/ 单击“支持”，然后选择 Support Downloads for Web Updates 下的一个项

也以从 IBM Software 主页 ibm.com/software/ 中的链接获得这些页面。

红皮书 REDP0503 提供了该产品的极好概述。转至 Redbooks 站点，单击左框架中的 Redpapers 并单击标题 "IBM WebSphere Development Tools for AS/400: An Introduction"。 您将看见该文档的摘要。单击“联机查看”，阅读它的 PDF 版。

使用以下的 newsgroup 并提出您的问题：

News 服务器：

建议的 newsgroup：

如何查找“许可证协议”

通告

本信息针对美国境内所提供的产品和服务。IBM 可能未在其它国家提供本文档中讨论的产品、 服务和功能。请咨询当地的 IBM 代理，以获取您所在地区目前提供的产品和服务的信息。 对 IBM 产品、程序或服务的任何引用并非表明或暗示只能使用 IBM 的产品、程序或服务。 凡是同等功能的产品、程序或服务，只要不侵犯 IBM 的知识产权，都可以代替。但是， 评估和验证任何非 IBM 产品、程序或服务则是用户的责任。

IBM 可能已经申请或正在申请与本文档有关的各项专利权。提供本文档并不表示允许您使用这些专利。 可以用书面形式将特许查询寄往：

以下这段不适用于英国或任何其它本地法律与这些条例不一致的国家： 国际商业机器公司“照原样”提供本出版物，并不保证任何形式的显式的或隐式的担保， 包括（但不限于）对不违法、适销性或适于特定目的之隐式担保。 一些国家不允许在特定交易中推卸明确或隐式的担保，因此本声明可能不适用于您。

本信息可能有技术方面的不准确或印刷错误。信息将会定期更改； 这些更改将融汇到出版物的新版本中。IBM 随时都可能改进和／或更改本出版物中描述的产品和／或程序，恕不另行通知。

本信息中引用的任何非 IBM Web 站点仅为方便起见， 在任何情况下都不能作为对那些 Web 站点的认同。那些站点中的资料不是 IBM 产品的一部分， 使用那些 Web 站点请风险自负。

为了以下目的：（i）允许在独立创建的程序和其它程序 （包括本程序）之间进行信息交换（ii）允许对已经交换的信息进行相互使用， 而希望获取本程序有关信息的合法用户请与下列地址联系：

只要遵照适当的条款和条件，包括某些情况下的有偿服务，都可得到这方面的信息。

本信息中说明的特许程序和所有可用的特许资料是由 IBM 按照 IBM 客户协议、IBM 国际 程序特许协议或我们之间任何等价协议的条款所提供的。

编程接口信息

本文档描述由 IBM WebSphere Development Tools for iSeries 提供的“通用编程接口”和“相关指导信息”。

商标和服务标记

下列是国际商业机器公司在美国和／或其它国家的商标或注册商标：

AIX AIXwindows AS/400 AS/400e

IBM Integrated Language Environment iSeries

Operating System/400 OS/400

RPG/400 VisualAge WebSphere

InstallShield 是 InstallShield 公司的商标。

Intel 和 Pentium 是 Intel 公司的注册商标。

Java 及所有基于 Java 的商标是 Sun 公司在美国和／或其它国家的商标或注册商标。

Netscape Navigator 是 Netscape Communications 公司的商标。

ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、Windows NT、Win32、Win32s 和 Windows 徽标是 Microsoft 公司在美国和／或其它国家的商标或注册商标。

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