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) 发行说明

发行版 V5.1 的组件

五个组件是：

1. WebFacing Tool，允许在使用 DDS 显示文件的 Web 传统程序上显示。 定制生成的 JSP 文件和 Java bean 替代 DDS 代码并使 Web 访问成为可能。
2. WebSphere Studio for iSeries 包含的向导可方便地用于创建 JavaBeans^TM 和 Java 小服务程序以及部署电子商务应用程序。
3. VisualAge for Java for iSeries 提供了一个功能强大的 Java 开发环境。 您可以任选安装 ET/400，它提供工具、向导、java bean 和 AS/400 Toolbox for Java 类。 这使得开发面向 iSeries 的 Java 客户机和服务器程序的作业更加容易。
4. “协作开发环境 (CODE)”可以编辑、编译和调试 RPG、COBOL、C 、C++、CL、DDS 和 Java（包括“CODE 设计器”，它是一种 WYSIWYG DDS 工具）。
5. VisualAge RPG 支持使用 Windows GUI 的应用程序、透明访问 iSeries 资源，以及生成 Java 应用程序和小应用程序。

WebSphere Studio 和 VisualAge for Java 之间的集成允许团队之间相互通信并一起工作以：

• 创建新的电子商务应用程序
• 从其它服务器移植现有的电子商务应用程序
• 对于 Web 启用现有的应用程序

另外，还使用以下方法简化了 WebSphere Development Tools for iSeries 的安装：

• 自动启动的菜单驱动的安装过程
• 一个“主机和服务器配置”向导，用于设置工作站和服务器之间的通信。

工作站需求

硬件需求

• 处理器 - Intel Pentium II（或推荐速度更快的可兼容处理器）
• 显示器 - SVGA 800x600 （推荐 1024x768）
• CD 或 DVD 驱动器
• 鼠标或其它指示设备
• 适当的通信适配器（工作站操作系统支持的）
• 内存和磁盘需求是：

  组件	内存		磁盘
  	最低配置	推荐配置	最低配置	推荐配置
  WebFacing Tool（第一版）	128 MB		200 MB
  WebSphere Studio for iSeries (V3.5)	96 MB	128 MB	385 MB	500 MB
  VisualAge for Java for iSeries (V3.5)	128 MB	192 MB	495 MB	550 MB
  CODE	64 MB	96 MB	235 MB
  VisualAge RPG	64 MB	96 MB	285 MB
  总计（用于产品）	128 MB	256 MB	1.2 GB	1.5 GB

如果选择仅安装需要的组件，那么系统需求会随之降低。

软件需求

迁移过程

VisualAge(R) for Java(TM)

Version 3.5.3

Enterprise Toolkit for AS/400(R)

发行说明

目录

1.0 简介
2.0 先决条件
3.0 限制和已知问题
     3.1 转换显示文件智能向导
     3.2 AS400eList Bean 性能
     3.3 DFU bean 中的代码生成
4.0 提示与技巧
      4.1 运行时文件
      4.2 部署具有 DFU bean 的 VCE 应用程序
      4.3 调试
5.0 AS/400 Java Web 站点
6.0 文档

1.0 简介

这些“发行说明”包含 VisualAge for Java Enterprise Toolkit for AS/400 的先决条件信息。另外，它们还包含了文档中未包括的任何产品限制和信息。

现在，AS/400 服务器是指 IBM eServer iSeries。 然而，对于这一版本的 VisualAge for Java，对服务器的所有引用都将用它以前的名称， "AS/400"。

2.0 先决条件

• 通常，我们建议您将最新的累积修正 (PTF) 装入 AS/400。
• Distributed Debugger 要求下列 PTF 应用于适当的发行版：
  

  OS/400  发行版	LPP 号	PTF 号
  V4R3M0	5769SS1*	SF49975*
  V4R3M0	5769999	MF19487
  V4R4M0	5769999	MF24806
  V4R4M0	5769SS1	SF54570
  V4R4M0	5769SS1	SF56682
  V4R4M0	5769SS1	SF56281
  V4R4M0	5769SS1	SF63732
  V4R5M0	5769SS1	SF63034

*注意： 该 PTF 不久将被另一个 PTF 替代。

