5733XJ1 IBM i Access Client Solutions - GettingStarted

本文档内容最近一次更新日期:2021 年 4 月 29 日

0.5 QuickStartGuide

QuickStartGuide 包含有关部署产品的指示信息,这些指示信息适用于大多数运行 Windows、Mac 或 Linux 的用户。要为单用户或多用户 PC 安装本产品,请参阅 Documentation 文件夹中的 QuickStartGuide

本文档的其余部分提供了有关此产品、其他部署选项以及定制此产品的更多详细信息。

目录:

0.5 QuickStartGuide
1.0 简介
2.0 功能特性
3.0 先决条件
4.0 产品内容
5.0 安装
  5.1 更新现有安装
  5.2 设置所配置的更新位置
  5.3 可选 IBM i PTF
6.0 文件许可权
  6.1 文件许可权(Linux、Mac 和 AIX)
  6.2 文件许可权 (Windows)
7.0 启动产品
  7.1 启动产品
  7.2 使用脚本启动产品
  7.3 使用命令行启动产品
8.0 配置
  8.1 配置位置
9.0 高级主题
  9.1 更多命令行选项
  9.2 文件关联
  9.2.1 文件关联(对于 Windows)
  9.2.1.1 更改图标(对于 Windows 快捷方式)
  9.2.2 设置桌面图标(对于 Linux)
  9.2.2.1 文件关联(对于 Linux)
  9.2.3 文件关联(对于 Mac)
  9.2.3.1 创建文件关联(对于 Mac)
  9.2.3.2 更改图标(对于 Mac)
  9.3 更改配置位置
  9.4 其他部署选项
  9.4.1 自动导入配置设置
  9.4.2 本机 IBM i 部署
  9.5 定制包
  9.6 从 IBM i Access for Windows 进行迁移
  9.6.1 迁移系统配置
  9.6.2 迁移 5250 仿真
  9.6.3 迁移已保存的数据传输请求文件
  9.6.4 EHLLAPI
  9.6.5 Kerberos
  9.6.6 5250 兼容性
  9.7 密钥管理
  9.8 数据传输
  9.8.1 对 Excel 电子表格和 Calc 电子表格的数据传输支持
  9.8.2 对字符截断和数字溢出的数据传输支持
  9.8.3 数据传输工作表名称
  9.9 建立控制台与 IBM i 的连接
  9.10 其他字体
  9.11 使用 netrc 文件中的凭证
  9.12 集成文件系统 (IFS)
  9.12.1 IFS、QFileSvr.400 和安全性
  9.12.2 IFS 权限
  9.12.3 IFS 限制
  9.12.4 IFS 和独立 ASP
  9.12.5 IFS 性能
  9.13 安全 Shell (SSH) 终端
  9.13.1 SSH 终端先决条件
10.0 服务诊断
11.0 常见问题 (FAQ)
12.0 更新历史记录



1.0 简介

IBM i Access Client Solutions 是 IBM i Access 产品系列的最新成员。它提供了一个基于 Java 且独立于平台的接口,该接口在大多数支持 Java 的操作系统(其中包括 Linux、Mac 和 Windows)上运行。IBM i Access Client Solutions 将用于管理 IBM i 的最常用任务整合到一个经过简化的位置。

IBM i Access Client Solutions 与其他 IBM i Access Family 产品使用相同的 IBM i 主机服务器,并且需要相同的 IBM i Access Family 许可证 (5770XW1),以便使用 5250 仿真和数据传输功能。

并且,还提供了两个包含中间件的可选包,以便使用和开发面向 Windows 及 Linux 的客户机应用程序:
    IBM i Access Client Solutions - Windows 应用程序包
    IBM i Access Client Solutions - Linux 应用程序包

使用 IBM i 7.2 或更高版本并且具有当前权利的客户可以通过以下两种方法之一来获取 IBM i Access Client Solutions:

可从 Entitled Software Support (ESS) Web 站点获得可选的 Windows 和 Linux 应用程序包。

客户可以通过订购 5761-SS1 或 5770-SS1 刷新功能部件 6288 来获取介质。物理介质包含产品的可运行版本,该版本允许您直接从 CD 运行产品。物理介质还包含产品的 .zip 文件,可以将该文件复制和抽取到您选择的位置。IBM i Access Client Solutions 的物理介质不包含可选 Windows 和 Linux 应用程序包。

有关更多信息,请访问:
    IBM i Access Client Solutions

有关 IBM i Access Family 产品的最新信息,请访问:
    IBM i Access Family


2.0 功能特性

IBM i Access Client Solutions 具有下列功能特性:

可选的 Windows 应用程序包中包含以下内容:

可选的 Linux 应用程序包中包含以下内容:


3.0 先决条件

3.1 先决条件(工作站)

IBM i Access Client Solutions 可以在大多数支持 Java 8.0 或更高版本的操作系统(包括各种版本的 Linux、Mac 和 Windows)上运行。
注意:ACS 可能在 macOS 11.0 Big Sur 上找不到 Java 8。建议您安装 Java 11。

建议:
使 Java 版本保持在最新版本将确保您具有所有最新的修订和安全补丁。

检查系统上安装的 Java 版本的一种方法是显示支持输入命令的提示符(命令提示符、Shell 和终端等等),然后输入以下命令:
    java -version

以下输出指示已安装 V8.0:
    java version "1.8.0_191"
此示例中的 191 指的是更新级别。

以下是 Java 提供者的一些 Web 站点。请确保您使用的平台运行的是最新版本的 Java。
    https://adoptopenjdk.net/
    https://aws.amazon.com/corretto/
    http://openjdk.java.net/install
    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
    http://www.oracle.com/technetwork/java/javase/downloads/index.html

关于 Mac 的技术说明:
在 Mac 上安装 Java 时,请选择 JDK 而不是 JRE。JRE for Mac 只会为浏览器安装 Java。它不会为其他应用程序安装 Java。安装 JDK 将使 Java 可供其他应用程序(例如 IBM i Access Client Solutions)使用。

3.2 先决条件(连接到 IBM i)

IBM i Access Client Solutions 将连接至任何受支持的 IBM i 发行版。

IBM i Access Client Solutions 与其他 IBM i Access Family 产品使用相同的 IBM i 主机服务器,并且需要相同的 IBM i Access Family 许可证 (5770XW1),以便使用 5250 仿真和数据传输功能。

如果您使用 SSL 连接,请为您的发行版装入并应用以下 IBM i PTF:
    7.2 - SI55392、SI57320、MF60333 和 MF60334

如果您使用 Navigator for i,请为您的发行版装入并应用相应的 IBM i PTF:
    7.2 - 组 PTF SF99713 级别 30 或更高级别
    7.3 - 组 PTF SF99722 级别 17 或更高级别


4.0 产品内容

产品 .zip 文件中包含下列文件和目录:


acsbundle.jar       - 产品的可执行 JAR 文件
AcsConfig.properties - 此文件包含配置设置(在 acsbundle.jar 文件中也存在这些设置)

Mac_Application     - 此目录包含 Mac 的安装脚本

Linux_Application   - 此目录包含 Linux 的安装脚本

Windows_Application - 此目录包含 Windows 的安装脚本

Start_Programs      - 此目录包含特定于平台的二进制文件(可用来启动产品)。
    Linux_i386-32
    Linux_x86-64
    Mac_i386-32_x86-64
    Windows_i386-32
    Windows_x86-64

Documentation       - 这是包含文档的目录
    QuickStartGuide - 包含关于如何入门的信息
    GettingStarted  - 包含关于产品的详细信息
License             - 此目录包含使用条款和条件
Notices             - 此目录包含声明和信息
properties          - 此目录包含产品版本信息
  Sample_Scripts    - 此目录包含样本脚本,如果 Start_Programs 中的二进制文件不工作,那么可以使用这些脚本来启动产品。    Linux_Mac_Other - 此目录包含用于在任何具备 Perl 的平台上启动产品的 Perl 脚本。    Windows         - 此目录包含用于在 Windows 上启动的 JScript

Icons               - 此目录包含可以用作图标的文件

Fonts               - 此目录包含可能为 5250 仿真添加的其他等宽字体


5.0 安装

IBM i Access Client Solutions 包提供了若干安装选项,从非常简单的单用户安装到更高级的多用户安装,均包括在内。

在 Mac_Application、Linux_Application 和 Windows_Application 文件夹(请参阅 4.0 产品内容一节)中提供了安装脚本,这些脚本可用于各种安装选项。

要了解 Mac、Linux 和 Windows 上的单用户安装或者 Windows PC 上的多用户安装,请参阅 QuickStartGuide。QuickStartGuide 说明了如何使用提供的安装脚本来执行这些类型的简单安装。

如果您是计划对多个用户部署本产品的管理员,那么您应该阅读以下文章:
IBM i Access Client Solutions: Customization and deployment made easy
IBM i Access Client Solutions: Customization and deployment questions answered
这些文章说明了管理员如何使用安装脚本所支持的 /AdminConfig 选项在部署之前预先定制多用户安装。

对于希望以静默方式自动安装的管理员,请使用 /AdminConfig 参数对安装进行预配置。然后在实际安装期间使用 /Q 参数。例如:

    Windows_Application\install_acs_64.js /AdminConfig
    Windows_Application\install_acs_64.js /Q

除了以上选项以外,您还具有只将 .zip 文件解包到您选择的任何位置的选项。此位置可以是工作站 具有读权限(以访问这些文件)的任何位置。此位置包括本地硬盘驱动器、远程网络(共享)驱动器或便携介质(例如,CD 或 USB 闪存驱动器)。将 .zip 文件解包以完成安装。

技术说明:
某些归档实用程序不会保留所有已保存的文件属性。例如,在 Mac 和 Linux 平台上,选择 unzip 命令通常好于选择 jar 命令。有关更多信息,请参阅 6.0 文件许可权一节。

5.1 更新现有安装

将定期提供增强功能和修订。这些更新作为完整的产品安装来提供。当这些更新可用时,您应该更新现有安装版本。

对于维护自己的安装的用户:

选项 1:
要更新已使用安装脚本进行的现有安装,请抽取更高产品版本的内容。采用初始安装期间调用安装脚本的方式,从这个新版本调用安装脚本。这将更新产品文件,而不会更改现有配置。

选项 2:
如果您选择通过将 .zip 文件的内容抽取到您选择的某个位置来安装产品,而不使用安装脚本,那么要更新产品,您需要抽取更高产品版本的内容来覆盖现有版本。请记住,如果您对 AcsConfig.properties 进行了定制更改,那么应该保存 AcsConfig.properties 并复原其内容。

对于在由多个用户访问的中央位置维护产品版本的管理员:
抽取更高版本的内容来覆盖现有版本。如果您对 AcsConfig.properties 文件进行了定制更改,那么在抽取产品新版本的内容来覆盖现有版本之前,应该保存 AcsConfig.properties。在您已抽取产品新版本的内容,并且已复原 AcsConfig.properties 之后,用户需要采用下列其中一个选项:

选项 1:
如果用户直接从远程位置运行,那么无需进一步操作。让他们重新启动产品,以使新的更新生效。

选项 2:
采用与初始安装相同的方式运行安装脚本,以更新本地安装。

选项 3:
如果您在 5.2 节已设置 IBM i 更新位置,那么让用户从主 GUI 中选择“帮助”->“检查更新”。应该会出现一个面板,告诉他们有可用的更新。让他们选择安装更新。还可以使用 INSTALLUPDATES 插件从命令行运行此选项。

完成上述相应步骤之后,重新启动该产品。可以使用主 GUI 中的“帮助”->“关于”来验证是否已应用更新。

5.2 设置 IBM i 更新位置

管理员可以使用 IBM i 系统作为他们进行安装和应用更新的中央位置。无论您最初如何将产品部署到用户,都可以在 IBM i 上使用中央位置,以便用户可以通过单击按钮来应用更新。步骤如下:

设置 com.ibm.iaccess.CheckUpdateSystem 属性会导致“帮助”->“检查更新”的行为不同。将在上述 IBM i 位置检查是否有已更新的产品文件,而不是在外部 Web 位置检查是否有已更新的版本。当所需要的任何产品文件的时间戳记更改时,将检测更新。该时间戳记将显示在“帮助”->“检查更新”面板上,并带有用于安装更新的选项。

用户需要有效凭证以访问对 com.ibm.iaccess.CheckUpdateSystem 指定的系统。如果尚未从先前与此系统的连接高速缓存他们的凭证,那么将提示他们提供有效凭证。未能提供有效凭证将导致检测不到更新。

对于配置了 IBM i 更新位置,并且在“编辑”->“首选项”下选择了“有更新可用时通知”选项的用户,系统将不会提示提供凭证。仅当他们自上次登录其 PC 以来已成功连接至 com.ibm.iaccess.CheckUpdateSystem 时,才会接收到有可用更新的通知。

注意:

  1. 仅当使用 1.1.8.3 或更高版本时,才启用此功能。
    从 V1.1.8.6 开始,还可以从主 GUI 中的“编辑”->“首选项”处启用此功能。请参阅“常规”选项卡上的用于检查更新的系统。如果通过 AcsConfig.properties 中的属性设置该系统,那么该系统将显示在此面板上,并且将禁用用来选择其他系统的选项。
  2. 如果未设置 com.ibm.iaccess.CheckUpdatePath,那么假定缺省位置为:
            /QIBM/ProdData/Access/ACS/Base
    注意:IBM 现在具有特定于发行版的 PTF,这些 PTF 会将产品 .zip 文件 (IBMiAccess_v1r1.zip) 的内容抽取到此位置(请参阅 5.3 节)。管理员可以自己将 IBMiAccess_v1r1.zip 抽取到此位置,只要他们知道如果应用了 PTF,那么就会更新此位置。
  3. 在初始部署期间,AcsConfig.properties 文件与 acsbundle.jar 一起传播到本地 PC,但是在产品更新期间不会更新。要利用此功能,您将需要先在用户的 PC 上更新 AcsConfig.properties,然后再选择“帮助”->“检查更新”。

负责维护 acsbundle.jar 中的定制 AcsConfig.properties 文件的管理员应特别注意:
此功能会在所指定位置下载 IBM i 上存在的 acsbundle.jar。在更新期间,无需进行特殊处理来维护 AcsConfig.properties 文件的定制版本。如果您先前在 acsbundle.jar 中定制了 AcsConfig.properties 文件,那么将需要确保新版本的 acsbundle.jar 包含所需要的定制,然后才可供下载。

5.3 可选 IBM i PTF

对于希望在 IBM i 上维护集中位置以供用户安装和更新产品的管理员,提供了特定于发行版的 PTF,将在以下位置提供已抽取的 IBMiAccess_v1r1.zip 内容:
        /QIBM/ProdData/Access/ACS/Base

1.1.8.7 的 PTF 为:

        V7R4M0  SI76178
        V7R3M0  SI76179
        V7R2M0  SI76180
每次进行产品更新时,都会取代这些 PTF,它们通常在产品更新可用后的两周内可用。

6.0 文件许可权

第 7.0 节 启动产品描述了几种启动 IBM i Access Client Solutions 的不同方法。如果您使用所提供的其中一个二进制文件或脚本来启动产品,那么需要确保其文件许可权已启用执行许可权。将 .zip 文件解包时分配的文件许可权由多种因素确定,其中包括操作系统、用来将 .zip 文件解包的归档实用程序以及用户的权限等。

如果在使用所提供的其中一个二进制文件或脚本时遇到问题,请检查文件许可权。下列各节描述了用于检查文件许可权的一些方法。

6.1 文件许可权(Linux、Mac 和 AIX)

对于类 UNIX 操作系统,可以从 Shell 或终端提示符使用以下命令来检查文件的许可权:

    ls -l <file>   			

要更改文件的许可权,您可以使用以下命令:

    chmod <permission> <file>	

例如,
要为所有用户添加读许可权和执行许可权,请使用以下命令:
    chmod a+rx <file>
要向文件所有者授予读取/写入/执行许可权,而对于其他所有用户仅授予读取/执行许可权,请使用以下命令:
    chmod 755 <file>

通过因特网很容易获得有关 ls 和 chmod 命令的更多帮助。

6.2 文件许可权 (Windows)

对于 Windows,在使用 Windows 资源管理器来查看文件时,请右键单击该文件,然后选择“属性”。“安全”选项卡应包含文件许可权。 请确保您具有读取和执行许可权。

在最新版本的 Windows 中,您还可以使用 icacls 命令来查看和更改文件的许可权。


7.0 启动产品

您可以通过多种方法来启动 IBM i Access Client Solutions。如果使用了安装脚本来安装产品,那么可以在 QuickStartGuide 中找到最容易的产品启动方式。

如果未使用安装脚本来安装产品,那么本节的其余部分将描述产品的备用启动方式。由于可以使用各种方法来安装 Java 以及将 Java 安装在各种位置,因此,某些方法可能要求执行其他配置。如果下面的其中一个方法不起作用,请尝试使用另外的方法。在某些情况下,提供了更多指导。

按下面所述使用二进制文件或脚本时,该二进制文件或脚本必须位于 .zip 文件所包含的同一目录结构中。为了方便起见,还可将用于您的平台的二进制文件和/或脚本复制/移动到 acsbundle.jar 所在的目录。

7.1 启动产品

要从文件查看器(例如,Windows 资源管理器和 Mac OS X Finder 等等)中使用特定于平台的二进制文件来启动产品,请在 Start_Programs 中找到标识了您使用的操作系统及硬件体系结构的子目录。

找到您的操作系统识别的二进制文件。然后双击此文件以启动产品。您还可以从命令提示符、终端或 Shell 使用此二进制文件来启动产品。

如果发生了以下错误:
    “装入 Java 模块时发生错误。”
那么 IBM i Access Client Solutions 在它可以识别的位置找不到 Java 安装。您可以尝试下面各节中的其中一种方法:
    7.1.1 启动产品 - 其他选项
    7.2 使用脚本启动产品
    7.3 使用命令行启动产品

7.1.1 启动产品 - 其他选项

尝试使用平台的二进制文件时,您还可以尝试下列其中一种方法。这些方法允许您确定应使用哪个 Java 运行时环境 (JRE) 来启动产品。请参阅 7.1.2 查找 Java 主路径一节,以了解如何在工作站上找到 Java 主路径。这些附加方法仅在 Linux 和 Windows 平台上受支持:

7.1.2 查找 Java 主路径

如果您可以使用下列某一节中的其中一种方法来启动产品:
    7.2 使用脚本启动产品,或者
    7.3 使用命令行启动产品
那么您可以从 IBM i Access Client Solutions 主 GUI 中确定工作站上的 Java 主路径。在菜单栏中,选择
    “帮助”->“关于”
    java.home 路径将显示在此面板上。

java.home 属性包含工作站的 Java 主路径的位置。这是您在设置 JAVA_HOME 环境变量或者在命令中使用 -vm 选项时将需要指定的路径。

7.1.2.1 查找 Java 主路径 (Windows)

在 Windows 平台上,请搜索 java.exe。Java 二进制文件通常位于 Java 主路径下的 bin 或 jre/bin 子目录中。设置 JAVA_HOME 环境变量或者在命令中使用 -vm 选项时可以使用 Java 主路径。

7.1.2.2 查找 Java 主路径 (Linux)

在 Linux 上,可以使用“which”命令:

    which java
此命令将提供 java 命令的路径或者指向该命令的符号链接。

解析任何符号链接,直到您最终找到 java 命令实际的二进制文件。您可以使用带有 -l 选项的 ls 命令来解析符号链接:

    ls -l <file>
Java 二进制文件通常位于 Java 主路径下的 bin 或 jre/bin 子目录中。设置 JAVA_HOME 环境变量或者在命令中使用 -vm 选项时可以使用 Java 主路径。

7.2 使用脚本启动产品

Documentation 目录中具有 Sample_Scripts 目录。

启动产品的首选方式是使用 Start_Programs 中提供的特定于平台的二进制文件。仅当特定于平台的二进制文件不工作时,才应该使用 Sample_Scripts 中的脚本。

要使用一个提供的脚本从文件系统浏览器(例如 Windows 资源管理器和 Mac OS X Finder 等)启动产品,请在 Sample_Scripts 子目录中找到与操作系统兼容的脚本。

缺省情况下,大多数非基于 Windows 的操作系统都有 perl 可用。Sample_Scripts/Linux_Mac_Other 目录包含一个 perl 脚本(有三个不同的文件扩展名),在有 perl 可用的任何平台上都可以使用此脚本来启动产品。选择具有操作系统将识别为 perl 脚本的文件扩展名的文件。

缺省情况下,基于 Windows 的操作系统有 JScript 可用。Sample_Script/Windows 目录包含可以用来在 Windows 操作系统上启动产品的 JScript。

使用特定于平台的方法来浏览文件系统(例如,Windows 资源管理器和 Mac OS X Finder 等),找到操作系统识别的脚本。然后,双击此脚本以启动产品。您还可以从命令提示符、终端或 Shell 使用此脚本来启动产品。

7.3 使用命令行启动产品

您还可以从任何可以输入命令的位置(命令提示符、终端和 Shell 等等)使用命令行来启动产品。

    java -Xmx1024m -jar <path>/acsbundle.jar
其中 <path> 是产品的可执行 JAR 文件的位置

例如:
    java -Xmx1024m -jar V:/some_location/acsbundle.jar
或者
    <java_path>java -jar V:/some_location/acsbundle.jar
其中 <java_path> 是 JDK 8.0 或更高版本的 java 命令所在的位置。

请参阅 7.1.2 查找 Java 主路径一节,以确定 java 命令的完整路径。

您还可以从命令行使用任何程序或脚本。例如:

    /Product/Location/Start_Programs/Linux_x86-64/acslaunch_linux-64
    /Product/Location/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
    C:\Product\Location\Start_Programs\Windows_x86-64\acslaunch_win-64.exe

技术说明:
在大多数平台上,Java 虚拟机堆空间在缺省情况下的最大大小太小,导致无法利用 IBM i Access Client Solutions 产品中的多项功能。 建议将一千兆字节的最大堆大小 (-Xmx1024m) 作为最小大小。指定小于一千兆字节的大小或者使用缺省堆大小可能会产生 OutOfMemoryException。


8.0 配置

请针对您要使用或管理的每个 IBM i 系统添加一项系统配置。要添加系统配置,请从“管理任务”中选择“系统配置”。然后选择“新建”。在“常规”选项卡上输入系统名称。要开始执行操作,系统名称是执行“常规”任务时需要的所有信息。

完成之后,选择“确定”以保存您为此系统输入的信息;如果您想要将其他系统添加至配置,请选择“保存/新建”。

要配置系统以建立 TLS/SSL 连接,请参阅配置安全连接

您随时都可以使用“常规”、“连接”或“控制台”选项卡将新系统添加至配置或者更新现有配置。