有关 Distributed Debugger 的最新 PTF 信息，请参考 http://www-1.ibm.com/support/search.wss?rs=715&tc=SSZND2&dc=DA400。

• “转换显示文件智能向导”的编辑代码支持已得到改进。要利用它，需要应用适当的 PTF：
  

  OS/400 发行版	LPP 号	PTF 号
  V3R1M0	5763PW100	SF47783
  V3R2M0	5763PW100	SF47784
  V3R6M0	5716PW100	SF47785
  V3R7M0	5716PW100	SF47786
  V4R2M0	5769PW100	SF47774

• ET/400 的“运行”操作需要下列 PTF：
  

  OS/400 发行版	LPP 号	PTF 号
  V4R3M0	5769SS100*	SF49975*
  V4R4M0	5769SS100	SF63732
  V4R5M0	5769SS100	SF63034

*注意： 该 PTF 不久将被另一个 PTF 替代。

• 几个例子使用 ADTSLAB 库中的更新 AS/400 文件。要能够运行这些例子，需要将下面列出的适当 PTF 应用于 "Application Development ToolSet/400" 产品：
  

  OS/400 发行版	LPP 号	PTF 号
  V4R2M0	5769PW100	SF63545
  V4R4M0	5769PW100	SF63703

有关最新日期的 PTF，请参考：http://www.software.ibm.com/ad/as400/vajava/

• 对于任何 IBM(R) AS/400 Toolbox for Java(TM) PTF，请参考下列 Web 站点：http://www.as400.ibm.com/Toolbox
• 在连接到 AS/400 服务器之前，必须启动 AS/400 上的所有主机服务器（通过发出 STRHOSTSVR *ALL）并且必须启动服务器上的 TCP/IP（通过发出命令 STRTCPSVR *DDM）。

3.0 限制和已知问题

3.1 转换显示文件智能向导

在安装有早期版本的“IBM 个人通信”的系统上，当“转换显示文件智能向导”正在运行时，不可能启动“IBM 个人通信”。一旦“智能向导”完成运行，“IBM 个人通信”就可以启动。

该“智能向导”生成的 bean 可以在 VCE 中打开，并且在根据“源”进行“构造可视”之后保存。产生的 bean 的外观或行为可能不象原始的。

3.2 AS400eList Bean 性能

从 AS/400 服务器抽取列表时，如果该列表非常大或者如果选择二进制或数据文件， 数据转换可能需要较长时间才完成。要达到最佳性能，请按照下列建议执行：

1. 使用 OBJL0100 或 OBJL0200 格式，它允许在一个步骤内转换数据。
2. 如果选择 OBJL0300 格式或更高格式，请设法避免选择下面的二进制或日期字段，除非一定要选择。 如果选择二进制或日期字段，则必须对每一项个别执行字段属性的转换。 这会使整个进程变慢，特别对于较大的列表。

二进制字段
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

日期字段
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime() 

3.3 DFU bean 中的代码生成

当 FormManager、ListManager 或 RecordIOManager bean 生成代码时， 根据为条件类生成的方法数，进展指示符可能会出现好几次。

请不要尝试在代码生成期间关闭 bean 的“特性”窗口，因为这将使“可视组合编辑器”挂起。 对于 FormManager 或 ListManager，当代码生成完成时，recordIOManager 特性的值将随之发生更改，在那个时候可以关闭“特性”窗口。

4.0 提示与技巧

4.1 运行时文件

下列 .jar 和 .zip 文件可用于在 VisualAge for Java 之外运行例子和应用程序。 这些文件可在 'eab\runtime30' 目录中获得：

• JT400.JAR (AS/400 Toolbox for Java)
• JT400MRI.ZIP（AS/400 Toolbox for Java 类的转换文本）
• AS400UT.JAR（在软件包 com.ibm.ivj.et400.util 和
  com.ibm.ivj.et400.util.awt 中提供的类）

这些 Toolbox .jar 文件也可在 'eab\runtime30' 目录中找到：

• DATA400.JAR
• JT400PROXY.JAR
• JT400SERVLET.JAR
• JUI400.JAR
• UITOOLS.JAR
• UTIL400.JAR
• X4J400.JAR
• JT400ACCESS.ZIP
• UTILITIES.ZIP