对于控制台任务,需要其他配置。控制台配置会自动与您在“常规”选项卡上输入的系统名称相关联。要输入系统的控制台配置,请从“管理任务”中选择“系统配置”。选择“新建”或“编辑”。然后选择“控制台”选项卡。“5250 控制台”任务需要一个已配置的 LAN 控制台或者已配置的 HMC 控制台。如果不存在已配置的 LAN 或 HMC 控制台,请参阅 9.9 建立控制台与 IBM i 的连接一节。

“硬件管理界面”任务需要一个已配置的硬件管理界面。您最多可以输入六个硬件管理界面配置。

完成之后,在“系统配置”面板上选择“关闭”。

使用 IBM i Access Client Solutions 主面板上的“系统”下拉框来选择一个系统。所有控制台任务会自动将所选系统(在“常规”选项卡上输入)与控制台配置(在“控制台”选项卡上输入)相关联。

您现在可为所选系统选择一项任务。如果您选择一项在“控制台配置”选项卡上未输入相应信息的控制台任务,那么将显示一条错误消息。

8.1 配置位置

缺省情况下,每个用户都使用自己的唯一位置来存放他们的配置。将按照一种依赖于平台的方式来确定配置根目录。配置目录在初始启动期间创建。要查看配置目录的位置,请完成下列步骤:
    启动产品(请参阅 7.0 启动产品一节)
    “编辑”->“首选项”
    选择“本地设置”选项卡
    配置根目录

在产品运行时,无法更改配置位置。要更改配置所在的位置,请参阅 9.3 更改配置位置一节。


9.0 高级主题

9.1 更多命令行选项

在主 GUI 中提供的许多功能也可以从命令行使用。可以通过向下面这一节中显示的任何命令行选项提供适当的参数来调用这些功能:
7.3 使用命令行启动产品

例如:

    Start_Programs\Windows_x86-64\acslaunch_win-64.exe parm1 parm2 ...

下列各节仅显示了附加参数:

9.1.1 Backup

/PLUGIN=backup  [/file=<filename>]
    <filename> 是要创建的文件的名称

这会将当前配置保存到所指定的文件。可以将最终获得的文件用作同一工作站或另一工作站(不考虑操作系统)上的“复原”命令行选项的输入。

要保存的配置所在的位置由以下属性确定:

    com.ibm.iaccess.AcsBaseDirectory
...此属性位于 AcsConfig.properties 文件中。

此功能相当于主 GUI 中的“文件 -> 导出配置”。

9.1.2 Restore

/PLUGIN=restore /file=<filename>
    <filename> 是备份所创建的文件的位置
这将从所指定的文件复原已保存的配置。任何不在所指定文件中的现有配置都将丢失。

复原后的配置所在的位置由以下属性确定:

    com.ibm.iaccess.AcsBaseDirectory
...此属性位于 AcsConfig.properties 文件中。

此功能相当于主 GUI 中的“文件 -> 导入配置”。

注意:
要避免导入系统配置的“连接”选项卡上指定的缺省用户名,请将以下属性放置在 AcsConfig.properties 文件中。

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.1.3 Certdl

/PLUGIN=certdl  /SYSTEM=<system>
从指定的 IBM i 系统下载认证中心 (CA) 并将其存储在用户的本地信任库中。使用 SSL 进行服务器认证时需要这样做。

9.1.4 Cfg

/PLUGIN=cfg     /GUI

    /GUI        - 此选项将启动系统配置 GUI
                  这相当于从主 GUI 启动系统配置。
                  注意:如果在 AcsConfig.properties 中设置 com.ibm.iaccess.CfgActionsRestricted=true,
                  那么将在“系统配置”面板上隐藏“新建”/“编辑”/“复制”/“删除”按钮。

/PLUGIN=cfg     /LIST

    /LIST       - 列示已配置的系统及其连接选项


/PLUGIN=cfg     /SYSTEM=<system> [/ipaddr=<frequency>] [/userid=<userid>]
                                 [/ssl=<switch>]
                                 [/5250path=<path>]
                                 [/del]  [/r]

    /SYSTEM     - 系统的名称
    /ipaddr     - 请求进行连接时,此值确定是否执行 IP 地址查找。有效频率如下所示:
                      ALWAYS - 每次连接时都查找 IP 地址
                      HOURLY、DAILY 和 WEEKLY - 如果自从最近一次查找 IP 地址以来已经过指定的时间长度,那么查找 IP 地址
                      IP 地址 - 如果指定了 IP 地址,那么假定查找频率为 NEVER
    /userid     - 用户的用户标识,还可以设置为下列值:
                      *SHARE        - 使用此选项来提示输入一次将由系统共享的
                                      登录凭证
                      *PROMPTALWAYS - 对于每次连接,至少提示输入一次
                      *KERBEROS     - 使用 Kerberos 主体名称,不提示输入
    /ssl        - 开关为 0 表示关闭 SSL 方式,开关为 1 表示开启 SSL 方式
    /5250path   - 5250 仿真概要文件的路径
                  /5250path 可通过 5250 会话管理器中的“文件”->“切换目录...”
                  进行设置
    /del 删除现有配置
    /r   替换现有配置
这允许从命令行设置各种配置选项。也可以从主 GUI 中使用“系统配置”来设置这些选项。

9.1.5 Dump

/PLUGIN=dump  [/<options>]
请求产品中所有正在运行的进程以转储它们的线程。此信息由 IBM 服务中心用来提供问题支持。

在主 GUI 中,可以从下列位置访问所生成的日志:
    “编辑”->“首选项”
    “本地设置”选项卡
    转储目录

如果未指定任何选项,那么此功能相当于主 GUI 中的以下功能:
    工具 -> 生成服务日志

有效选项为:

    /heapdump - 执行以上功能并转储 JVM 堆

9.1.6 Medic

/PLUGIN=medic
将现有日志和线程转储打包为一个 .zip 文件,可以将此文件发送至 IBM 以便为您提供服务。

产生的 .zip 文件可以从主 GUI 中通过以下方式进行访问:
    编辑 -> 首选项
    “本地设置”选项卡
    服务目录
此功能相当于主 GUI 中的“工具”->“将服务日志打包”。

9.1.7 Log

/PLUGIN=log  /LEVEL=<Level>
                <Level> 是下列其中一项:
                OFF、SEVERE、WARNING、INFO、CONFIG、FINE 和 FINEST
此插件使用户能够从命令行切换其日志记录级别。

在主 GUI 中,还可以从下列位置设置日志记录级别:
    “编辑”->“首选项”
    “常规”选项卡
    日志记录级别

9.1.8 Logon

/PLUGIN=logon    /SYSTEM=<system> [/USERID=<userid>] [/PASSWORD=<password>] [/AUTH] [/C] [/GUI=<1|0>]

    /SYSTEM   - 系统的名称
    /USERID   - 用户标识
    /PASSWORD - 与用户标识相关联的密码
    /AUTH     - 尝试使用指定的登录凭证来连接至系统
                并且仅在成功时对这些凭证进行高速缓存
    /C        - 清除高速缓存
    /GUI      - 是否可以使用图形用户界面
此命令将对用户标识和密码进行高速缓存,可以用来阻止发出密码提示。

9.1.9 props

/PLUGIN=props
显示从主 GUI 中选择“编辑”->“首选项”时显示的 GUI 面板。

9.1.10 Maint

/PLUGIN=maint [/<options>]

有效选项为:
    /killdaemon     - 结束守护程序线程。
                      相当于从主 GUI 中选择“工具”->“重置以进行维护”。
                      如果在 AcsConfig.properties 中设置 com.ibm.iaccess.ResetForMaintenanceOnExit=true,
                      那么当 Access Client Solutions 存在时,将调用 /killdaemon。
    /clearpwcaches  - 清除所有已高速缓存的密码
    /clearjarcache  - 清除产品 JAR 高速缓存
    /clearlogs      - 清除从主 GUI 中选择“编辑”->“首选项”后在“本地设置”选项卡上设置的日志目录
    /cleardumps     - 清除从主 GUI 中选择“编辑”->“首选项”后在“本地设置”选项卡上设置的转储目录
    /clearsvcdir    - 清除从主 GUI 中选择“编辑”->“首选项”后在“本地设置”选项卡上设置的服务目录
    /clearsettings  - 清除当前用户的所有设置
如果未指定任何选项,那么不会执行任何操作。

9.1.11 Ping

/PLUGIN=ping /SYSTEM=<system> [</options>]
    选项包括:
        /SSL=<1|0>        开启或关闭 SSL
        /ACCEPTALLCERTS=<1|0> (使用 SSL 时)是否将所有 SSL 证书自动添加到
                          可信集合。
        /SERVERAUTH=<1|0> 开启或关闭 SSL 服务器认证(缺省值为“关”)。如果不是在测试 SSL,那么将忽略此选项。        /GUI=<1|0>        开启或关闭 GUI 窗口(如果是从命令行启动,那么缺省值为“关”)
        /PORTS=<port1,port2> 要测试的一列端口(以逗号分隔)。它可以是数字或服务名称(例如,/PORTS=as-signon,as-sts)。如果未指定此选项,那么将测试一组缺省端口。                指定 .CONSOLE 将检查特定于控制台的端口的列表。
        /TIMEOUT=<seconds>   指定超时值(以秒计)。
此插件通过打开与相应端口的连接来检查与 IBM i 的连接。如果验证 SSL 连接,那么会尝试进行 SSL 握手。如果从主 GUI 启动此插件,或者通过 /GUI=1 来调用此插件,那么此插件会显示一个对话框。如果是从命令行且未使用 /GUI=1 的情况下启动此插件,那么会将输出发送至控制台。

对于非 SSL,将检查下列服务和端口:

    sshd            22
    telnet          23
    drda           446
    as-svrmap      449
    as-nav        2004
    as-central    8470
    as-database   8471
    as-dtaq       8472
    as-file       8473
    as-netprt     8474
    as-rmtcmd     8475
    as-signon     8476

对于 SSL,将检查下列服务和端口:

    sshd            22
    telnet-ssl     992
    ddm-ssl        448
    as-svrmap      449
    as-nav        2005
    as-central-s  9470
    as-database-s 9471
    as-dtaq-s     9472
    as-file-s     9473
    as-netprt-s   9474
    as-rmtcmd-s   9475
    as-signon-s   9476
 

可以通过从主 GUI 中执行以下操作来启动此功能:
    系统配置
    选择系统,然后选择“编辑”
    “常规”选项卡
    验证连接

9.1.12 Sm

/PLUGIN=sm
此插件将启动 5250 会话管理器 GUI。

此功能相当于主 GUI 中的“5250 会话管理器”。

9.1.13 5250

/PLUGIN=5250 /SYSTEM=<system> [/<options>]

此插件将对指定的系统启动 5250 仿真器。此功能相当于主 GUI 中的“5250 仿真器”。
有效选项为:
    /id=<A-Z>                    - 短会话标识
    /name=<name>                 - 会话名称
    /wsid=<identifier>           - 工作站标识
    /wide=<1|0|true|false>       - 使用宽屏幕大小 (27x132)
    /fullscreen<1|0|true|false>  - 使用整个屏幕
    /nosave=<1|0|true|false>     - 退出时不保存设置
    /prompt=<1|0|true|false>     - 强制显示配置对话框
    /port=<port>                 - 端口号
    /ssl=<1|0|true|false>        - 使用安全套接字进行连接
    /sso=<1|0|true|false>        - 绕过登录屏幕
    /kerberos                    - 使用 Kerberos
    /width=<width>               - 仿真器窗口的初始宽度
    /height=<height>             - 仿真器窗口的初始高度
    /xpos=<xpos>                 - 仿真器窗口左上角的初始 X 坐标位置
    /ypos=<ypos>                 - 仿真器窗口左上角的初始 Y 坐标位置
    /watermark                   - 在屏幕上以水印形式显示系统名称
    /watermark=<text>            - 在屏幕上以水印形式显示所提供的文本
    

9.1.14 DTGui

/PLUGIN=dtgui

此插件将启动主 GUI 以进行数据传输。
此功能相当于主 GUI 中的数据传输。

9.1.15 Download

/PLUGIN=download [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - 连接至目标系统时要使用的用户标识
    <filename>- 以前某次执行数据传输下载时创建的具有 .dtfx 扩展名的文件。
此插件使用户能够运行先前保存的数据传输下载。

还可从主 GUI 中通过选择数据传输来进行数据传输。

9.1.16 上载

/PLUGIN=upload   [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - 连接至目标系统时要使用的用户标识
    <filename>- 最近一次执行数据传输上载时创建的具有 .dttx 扩展名的文件。
此插件使用户能够运行先前保存的数据传输上载。

还可从主 GUI 中通过选择数据传输来进行数据传输。

9.1.17 CLDownload

/PLUGIN=cldownload /system=<system>
                          [/userid=<userid>]
                          {/hostfile=<library/filename> | /sql="statement"}
                          {/clientfile=<path><filename>.<extension> | /display}
                          [/<options>]

    /userid   - 连接至目标系统时要使用的用户标识
    /hostfile   - IBM i 系统上用于下载的源代码库和文件,例如,/hostfile=QIWS/QCUSTCDT
    /sql        - 指定 SQL 语句
                  例如,/sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
    /clientfile - 用于下载的目标文件位置。                  此文件的格式将由指定的扩展名(例如,.csv、.ods、.xlsx 或 .xlsx)确定
                  如果未指定文件扩展名,或者所指定扩展名的类型不受支持,那么会将数据的格式设为 .csv 文件
    /display    - 将输出写至终端
    
有效选项为:
       /colheadings=<1/0> - 将列标题作为第一行。指定了此选项时,列名将成为标题。
       /usecollabels      - 使用列标签作为标题。
    
此插件使用户能够从命令行运行整个文件的简单下载。

9.1.18 控制台

/PLUGIN=console /SYSTEM=<system>
此插件将对指定的系统启动 5250 控制台。

此功能相当于主 GUI 中的 5250 控制台。

9.1.19 VCP

/PLUGIN=vcp /SYSTEM=<system>
此插件将对指定的系统启动虚拟控制面板。

此功能相当于主 GUI 中的虚拟控制面板。

9.1.20 L1C

/PLUGIN=l1c /SYSTEM=<system>
此插件使用指定的系统和端口 2001 对 IBM Navigator for i 启动浏览器。

此功能相当于主 GUI 中的 Navigator for i。

9.1.21 SPLF

/PLUGIN=splf /SYSTEM=<system>
此插件将显示用于从 IBM i 查看和下载假脱机文件的打印机输出 GUI。

此功能相当于主 GUI 中的打印机输出。

9.1.22 KEYMAN

/PLUGIN=keyman
此插件将显示“密钥管理”工具。

此功能相当于主 GUI 中的“工具”->“密钥管理”。

9.1.23 RMTCMD

/PLUGIN=rmtcmd /SYSTEM=<system>
                  {/CMD="<CL command>" | file=<file_name>}
                  [/noprompt=<1|0>]
                  [/immed=<0|1>]

    /cmd="<CL command>"  - 要运行的命令。使用引号可以避免空格拆分命令。
    /file=<file_name>    - 指定包含多个命令的输入文件。其中每个命令都应该独占一行并且不含引号。
    /noprompt=<1|0>      - 指定输入文件时,此选项指定在继续操作前是否忽略结果和所有提示。
    /immed=<0|1>         - 读取每个命令时就发送该命令。
此插件将 CL 命令发送到指定的系统。

此功能仅可从命令行中使用。

9.1.24 PWCHANGE

/PLUGIN=pwchange /SYSTEMS=<system,system,system,...>
此插件将更改所指定系统上的密码。它提示用户提供用户标识、旧密码和新密码。

另外,在主 GUI 中,还可以通过选择“编辑”->“首选项”并选择“密码”选项卡使用此功能

9.1.25 MIGRATE

/PLUGIN=migrate /<option> /SYSTEM=<system>

<system> 可以设置为一个系统名称,也可以设置为 *ALL 以指示所有系统。
有效选项为:
    /IMPORT - 将旧 Windows 配置中的一个(或所有)系统配置复制到 IBM i Access Client Solutions。    /EXPORT - 将一个(或所有)系统配置从 IBM i Access Client Solutions
              复制到旧 Windows 配置中。    /DELETE - 从旧 Windows 配置中删除一个(或所有)系统配置。
此插件使您能够在 IBM i Access Client Solutions 与 IBM i Access for Windows 所支持的旧 Windows 配置之间复制系统配置。

另外,在主 GUI 中,还可以通过选择“文件”->“复制连接”使用此功能

9.1.26 RESTRICT

注意:此插件只能供具有 root 用户权限或管理员权限的用户使用。
/PLUGIN=restrict /<options>

有效选项为:
     /restrict=<func1,func2,func3>   在此工作站上限制使用给定功能。

     /unrestrict=<func1,func2,func3> 在此工作站上允许使用给定功能。

     /list                           列示此工作站上允许使用或受限制的功能。
     /export=<file>                  将限制导出至文件扩展名为 .acsr 的所指定文件。
     /import=<file>.acsr             从文件扩展名为 .acsr 的文件中导入限制。
     /exportreg=<file>               导出 Windows 注册表文件(.reg 文件)。

此插件使具有管理员权限或 root 用户权限的任何用户能够限制当前工作站上的所有用户对某些功能的使用。

   功能            描述
    5250            5250 仿真器
    cfg             系统配置
    checkupdates    查找可用的更新
    cldownload      数据传输命令行下载
    console         5250 控制台
    consoleprobe    在本地网络中搜索控制台配置
    db2             模式
    db2tools        SQL 性能中心
    download        数据传输命令行下载
    dtgui           数据传输图形用户界面
    hmcprobe        搜索分区的 HMC
    ifs             集成文件系统
    installupdates  从 IBM i 所配置的位置安装更新
    keyman          SSL/TLS 证书管理
    l1c             IBM Navigator for i(第 1 级控制台)
    osssetup        开放式源代码程序包管理
    restrictview    限制查看当前限制使用的功能
    rmtcmd          远程命令(可以从命令行使用)
    rss             运行 SQL 脚本
    sm              5250 会话管理器
    splf            打印机输出(假脱机文件)
    ssh             安全 Shell
    sysdbg          IBM i 系统调试器
    upload          数据传输命令行上载
    vcp             虚拟控制面板

    硬件管理界面:
    hmi1            硬件管理界面 1
    hmi2            硬件管理界面 2
    asmi            高级系统管理界面 (ASMI)
    csmi            Copy Services Manager for i
    dcm             数字证书管理器
    dshmc           DS HMC
    hmc             硬件管理控制台 (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             集成虚拟化管理器
    specctrl        频谱控制
    tapemgmt1       磁带管理 1
    tapemgmt2       磁带管理 2
    are             管理运行时专家
    db2webquery     Db2 Web Query
    

还可以使用关键字以组的形式来排除功能:

   组                 功能
  dataxfer          dtgui、upload、download 和 cldownload
  emulator          sm 和 5250
  keyman            keyman
  opconsole         console、vcp、consoleprobe 和 hmcprobe
  rmtcmd            rmtcmd
  splf              splf
  ifs               ifs    
  hwconsole         hmi1、hmi2、asmi、csmi、dcm、dshmc、hmc、httpadmin、ivm、specctrl、tapemgmt1、tapemgmt2、are 和 db2webquery
  l1cplugin         l1c
  database          db2、rss 和 db2tools
  debugger          sysdbg

管理员或具有 root 用户权限的用户还能够从主 GUI 限制功能。
    “编辑”->“首选项”
    “限制”选项卡

要了解在多个工作站限制功能的简单方式,请参阅 9.5 定制包一节。

9.1.27 RESTRICTVIEW

/PLUGIN=restrictview
列示当前在此工作站上受限制的功能

9.1.28 FILEASSOC

/PLUGIN=fileassoc [<filetype> <filetype> ...] [/c]

    <filetype>   - 有效文件类型为:dttx、dtfx、hod、bchx、ws、bch 和 sql
    /c           - 清除所指定文件类型的文件关联
在 Windows 平台上,这将为 .dttx、.dtfx、.hod、.bchx、.ws、.bch 和 .sql 类型的文件设置文件关联。在非 Windows 平台上,将显示错误消息。

此功能相当于主 GUI 中的“工具”->“文件关联”。

9.1.29 DTBATCH

/PLUGIN=dtbatch [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - 连接至目标系统时要使用的用户标识
    <filename>- 上一次执行数据传输下载或上载时创建的具有 .dtfx 或 .dttx 扩展名的文件。                可以指定多个具有此关键字或不具有此关键字的文件。
此插件使用户能够运行先前保存的数据传输请求。

还可从主 GUI 中通过选择数据传输来进行数据传输。

9.1.30 PM5250

/PLUGIN=pm5250 [/input=<file> ...  /output=<directory>] [/verbose] [/gui]

    /input    - 要迁移的文件。这些文件必须是扩展名为 .ws、.bch、.kmp、.pmp 或 .bar 的 5250 文件。    /output   - 将存储已迁移文件的位置。    /verbose  - 显示已迁移文件的结果。    /gui      - 启动用于迁移 5250 文件的用户界面。
此插件使用户能够将文件从 IBM i Access for Windows Personal Communications 仿真器迁移到 IBM i Access Client Solutions 仿真器。某些已转换的文件将具有新的文件扩展名。请参阅 9.6.2 迁移 5250 仿真一节

9.1.31 RSS

/PLUGIN=rss /SYSTEM=<system> /DATABASE=<database> [/FILE=<file>] [/SQL=<file>] [/AUTORUN=<0,1>]

    /FILE=<filename> - 打开指定的文件
    /SQL=<sql>       - 从所指定的 SQL 开始
    /AUTORUN=<1,0>   - 自动运行脚本
此插件使用户能够运行 SQL 语句和 CL 命令。

9.1.32 DB2TOOLS

/PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<database> [Options]

有效选项为:
    /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                    - 要执行的操作:
                      LIST 选项可以与 LISTNAME 自变量配合使用,并显示
                      SQL 性能中心以及指定的列表。
                      ANALYZE 选项分析给定的性能数据集。
                      STATEMENTS 选项显示 SQL 计划高速缓存或
                      给定性能数据集的语句。
                      COMPARE 选项比较给定的性能数据集。    /NAME=<name>    - 性能数据集的名称
    /TABLE=<name>   - 性能数据所在的表的名称
    /SCHEMA=<name>  - 性能数据所在的表的模式名
    /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                    - 要在 SQL 性能中心内显示的初始列表。
“SQL 性能中心”插件提供了一组工具,用于帮助您优化数据库应用程序中的 SQL:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<system>
“集成文件系统”提供了一个用于浏览 IBM i 的集成文件系统的界面,可以通过以下方式来处理集成文件系统中的对象: 请参阅 9.12 集成文件系统 (IFS) 一节,以了解使用此插件时的需求和限制。

9.1.34 DB2

/PLUGIN=DB2 /SYSTEM=<system>
此插件提供了一个用于在 IBM i 上管理 Db2 for i 数据库的界面。

9.1.35 CHECKUPDATES

/PLUGIN=checkupdates
此插件提供了一个用于检查是否有可用更新的界面。

9.1.36 SSH

/PLUGIN=SSH /SYSTEM=<system>
SSH 终端将对 IBM i 集成文件系统启动 PC 上已安装的 SSH 客户机(终端仿真器)。

9.1.37 OSSSETUP

/PLUGIN=OSSSETUP
OSSSETUP 将启动一个界面,此界面将允许您在 IBM i 上管理开放式源代码程序包。

9.1.38 INSTALLUPDATES

/PLUGIN=installupdates [Options]

有效选项为:
    /noprompt         不提示输入用户标识和密码
                      注意:使用此选项时,如果已经对远程系统的用户凭证进行高速缓存,
                            那么将继续正常检查可用更新。
                            如果未高速缓存用户凭证,那么对于远程系统的权限将被拒绝,
                            并且更新将不可用。
INSTALLUPDATES 将检查所配置的 IBM i 系统是否存在可用更新,将自动下载更新,并将更新安装到本地 PC 安装。 要配置用于下载更新的 IBM i 位置,请参阅 5.2 节

9.1.39 HTTPPROXYUI

/PLUGIN=httpproxyui

HTTPPROXYUI 将启动受保护的 HTTP 代理,该代理支持通过运行此代理的计算机从 IBM i 连接到因特网。 任何输入了 HTTPPROXYUI 插件所提供命令的 SSH 终端会话都支持访问因特网。
注意:SSH 终端会话必须与此代理在同一台计算机上运行。

9.1.40 UDC 字体转换

/udcnv  [/wide]

    /wide         此选项仅对于代码页 932 有效。
                  指定了此选项时,所生成的字体图像文件将包含 Unicode 字符。
调用示例:
      Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnv
此命令行选项用于生成字体图像文件,该文件包含 Windows 工作站上当前所配置的用户定义字符 (UDC)。 所生成的字体图像文件是基于工作站语言环境的 ANSI 代码页。支持下列 ANSI 代码页:
   代码页           平台                           字体图像文件名
     932        日语 Windows                         jpn24.fnt
     949        韩国语 Windows                       kor24.fnt
     936        简体中文 Windows                     chs24.fnt
     950        繁体中文 Windows                     cht24.fnt
所生成的字体图像文件可与 Windows 工作站上的打印机定义表 (PDT) 结合用于 5250 打印机仿真。 该命令将启动 GUI,该 GUI 将允许您指定用于放置所生成字体图像文件的路径。 所生成的字体图像文件需要具有上面所指定的名称,并放置在位于以下位置的 Emulator\fonts 文件夹中:
      <Configuration Root>\Emulator\fonts
其中 <Configuration Root> 通常为如下所示的路径:
       C:\Users\<user_name>\Documents\IBM\iAccessClient
要找到安装的实际配置根目录,请参阅 8.1 配置位置一节。

局限性:



9.2 文件关联

将 IBM i Access Client Solutions 所生成的某些配置文件作为第一个参数并且也是唯一参数来提供时,支持从命令行使用这些配置文件。将这些具有特定文件扩展名的文件作为第一个参数来提供时,IBM i Access Client Solutions 会将此文件与要调用的功能相关联,并将此文件作为该功能的输入来提供。

下列扩展名具有文件关联支持:

    .dttx   - 数据传输上载请求
    .dtfx   - 数据传输下载请求
    .hod    - 5250 仿真器会话概要文件
    .bchx   - 多会话仿真概要文件
    .ws     - 5250 仿真器会话概要文件 (Personal Communications)
    .bch    - 多会话仿真概要文件 (Personal Communications)
    .sql    - SQL 文件
命令行示例:
    acslaunch_xxx dt_download_file.dtfx - 运行已保存的下载操作
    acslaunch_xxx dt_upload_file.dttx   - 运行已保存的上载操作
    acslaunch_xxx system_lp13ut20.hod   - 启动与系统的 5250 会话
...其中,acslaunch_xxx 是用于启动产品的命令行语法。请参阅 7.3 使用命令行启动产品一节。

这些受支持的命令行文件关联使用户能够手动设置特定于操作系统 (OS) 的文件关联。由于文件关联依赖于平台,因此需要执行的步骤取决于操作系统。

您之所以可能想要考虑为操作系统设置文件关联,原因在于这样您就能够双击(上述受支持的其中一种文件类型的)文件以启动所指定的功能。

下列各节提供了为某些操作系统设置文件关联的一些示例。

9.2.1 文件关联(对于 Windows)

  1. 从主 GUI 菜单栏中,选择“工具”->“文件关联...”
  2. 选择要为其创建文件关联的文件类型。
  3. 选择“确定”

现在,当您双击此类型的文件时,就将运行相应的 IBM i Access Client Solution 功能。

9.2.1.1 更改图标(对于 Windows 快捷方式)

  1. 找到先前为您的硬件体系结构的相应二进制文件(acslaunch_win-32.exe 或 acslaunch_win-64.exe)创建的快捷方式
  2. 单击鼠标右键,并选择“属性”
  3. 选择“快捷方式”选项卡
  4. 单击“更改图标...”按钮
  5. 选择要用于此快捷方式的图标
  6. 选择“确定”
  7. 选择“确定”

9.2.2 设置桌面图标(对于 Linux)

完成 QuickStartGuide 中适用于 Linux 的步骤。这会将应用程序安装到 /opt/ibm/iAccessClientSolutions 中。还会创建 /usr/share/applications/IBM i Access Client Solutions.desktop

要在桌面上为产品创建图标,请将以上 .desktop 文件复制到“桌面”文件夹。您可能需要调整此文件在桌面上的许可权,以使其可执行。

9.2.2.1 文件关联(对于 Linux)

设置文件关联所需完成的步骤取决于 Linux 发行版以及所使用的桌面环境。通常,需要执行的步骤类似于上述用于 Windows 的步骤。

  1. 找到您要关联并且具有受支持扩展名(例如,.hod、.bchx、.dtfx 或 .dttx)的文件
  2. 右键单击该文件。查找使您能够将程序与文件相关联的选项或属性。
  3. 使该文件和/或其扩展名与相应的 IBM i Access Client Solutions 二进制文件或启动脚本相关联。

9.2.3 文件关联(对于 Mac)

要在 Mac 上使用“文件关联”,文件类型必须与某个应用程序相关联。完成 QuickStartGuide 中适用于 Mac 的步骤,这样即可安装 IBM i Access Client Solutions 应用程序。

9.2.3.1 创建文件关联(对于 Mac)

  1. 使用 Finder 找到您要关联并且具有受支持扩展名(例如,.hod、.bchx、.dtfx 或 .dttx)的文件
  2. 选择此文件,然后选择“文件”->“获取信息”
  3. 在“打开方式:”选项下选择“其他”
  4. 浏览到 IBM i Access Client Solutions 应用程序的位置。
  5. 选择应用程序。
  6. 选中“始终采用的打开方式”的框。选择“添加”。
  7. 返回到“打开方式:”,选择“全部更改”。对任何对话框都选择“继续”。

现在,当您双击此类型的文件时,就将运行相应的 IBM i Access Client Solution 功能。

9.2.3.2 更改图标(对于 Mac)

使用“预览”应用程序可以找到产品目录中的 Icons 文件夹,然后使用 Finder 在“获取信息”中替换该图标。

  1. 从“预览”中,选择“文件”->“打开”
  2. 找到产品 Icons 目录
  3. 选择包含该图标的文件,然后选择“打开”
  4. 选择“编辑”->“全部选中”
  5. 选择“编辑”->“复制”
  6. 通过 Finder 找到要更改其图标的 .hod、.bchx、.dtfx 或 .dttx 文件。
    如果该文件已经在桌面上,请单击该文件以将其选中。否则,请选择“前往”->“前往文件夹”,然后输入该文件的路径,接着选择“前往”。
    单击该文件以将其选中。
  7. “文件”->“获取信息”
  8. 单击“获取信息”顶部的图标
  9. “编辑”->“粘贴”

9.3 更改配置位置

缺省情况下,每个用户都使用自己的唯一位置来存放他们的配置。可通过设置以下属性来更改配置位置:
    com.ibm.iaccess.AcsBaseDirectory
此属性位于 AcsConfig.properties 文件中。

交付产品时,AcsConfig.properties 文件存在于两个位置。此文件包含在 acsbundle.jar 文件中。为了方便起见,还在产品 .zip 文件中提供了此文件,将 .zip 文件解包后,此文件与 acsbundle.jar 文件位于同一目录中。

启动期间,产品将仅使用它找到的第一个 AcsConfig.properties 文件。它首先检查 acsbundle.jar 文件所在的目录。如果在 acsbundle.jar 文件所在的目录中找不到 AcsConfig.properties,那么它将使用 acsbundle.jar 文件内的 AcsConfig.properties 文件。

可选择使用定制配置路径来更新 acsbundle.jar 中的 AcsConfig.properties。如果您这样做,请确保 acsbundle.jar 所在的目录不包含 AcsConfig.properties 文件,否则将会改为使用该文件。这使您能够灵活使用 acsbundle.jar 文件分配配置位置,同时还使您能够灵活对其进行覆盖。

提供了定义配置路径时可使用的特殊关键字。在所指定路径中使用了这些关键字时,这些关键字将替换为它们定义的文本或路径。在配置路径中,只能使用一个关键字。特殊关键字及其含义如下所示:

	{USER} - 当前用户标识。此关键字可以位于路径中的任何位置

下列关键字只能位于所指定路径的开头:

	{PRODUCTDIR} - acsbundle.jar 所在目录的路径
	{TEMPDIR}    - 特定于平台的临时目录的路径
	{ROOT}       - 文件系统的根目录的路径
	{HOME}       - 用户的主目录的路径
	{DEFAULT}    - 产品通常使用的缺省路径

技术说明:
我们建议不要在多个用户之间共享配置。例如,如果 X 是共享的网络驱动器,那么以下设置可能会导致不可预测的结果:

    com.ibm.iaccess.AcsBaseDirectory=X:/Shared_Network_drive/config_directory

共享此配置路径的多个用户存在数个问题:

  1. 如果多个用户同时使用此配置,那么将发生不可预测的结果。
  2. 此示例假定每个用户都将 X 驱动器映射到同一位置。
  3. 在 Linux 或 Mac 客户机上,无法在配置中使用网络驱动器。使用提供的关键字(如下面的示例中所示)适用于 Windows、Linux 和 Mac。

在多个用户之间共享配置路径时,应该使用 {USER} 关键字来避免与其他用户发生冲突。它将替换为当前用户的用户标识。

设置该配置路径时,请使用正斜杠(“/”)而不是反斜杠(“\”)作为目录分隔符。这适用于所有操作系统,其中包括 Windows。

以下是建议的一些样本配置:

示例 1 - 当前用户的本地配置(缺省情况):

    com.ibm.iaccess.AcsBaseDirectory=
如果未设置 AcsBaseDirectory,那么此配置将缺省为用户的依赖于平台的路径。这是 IBM i Access Client Solutions 的缺省设置。

示例 2 - 每个用户特有的远程(或本地)配置:

    com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/
此配置是远程配置还是本地配置取决于 {ROOT} 的位置。

示例 3 - 每个用户特有的远程(或本地)配置:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/
此配置是远程配置还是本地配置取决于 {PRODUCTDIR} 的位置。

示例 4 - 便携介质(例如 USB 驱动器)上的本地配置:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory
由于便携介质的路径将随使用该介质的系统不同而变化,因此,此设置允许该配置相对于产品文件。在此示例中,有意未指定 {USER} 关键字,因此 USB 驱动器上的配置将由 USB 驱动器的用户使用,而不考虑用户标识。

9.4 其他部署选项

以下是一些您可能要考虑使用的其他部署选项:

9.4.1 自动导入配置设置

在 AcsConfig.properties 文件中,可以使用下列属性,以便自动为新用户设置配置或者为现有用户更新配置:

   com.ibm.iaccess.autoimport
   com.ibm.iaccess.autoimport.version

必须完成的步骤如下所示:

  1. 创建要传播到一个或多个用户的配置。
  2. 通过使用主 GUI 中的“文件”->“导出配置”,或者使用 9.1.1 Backup 一节中的命令行选项,将该配置导出到文件。
  3. 将配置文件移至期望位置。后面描述了若干可用选项。
  4. 将 AcsConfig.properties 中的 com.ibm.iaccess.autoimport 属性设置为配置文件的路径。
  5. 将 com.ibm.iaccess.autoimport.version 设置为表示配置文件版本的整数值。

此功能的工作方式如下:
当 com.ibm.iaccess.autoimport.version 属性的整数值与导入的最后一个值不匹配时,将自动导入 com.ibm.iaccess.autoimport 属性所引用的已保存配置。除了提供用于设置初始配置以及对现有配置提供更新的方法之外,这还提供了用于将配置作为后备级别的方法。任何时候在 version 属性的整数值与导入的最后一个版本之间存在不匹配的情况时,都会更新该配置。不过,虽然所导入配置可能更改用户的配置中针对现有系统的配置,但是将决不会从用户的配置中删除系统。

可采用绝对路径、URL 或使用 9.3 一节中定义的关键字指定 com.ibm.iaccess.autoimport 属性的路径。例如:

    com.ibm.iaccess.autoimport=C:/acs_bak.zip
com.ibm.iaccess.autoimport=file///C:/acs_bak.zip
com.ibm.iaccess.autoimport=http://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport=ftp://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip

另外,允许将配置文件分配在 acsbundle.jar 内或分配在 acsbundle.jar 所在的目录中将使其更加灵活。对于上述任意一种情况,请使用文件的名称(不带上述路径)来设置 com.ibm.iaccess.autoimport:

    com.ibm.iaccess.autoimport=acs_bak.zip

允许将特殊值 * 用于 com.ibm.iaccess.autoimport.version:

    com.ibm.iaccess.autoimport.version=*

这将始终导入配置,而不考虑任何先前版本。

注意:
要避免导入系统配置的“连接”选项卡上指定的缺省用户名,请将以下属性放置在 AcsConfig.properties 文件中。

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.4.2 本机 IBM i 部署

可以在 IBM i 本机上使用上某些不需要 GUI 的命令行插件。例如,可以在 IBM i 上使用数据传输将数据直接从数据库抽取到电子表格文件类型,而不必将数据下载到 PC。

为此,可以将产品 .zip 文件抽取到 IBM i 集成文件系统 (IFS) 中的任何位置。例如,如果已将产品 .zip 文件抽取到以下位置:

 /home/AccessClientSolutions 
并且先前保存的数据传输下载请求位于以下位置:
 /some_path/qcustcdt.dtfx 
那么可以在 IBM i 上运行以下命令:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /PLUGIN=dtbatch /some_path/qcustcdt.dtfx')                                            

注意:
还有一些 IBM i PTF,它们将在 IBM i 上为您抽取产品的内容。 请参阅 5.3 可选 IBM i PTF 一节

9.5 定制包

IBM i Access Client Solutions 使系统管理员能够通过在 AcsConfig.properties 文件中设置以下两个属性中的任意一个属性来限制对特定功能的使用:

    com.ibm.iaccess.ExcludeComps=<function, function,...>
    com.ibm.iaccess.IncludeComps=<function, function,...>

如果设置 com.ibm.iaccess.ExcludeComps,那么将禁用指定的功能。将启用所有其他功能。此属性中指定的任何功能在主 ACS GUI 中和命令行中都不可用。下面列示了可以在此属性中指定的功能。

如果设置 com.ibm.iaccess.IncludeComps,那么将启用指定的功能。将禁用所有其他功能。此属性中指定的任何功能都可以正常使用。下面列示了可以在此属性中指定的功能。

   功能            描述
    5250            5250 仿真器
    cfg             系统配置
    checkupdates    查找可用的更新
    cldownload      数据传输命令行下载
    console         5250 控制台
    consoleprobe    在本地网络中搜索控制台配置
    db2             模式
    db2tools        SQL 性能中心
    download        数据传输命令行下载
    dtgui           数据传输图形用户界面
    hmcprobe        搜索分区的 HMC
    ifs             集成文件系统
    keyman          SSL/TLS 证书管理
    l1c             IBM Navigator for i(第 1 级控制台)
    osssetup        开放式源代码程序包管理
    restrictview    限制查看当前限制使用的功能
    rmtcmd          远程命令(可以从命令行使用)
    rss             运行 SQL 脚本
    sm              5250 会话管理器
    splf            打印机输出(假脱机文件)
    ssh             安全 Shell
    sysdbg          IBM i 系统调试器
    upload          数据传输命令行上载
    vcp             虚拟控制面板

    硬件管理界面:
    hmi1            硬件管理界面 1
    hmi2            硬件管理界面 2
    asmi            高级系统管理界面 (ASMI)
    csmi            Copy Services Manager for i
    dcm             数字证书管理器
    dshmc           DS HMC
    hmc             硬件管理控制台 (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             集成虚拟化管理器
    specctrl        频谱控制
    tapemgmt1       磁带管理 1
    tapemgmt2       磁带管理 2
    are             管理运行时专家
    db2webquery     Db2 Web Query
    

还可以使用以下关键字以组的形式指定功能:

   组                 功能
  dataxfer          dtgui、upload、download 和 cldownload
  emulator          sm 和 5250
  keyman            keyman
  opconsole         console、vcp、consoleprobe 和 hmcprobe
  rmtcmd            rmtcmd
  splf              splf
  ifs               ifs    
  hwconsole         hmi1、hmi2、asmi、csmi、dcm、dshmc、hmc、httpadmin、ivm、specctrl、tapemgmt1、tapemgmt2、are 和 db2webquery
  l1cplugin         l1c
  database          db2、rss 和 db2tools
  debugger          sysdbg

通常,这些属性不会一起使用。如果将它们一起使用,并且在两个属性中都指定了某个功能,那么将禁用该功能。

示例 1:此示例将禁用所有与 OPCONSOLE,HWCONSOLE,L1CPLUGIN 相关联的功能。将启用以上列表中的所有其他功能。

    com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN

示例 2:此示例将启用 5250 和数据传输下载。将禁用以上列表中的所有其他功能。

     com.ibm.iaccess.IncludeComps=5250,DOWNLOAD  

如果系统管理员希望先更新 acsbundle.jar 内的 AcsConfig.properties 文件,然后再对其用户部署该文件,那么以下是如何执行该操作的示例:

    jar uvf acsbundle.jar AcsConfig.properties
有关 IBM i Access Client Solutions 如何确定要使用哪个 AcsConfig.properties 文件的更多信息,请参阅 9.3 更改配置位置一节。

9.6 从 IBM i Access for Windows 进行迁移

IBM i Access Client Solutions 配置文件与 IBM i Access for Windows 中的相应功能不兼容。IBM i Access Client Solutions 为若干关键项提供了迁移路径,如下列各节中所讨论。

9.6.1 迁移系统配置

主 GUI 菜单的“文件”->“复制连接”提供了“复制连接”功能,此功能提供了一个界面,用于在 IBM i Access Client Solutions 与 IBM i Access for Windows 所支持的旧 Windows 配置之间复制系统配置。有关额外信息,请参阅“复制连接”的主面板的帮助。还可使用命令行来迁移系统配置。有关更多信息,请参阅 9.1.25 MIGRATE 一节。

9.6.2 迁移 5250 仿真

可通过使用 IBM i Access Client Solutions 中的 5250 会话管理器来转换由 IBM i Access for Windows 个人通信仿真器使用的 5250 仿真文件。可以转换个人通信中的下列文件类型:

   .ws   - 仿真器概要文件
   .bch  - 仿真器批处理文件
   .kmp  - 键盘定制文件
   .pmp  - 弹出式小键盘文件
   .bar  - 菜单栏文件
这些文件将转换为:
   .hod  - 仿真器概要文件
   .bchx - 仿真器批处理文件
   .kmp  - 键盘定制文件
   .pmp  - 弹出式小键盘文件
   .bar  - 菜单栏文件
这两个产品都使用 .kmp、.pmp 和 .bar 文件类型。但是,这些格式不兼容。将在特定于 IBM i Access Client Solutions 的路径中创建已转换的文件。

可以通过执行以下操作,从 IBM i Access Client Solutions 的“会话管理器”菜单启动对这些文件的转换:

...或者使用 PM5250 插件从命令行进行转换。请参阅 9.1.30 PM5250 一节。

提供了宏转换实用程序。在会话管理器中:

    工具 -> 转换宏...
技术说明:
如果 PC5250 宏是不仅仅包含所记录击键的定制宏,那么宏转换实用程序可能无法转换该宏。

9.6.3 迁移已保存的数据传输请求文件

IBM i Access Client Solutions 中的“数据传输”提供了一个向导,用于转换由 IBM i Access for Windows 生成的已保存数据传输请求文件。

可以转换 IBM i Access for Windows 中的下列文件类型:

   .dtf - 以 IBM i 为源的数据传输
   .dtt - 以 IBM i 为目标的数据传输
这些文件将转换为:
   .dtfx - 以 IBM i 为源的数据传输
   .dttx - 以 IBM i 为目标的数据传输
“数据传输”迁移向导不迁移 .fdf 文件。IBM i Access Client Solutions 需要的 新文件类型为 .fdfx,并且可以在下载期间或者通过使用“创建文件”向导生成。

通过选择“操作”->“数据传输迁移”,可以从“数据传输”主菜单中使用“数据传输”迁移向导

9.6.4 EHLLAPI

对于利用 EHLLAPI 访问 IBM i Access for Windows 随附的个人通信仿真器的 5250 应用程序,请参阅以下 KB 文章,以获取有关将 EHLLAPI 与 IBM i Access Client Solutions 配合使用的信息:

    http://www-01.ibm.com/support/docview.wss?uid=nas8N1010639

9.6.5 Kerberos

IBM i Access Client Solutions 支持 Kerberos。要在连接至系统时使用 Kerberos,请完成下列步骤:

  1. 从主 GUI 中显示“系统配置”
  2. 选择新建系统配置或编辑现有系统配置
  3. 在“连接”选项卡上,选择
    “使用 Kerberos 认证;不提示”
设置 Kerberos 环境超出了本文档的范围。

9.6.6 5250 兼容性

可以使用 com.ibm.iaccess.PC5250Compatibility 属性来更改 ACS 仿真器的缺省行为。 可以在 AcsConfig.properties 中使用下列值来设置此属性:

    allowNnAsFKeyHotspot      - 将 NN 热点(例如,FNN、PFNN 和 FPNN)视为功能键热点。
    allowHighlightBypassField - 允许突出显示具有 ENTFLDATR 的绕过字段。
    allowTypingInSignPosition - 允许在带符号的数字字段的符号位置键入“-”或者“ ”。
    allowTransformSpecialCharsOnPaste - 更改在粘贴来自外部文档的文本时如何变换某些字符
                                       (例如,全角引号变为半角引号)
示例 1:
     com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPaste
示例 2:可以在逗号分隔列表中指定多个值。
     com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition

9.7 密钥管理

通过选择“工具”->“密钥管理”,可以从主 GUI 中管理用于安全套接字层 (SSL) 连接的证书。针对密钥数据库的某些任务需要密钥库完整性口令。

9.8 数据传输

9.8.1 对 Excel 电子表格和 Calc 电子表格的数据传输支持

除了支持下载至文件以外,数据传输还支持下载至 Microsoft Excel 电子表格或 OpenOffice Calc 电子表格的活动电子表格。为了下载至活动电子表格,主数据传输 GUI 面板提供了选择输出设备的选项。缺省情况下,输出设备为文件。如果平台支持与 Excel 和/或 Calc 电子表格交互,那么可以从“输出设备”下拉框选择用于活动 Excel 电子表格和活动 Calc 电子表格的其他选项。

限制:

9.8.2 对字符截断和数字溢出的数据传输支持

在执行数据传输上载请求期间,如果字符字段或数字字段超过字段的已定义大小,那么上载请求将终止。

要使字符字段能够从末尾截断,请在 AcsConfig.properties 文件中设置以下属性:
    com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

要使数字字段能够在提供的数字字段超过已定义的边界时设置为其最大正值或负值,请在 AcsConfig.properties 文件中设置以下属性:
    com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

当这些属性设置为 true 时,上载请求将继续,而不会提供任何指示来说明已发生截断或溢出。将在结束时截断字符字段。数字字段将设置为其最大值(对于上溢)和最小值(对于下溢)。

或者,可以像设置其他 Java 属性一样,从命令行设置以上属性,如下所示:
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

9.8.3 数据传输工作表名称

在下载期间,将根据 IBM i 源库和文件的名称生成工作表名称并附加“>Sheet#”,其中 # 将替换为工作表号码。例如:
    qiws.qcustcdt>Sheet1

要覆盖工作表名称的库和文件部分,可以指定以下属性:
    com.ibm.iaccess.dataxfer.SheetId=your_string
这将生成:
    your_string>Sheet1

如果在该属性中使用了特殊值 %1$s %2$s 或 %3$s,那么可以更改或消除 library.filename 和 sheet# 的布置。

这些值具有以下含义:

            %1$s - library.filename    例如:qiws.qcustcdt
            %2$s - sheet#                   例如:1
            %3$s - 不带文件扩展名的目标文件名

使用任何这些特殊值都可以完全控制工作表名称。

将该属性设置为 Sheet%2$s 会生成工作表名称 Sheet1 和 Sheet2 等等
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s

可以将 %1$s %2$s 或 %3$s 的任意组合与其他文本配合使用。

注意:
由于电子表格中的工作表名称必须唯一,因此,如果将此属性设置为使用 %1$s 或 %3$, 而不同时使用 %2$s,那么在需要多个工作表时,将产生错误。

9.9 建立控制台与 IBM i 的连接

要对 IBM i 执行管理功能,您需要 5250 控制台。IBM i Access Client Solutions 支持 LAN 和 HMC 控制台配置。

如果您知道 IBM i 的服务主机名或服务 IP 地址,或者知道 HMC 控制台的主机名或 IP 地址,那么可以使用以下步骤来配置 IBM i Access Client Solutions 中的控制台信息:

  1. 在 PC 上启动 IBM i Access Client Solutions。
  2. 在主面板上,单击“系统配置”。
  3. 单击“新建”按钮以输入新配置,或者单击“编辑”按钮以更新现有配置。
  4. 选择“控制台”选项卡。
  5. 输入控制台类型的相应信息。

对于其中还不存在控制台配置的 IBM i(例如,刚刚交付给企业的新系统),在 IPL 期间,将在 169.254.62.0 - 169.254.62.63 范围内自动分配用于控制台连接的 IP 地址。对于这些情况,以下步骤将有助于使用 IBM i Access Client Solutions 建立控制台连接:

  1. 禁用 PC 的无线连接。以下步骤需要联网的以太网端口。
  2. 在 PC 与 IBM i T1 端口之间铺设以太网电缆。
  3. 在 PC 上启动 IBM i Access Client Solutions。
  4. 在主面板上,单击“系统配置”。
  5. 在“系统配置”中,单击“查找控制台...”按钮。
  6. 在“IBM i 定位器”面板中,单击“搜索”按钮。
  7. 如果 IBM i 上的 IPL 序列已进行到足以自动分配 IP 地址的程度,那么“搜索”面板中应该会显示该 IP 地址。
  8. 单击显示的 IP 地址以将其选中,然后单击“控制台”按钮以连接 5250 控制台。
  9. 将显示一个面板,要求输入服务工具凭证。
  10. 在输入有效凭证后,将显示 5250 控制台。
  11. 该控制台可以用来处理初始安装和设置任务。

当您准备将 IBM i 系统添加到网络基础结构的其余部分时,IBM Knowledge Center 中提供了有关如何配置服务工具 LAN 适配器的其他信息供您参考:

请参阅为 DST 配置服务工具服务器

对于已具有 LAN 控制台配置并且已存在于网络基础结构中的 IBM i 系统,可以通过以下步骤查找现有的控制台配置:

  1. 在 PC 上启动 IBM i Access Client Solutions。
  2. 在主面板上,单击“系统配置”。
  3. 在“系统配置”中,单击“查找控制台...”按钮。
  4. 在“IBM i 定位器”面板上,将“附近”字段更新为您要搜索的范围中的 IP 地址。
  5. 单击“搜索”按钮,以便在指定范围内查找 LAN 控制台。
  6. 单击显示的 IP 地址以将其选中,然后单击“控制台”按钮以连接 5250 控制台。
  7. 将显示一个面板,要求输入服务工具凭证。
  8. 在输入有效凭证后,将显示 5250 控制台。

9.10 附加字体

可以将用于 5250 仿真的附加字体添加到 Fonts 目录。

要提供附加字体备用位置和/或多个附加字体位置,请设置 AcsConfig.properties 文件中的 com.ibm.iaccess.Fonts 属性。

通过将 com.ibm.iaccess.Fonts 属性设置为以下内容,可以覆盖缺省 Fonts 目录:

  1. <path>,这是包含字体的目录
  2. 特定字体文件(例如 .ttf)的 <path>/<filename>
  3. 字体文件的 URL
  4. 一列以分号定界的上述任意项目

注意:
<path> 可以是绝对路径,也可以是开始于 acsbundle.jar 的位置的相对路径。5250 仿真只能识别等宽字体。

示例 1(缺省值):

     com.ibm.iaccess.Fonts=Fonts	
示例 2:
     com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts

9.11 使用 netrc 文件中的凭证

要启用 .netrc 文件(Linux 和 Mac)或 _netrc 文件 (Windows),请转至 IBM i Access Client Solutions 主 GUI,然后从菜单栏中选择
    “编辑”->“首选项”
    “常规”选项卡
    选中以下框:读取 netrc 文件以获取登录信息
    单击“应用”按钮
    重新启动 IBM i Access Client Solutions

netrc 文件的标准格式为:

     machine <system> login <user-id> password <password>

netrc 文件必须存储在用户的主目录中,并且系统名称和用户标识必须与系统配置匹配。从 IBM i Access Client Solutions 中:
    选择“系统配置”
    选择系统,然后编辑系统
    “连接”选项卡
    选择使用缺省用户名对每个系统提示一次
    在缺省用户名中填写用户标识
    选择“确定”

当系统名称和缺省用户名与 netrc 文件的内容匹配时,将使用 netrc 文件中的密码建立与系统的连接,而不会提示用户。

9.12 集成文件系统 (IFS)

9.12.1 IFS、QFileSvr.400 和安全性

集成文件系统支持将使用 QFileSvr.400 文件系统在 IBM i 分区之间复制或发送对象。这意味着两个分区上的用户概要文件和密码必须匹配,并且这两个分区必须具有相同密码级别系统值 (QPWDLVL)。如果要使用 Kerberos 认证,那么这两个分区必须已配置网络认证服务和企业身份映射 (EIM)。有关更多详细信息,请参阅 IBM i Knowledge Center 中的“QFileSvr.400 文件系统中的安全性和对象权限”主题。

由 QFileSvr.400 文件系统建立的与其他 IBM i 分区的连接不安全。如果在 IBM i 分区之间复制或发送对象需要安全连接,那么必须设置分区的配置以使用 SSL,系统配置必须已为该分区选择“使用 SSL 进行连接”选项,并且必须在 AcsConfig.properties 文件中设置以下属性:
    com.ibm.iaccess.ifs.transferMechanism=ACS
或者,可以像设置其他 Java 属性一样,从命令行设置该属性,如下所示:
    -Dcom.ibm.iaccess.ifs.transferMechanism=ACS

9.12.2 IFS 权限

集成文件系统支持将需要权限以使用下列 CL 命令:

    CPY
    CPYFRMSTMF
    CPYTOSTMF
    CRTDIR
    CRTLIB
    CRTSAVF
    RMVDIR
    RST
    SAV
    SETASPGRP
 

如果用户无法使用这些 CL 命令,那么“复制”、“粘贴”、“发送”、“删除”和“新建文件夹”操作将失败。

9.12.3 IFS 限制

集成文件系统支持不允许对其路径以 /QFileSvr.400、/QNTC 或 /QOPT 开头的对象执行操作。如果当前目录路径或任何所选对象路径以 /QFileSvr.400、/QNTC 或 /QOPT 开头,那么将禁用“操作”菜单中的所有项,并且不会显示上下文菜单。

9.12.4 IFS 和独立 ASP

当源对象或目标对象位于独立 ASP 中时,集成文件系统支持不允许执行“复制”、“粘贴”或“发送”操作。

9.12.5 IFS 性能

显示目录的内容时,IFS 的性能取决于所选择的列属性(“查看”->“列...”)以及该目录是否包含符号链接。 对于非符号链接,选择 CCSID所有者会对性能产生其他影响。对于符号链接,对于所选择的除了图标名称大小 (KB) 之外的每个列属性,会对性能产生其他影响。

注意:浏览目录时,不会显示符号链接的大小 (KB)。 选择属性以获取符号链接所表示的文件的大小。

当显示具有大量条目的目录时,可能会超过正在运行 IBM i Access Client Solutions 的 Java 虚拟机的缺省内存限制。 这可能会导致所有打开的窗口变慢,并最终停止响应。如果您正在显示具有大量条目的目录,请考虑使用包含过滤器来限制从服务器发送的条目数。或者,使用 -Xmx 选项启动该产品以增加可用内存。例如:

    java -Xmx4g -jar V:/some_location/acsbundle.jar
或者
    Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g

上述示例会将内存从缺省值 1 GB 增加到 4 GB。您可能需要根据目录中的条目数进一步增加内存大小。

9.13 安全 Shell (SSH) 终端

对于缺省情况下存在安全 Shell 或者已安装安全 Shell 的平台,SSH 终端功能部件将显示在 IBM i Access Client Solutions 的主 GUI 上。SSH 终端将对 IBM i 集成文件系统启动终端仿真器。

缺省情况下,大多数 Mac、Linux 以及其他从 UNIX 派生的系统已具有安全 Shell。对于这些平台,假定 OpenSSH 客户机存在并位于 /usr/bin/ssh。Windows 用户将需要安装某个可供 Windows 使用的安全 Shell。

IBM i Access Client Solutions 所支持的安全 Shell:

         Linux:       Xterm、XterminalEmulator、MateTerminal、Terminator、GnomeTerminal、Konsole 和 Xfce4
         Mac:         Terminal 和 iTerm2
         Windows:cygwin、PuTTY 和 bash
                          cygwin 要求安装 OpenSSH 软件包
                          bash 将作为 Windows 的 Linux 子系统的一部分提供

如果安装了多个 SSH 应用程序,那么可以使用 com.ibm.iaccess.PreferredSSHClient 属性来设置首选 SSH 客户机。

Linux 示例:
         com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
         com.ibm.iaccess.PreferredSSHClient=MateTerminal
         com.ibm.iaccess.PreferredSSHClient=Terminator
         com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
         com.ibm.iaccess.PreferredSSHClient=Konsole
         com.ibm.iaccess.PreferredSSHClient=Xfce4

Mac 示例:
         com.ibm.iaccess.PreferredSSHClient=iTerm2

Windows 示例:
         com.ibm.iaccess.PreferredSSHClient=Cygwin
         com.ibm.iaccess.PreferredSSHClient=Putty
         com.ibm.iaccess.PreferredSSHClient=Bash

对于 SSH 客户机未安装到标准位置的情况,可以使用 com.ibm.iaccess.PreferredSSHClient 属性来提供所安装 SSH 客户机的标准路径。

         com.ibm.iaccess.PreferredSSHClient=C:\PuTTY\putty.exe

提供标准路径时,可能还需要设置 com.ibm.iaccess.SSHClientOpt 以提供所有必需自变量。例如,要在不使用 X11 转发时禁用警告,请进行以下设置:

         com.ibm.iaccess.SSHClientOpts=-x

9.13.1 SSH 终端先决条件

在 IBM i 上安装 5733-SC1 IBM Portable Utilities for i。
使用以下命令启动安全 Shell 守护程序:
         STRTCPSVR *SSHD

如果在启动的 SSH 客户机中遇到连接错误(例如“已拒绝连接”),或者窗口弹出又立即消失,那么可能需要以上命令来启动 SSH 守护程序。


10.0 服务诊断

如果您遇到需要 IBM 服务的问题,那么 IBM 服务代表可能会指导您执行下列一项或两项操作:

从主 IBM i Access Client Solutions GUI 中:


11.0 常见问题 (FAQ)

Q1    尝试启动 IBM i Access Client Solutions 时,发生以下
      错误:
             无法装入类:java.lang.UnsupportedClassVersionError
A1-1  您需要使用 JDK 8.0 或更高版本。请参阅 3.0 先决条件一节

Q2    尝试使用提供的某个二进制文件或脚本从 shell 或终端会话
启动产品时,发生以下错误:
         许可权被拒绝
A2-1  请检查该文件的文件许可权,以确保您具有执行许可权。请参阅 6.0 文件许可权一节。
Q3    双击所提供的其中一个文件以启动产品时未执行任何操作。A3-1  可能未安装 Java。请参阅 3.0 先决条件一节
A3-2  用来启动产品的文件可能不具有执行许可权。请参阅 6.0 文件许可权一节。A3-3  您所处的环境可能存在问题。要了解可能发生的错误,请尝试从命令行运行提供的文件。请参阅 7.3 使用命令行启动产品一节。
Q4    我想要使用其中一个二进制文件来启动产品,但是产生了以下错误:“装入 Java 模块时发生错误。”
A4-1  该二进制文件找不到 Java 安装的主目录。      请验证是否安装了 Java。请参阅 3.0 先决条件一节。A4-2  7.1.1 启动产品 - 其他选项一节包含使用二进制
文件来启动产品的其他方法。

Q5    设置 JAVA_HOME 环境变量之后,从命令行可以使用我用来启动产品的二进制文件,而双击该文件就不起作用。A5-1  双击该文件时,JAVA_HOME 环境变量在您使用的文件管理器中可能不可见。设置环境变量的方法随操作系统
不同而异,环境变量的可视性也是如此。请尝试将 JAVA_HOME 环境变量设置为您使用的操作系统的系统环境变量。您使用的操作系统可能会将系统环境变量称为全局环境变量。设置 JAVA_HOME 环境变量之后,关闭文件管理器,
然后将其重新打开,并尝试再次双击该二进制文件。
Q6    双击所提供的其中一个文件以启动产品时,文本编辑器显示该文件。A6-1  请确保您正在使用的脚本具有操作系统可以识别的文件扩展名。A6-2  尝试使用另外一个脚本。A6-3  更改用于打开该文件的程序。A6-4  请检查该文件的文件许可权,以确保您具有执行许可权。请参阅 6.0 文件许可权一节。
Q7    双击所提供的其中一个文件以启动产品时,系统提示我应使用哪个程序来打开该文件。A7-1  请确保您正在使用的脚本具有操作系统可以识别的文件扩展名。A7-2  将用来打开该文件的程序设置为与您正在使用的二进制文件或脚本兼容的程序。例如,终端(对于 Mac)。A7-3  请检查该文件的文件许可权,以确保您具有执行许可权。请参阅 6.0 文件许可权一节。
Q8    在 MAC 上从 Finder 启动 IBM i Access Client Solutions 时,弹出一个终端会话,
甚至在结束 IBM i Access Client Solutions 时,该终端会话也不消失。
A8-1  要使终端会话不再弹出,请使用 QuickStartGuide 中适用于 Mac 的安装脚本。
Q9    产品的最佳启动方式是什么?
A9-1  您可以使用 7.0 启动产品一节中描述的三种方法中的任意一种(二进制文件、脚本或命令行)来启动产品。任何在您所处的环境中有效的方法都可接受。
Q10   为什么同时提供了二进制文件 (Start_Programs) 和脚本 (Sample_Scripts) 来启动产品?
A10-1 这些脚本并不特定于操作系统,它们提供了更通用的方式,用于在特定于平台的二进制
文件不工作时启动产品。A10-2 定义文件关联时,某些操作系统需要二进制文件。      大多数情况下,应该使用二进制文件来启动产品。A10-3 某些环境中可能存在防火墙,这些防火墙会限制访问 IBM i Access Client Solutions
      的某些部分。通过使用某个二进制文件来启动产品,将使系统管理员更容易授予访问权。
Q11   安装 JDK 8.0(或更高版本)之后,仍然发生以下错误:
      无法装入类:java.lang.UnsupportedClassVersionError
A11-1 工作站上正在使用的缺省 Java 版本低于 JDK 8.0。您将需要使用一个显式指定 JDK 8
      的 Java 主路径的选项。请参阅 7.1.2 查找 Java 主路径一节。
      将 Java 主路径用于以下任一节中描述的其中一种方法:
      7.1.1 启动产品 - 其他选项
7.3 使用命令行启动产品
Q12 我无法从 Windows 5250 仿真器会话导入定制的键盘映射文件 (.kmp)。A12-1 在 IBM i Access Client Solutions 的初始版本(发布于 2012 年 7 月)中, 不支持从 Windows 5250 仿真器会话概要文件 (.ws) 中导入 .kmp 文件。 从发布于 2012 年 10 月的版本开始,现在支持从 5250 会话概要文件 (.ws) 中 导入 .kmp 文件。 Q13 5250 仿真器的键盘定制与 Windows 上的定制存在许多不同之处。您有什么建议吗? A13-1 键盘映射分为多个类别。在仿真器会话中: 单击“编辑”>“首选项”>“键盘”,或者单击工具栏上的“重新映射”按钮。 单击“指定键”选项卡。 选择类别。缺省键映射将显示在“主机功能”和“菜单命令”类别之下。 选择您想要指定的功能。 单击“指定键”。 在键盘上,按您想要为此功能指定的键(或组合键)。 A13-2 要获取有关定制键映射的帮助,请完成下列步骤: 单击“编辑”>“首选项”>“键盘”,或者单击工具栏上的“重新映射”按钮。选择“帮助”按钮。 Q14 当我尝试在 Mac OS X 10.8 Mountain Lion 上启动产品时,收到一条弹出消息,它指示应用程序未签名。A14-1 这是从 Mac OS X 10.8 Mountain Lion 开始在缺省情况下强制实施的安全策略。请参阅以下 Web 页面,以了解如何使应用程序能够运行: http://macperformanceguide.com/MountainLion-application-signing.html Q15 我是 IBM i Access for Windows 的用户,可以将系统配置迁移到 IBM i Access Client Solutions 吗? A15-1 请参阅 9.6.1 迁移系统配置一节。 Q16 我是 IBM i Access for Windows 的用户,可以将仿真概要文件迁移到 IBM i Access Client Solutions 吗? A16-1 请参阅 9.6.2 迁移 5250 仿真一节 Q17 我是 IBM i Access for Windows 的用户,可以将数据传输请求文件迁移到 IBM i Access Client Solutions 吗? A17-1 请参阅 9.6.3 迁移已保存的数据传输请求文件一节。 Q18 EHLLAPI 会与 IBM i Access Client Solutions 协同工作吗? A18-1 请参阅 9.6.4 EHLLAPI 一节 Q19 Kerberos 会与 IBM i Access Client Solutions 协同工作吗? A19-1 请参阅 9.6.5 Kerberos 一节 Q20 我是系统管理员,希望向我的用户隐藏某些功能。A20-1 请参阅 9.5 定制包一节 Q21 当我选择面板上的帮助图标时,未显示任何文本。A21-1 帮助文本通常显示在桌面浏览器中。在某些情况下,桌面可能没有浏览器,或者可能未正确配置浏览器。A21-2 要在不使用桌面浏览器的情况下显示帮助文本,请在 AcsConfig.properties 文件中 设置以下属性: com.ibm.iaccess.javaAwtDesktopAllowed=false 或者,可以像其他 Java 属性一样从命令行设置该属性,如下所示: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false Q22 使用数据传输时,我选择“活动 Excel 电子表格”或“活动 Calc 电子表格”作为输出设备,但发生以下错误: “找不到活动电子表格” Q22-1 不存在活动电子表格。请打开新的电子表格或现有电子表格, 然后,重试该请求。 Q22-2 您正在使用的电子表格应用应用程序与运行 IBM i Access Client Solutions 的 Java 虚拟机之间可能存在位数不匹配的情况。 请参阅 9.8 对 Excel 电子表格和 Calc 电子表格的数据传输支持一节 Q23 在 Mac 上使用数据传输时,我在输出设备中看不到任何用于与活动电子表格交互的 选项。Q23-1 由于 OpenOffice 应用程序与运行 IBM i Access Client Solutions 的 JVM 之间 存在位数不匹配的情况,所以在 Mac 上,数据传输无法与活动电子表格交互。有关其他 详细信息,请参阅 9.8 对 Excel 和 Calc 电子表格的数据传输支持一节。 Q24 使用数据传输时,我选择“活动 Calc 电子表格”作为输出设备,但“名称”框中 未显示任何内容。 Q24-1 Q24-1 对于从未保存的新 Calc 电子表格,这是正常情况。 数据传输将仍然能够使用下载的数据来更新该电子表格。

12.0 更新历史记录

请参阅以下 Web 页面:
IBM i Access Client Solutions (5733XJ1)