请参考 http://www-1.ibm.com/servers/eserver/iseries/toolbox/faq.htm 中有关如何在 OS/400 上使用 AS/400 Toolbox for Java 的“常见问题解答”。

4.2 部署具有 DFU bean 的 VCE 应用程序

4.3 调试

Distributed Debugger 是与 VisualAge for Java 分开安装的。 要安装它，重新运行 VisualAge for Java 安装程序并选择安装 Distributed Debugger。

5.0 AS/400 Java Web 站点

要学习有关 IBM AS/400 Toolbox for Java 的更多知识，请访问下列 Web 站点：
http://www-1.ibm.com/servers/eserver/iseries/toolbox/index.html

6.0 文档

1. 自 Enterprise Toolkit for AS/400 (ET/400) 帮助经翻译以来，大部分都进行了更改。 如需最新帮助版本，请参考英文帮助。
2. 仅以英文编写文档的 ET/400 功能部件包括：
   • DFU bean：FormManager、ListManager 和 RecordIOManager。 DFU bean 是一组类，它们扩展代码支持以访问一个或多个 AS/400 数据库文件。 这些 bean 允许将 GUI 表单、表和列表映射到 AS/400 数据库并操纵（接收、添加、更新和删除）数据库记录。
   • 对象列表 bean：ET400List 和 AS400eList。“对象列表 bean”提供一种访问 AS/400 对象名的方法。这些 bean 允许设置列表特性，以选择期望的对象列表类型。 对象列表类型包括库列表、库中文件的列表或系统上用户标识的列表。 特性设置可用于访问许多不同类型的对象列表。
   • 新的 JFormatted bean（除了现有的 JFormatted bean）： JFormattedTable、JFormattedTableColumn、JFormattedTextFieldCellEditor、
     JFormattedComboBoxCellEditor 和 JFormattedLabelCellRenderer。
   • 新的“登录”对话框。
   • “编译和运行”对话框中的新选项。
   • “ET/400 守护进程”，可以启动它，以便在访问和使用“智能向导”、操作对话框或特性对话框时避免多次登录到同一 AS/400。
3. 自最后一次翻译 ET/400 帮助以来，添加了下列概念：
   • “数据文件实用程序 (DFU) bean”
   • “对象列表 bean”
4. 添加了下列任务：
   • “启动和停止 ET/400 守护进程”
   • “启动“Viewer 查看器”进行调试
5. 添加了下列引用：
   • "FormManager bean"
   • "ListManager bean"
   • "RecordIOManager bean"
   • “RecordIOManager 特性”
   • “程序调用注意事项”
   • "JFormattedTable bean"
   • "JFormattedTableColumn bean"
   • "JFormattedTextFieldCellEditor bean"
   • "JFormattedComboBoxCellEditor bean"
   • "JFormattedLabelCellRenderer bean"
   • "ET400List bean"
   • "AS400eList bean"
6. 已经添加任何关于新 DFU、“对象列表”和 JFormatted bean 的样本。
7. 下列概念发生了更改：
   • 在 "JFormatted beans" 中，已经添加有关 JFormattedTable、JFormattedTableColumn、JFormattedTextFieldCellEditor、JFormattedComboBoxCellEditor 和 JFormattedLabelCellRenderer bean 的信息。
8. 下列引用发生了更改：
   • “显示文件注意事项”
   • “显示文件关键字”
9. 自最后一次翻译 ET/400 帮助以来，除去了下列功能部件：
   • 不再有“创建子文件智能向导”， 并且所有对创建子文件或使用“创建子文件智能向导”的引用都已除去。
10. 自最后一次翻译 ET/400 帮助以来，除去了下列任务：
    • “创建子文件类”
11. 自最后一次翻译 ET/400 帮助以来，除去了下列引用：
    • “子文件的记录 I/O 注意事项”
12. 自最后一次翻译 ET/400 帮助以来，除去了下列样本：
    • “创建 Java 客户机／服务器应用程序”
    • “显示名称和电话号码列表”
    • “获取并显示子文件中的数据”
    • “填充子文件”
    • “隐藏子文件中的列”
    • “获取子文件中的记录”
    • “获取数据库文件的字段名和描述”
    • “设置子文件显示”
    • “添加、除去和插入子文件记录”
    • “设置子文件选择方式”
    • “AS/400 Toolbox for Java（演示）”