MFT 的样本 Ant 任务

安装 Managed File Transfer时提供了许多样本 Ant 脚本。 这些样本位于目录 MQ_INSTALLATION_PATH/mqft/samples/fteant 中。 每个样本脚本都包含一个 init 目标，请编辑 init 目标中设置的属性以使用您的配置运行这些脚本。

email

email 样本演示了如何使用 Ant 任务来传输文件，并在传输失败时将电子邮件发送到指定的电子邮件地址。 该脚本通过使用 Managed File Transfer ping 任务来检查源和目标代理是否处于活动状态并能够处理传输。 如果这两个代理都处于活动状态，那么脚本将使用 Managed File Transfer fte: filecopy 任务在源代理和目标代理之间传输文件，而不删除原始文件。 如果传输失败，那么脚本将使用标准 Ant email 任务发送包含失败信息的电子邮件。

hub

hub 样本由以下两个脚本组成：hubcopy.xml 和 hubprocess.xml.。hubcopy.xml 脚本显示了如何使用 Ant 脚本编制来构建“中心和辐射”样式的拓扑。 在该样本中，将两个文件从辐条机器上运行的代理传输到集线器机器上运行的代理。 将同时传输这两个文件，在传输完成后，将在中心机器上运行 hubprocess.xml Ant 脚本来处理这些文件。 如果这两个文件都传输正确，那么 Ant 脚本会并置文件的内容。 如果文件未正确传输，那么 Ant 脚本会通过删除已传输的任何文件数据来进行清除。 要使此示例正常工作，必须将 hubprocess.xml 脚本放在中心代理的命令路径上。 有关设置代理程序的命令路径的更多信息，请参阅 commandPath MFT 属性。
[IBM i]

librarytransfer (仅限IBM i 平台)

[IBM i]librarytransfer 样本演示如何使用 Ant 任务将一个 IBM i 系统上的 IBM® i 库传输到另一个 IBM i 系统。

IBM i 上的 [IBM i]IBM WebSphere® MQ File Transfer Edition 7.0.2 不包含对本机 IBM i 库对象传输的直接支持。 librarytransfer 样本将 IBM i 上的本机保存文件支持与 Managed File Transfer 中提供的预定义 Ant 任务配合使用，以在两个 IBM i 系统之间传输本机库对象。 The sample uses a <presrc> nested element in a Managed File Transfer filecopy task to invoke an executable script librarysave.sh that saves the requested library on the source agent system into a temporary save file. The save file is moved by the filecopy ant task to the destination agent system where a <postdst> nested element is used to invoke the executable script libraryrestore.sh to restore the library saved in the save file to the destination system.

[IBM i]在运行此样本之前，需要完成一些配置，如 librarytransfer.xml 文件中所述。 您还必须在两台 IBM i 机器上具有有效的 Managed File Transfer 环境。 设置必须由在第一台 IBM i 机器上运行的源代理和在第二台 IBM i 机器上运行的目标代理组成。 两个代理必须能够彼此通信。

[IBM i]librarytransfer 样本包含以下三个文件：
  • librarytransfer.xml
  • librarysave.sh（<presrc> 可执行脚本）
  • libraryrestore.sh（<postdst> 可执行脚本）
这些样本文件位于以下目录中：/QIBM/ProdData/WMQFTE/V7/samples/fteant/ibmi/librarytransfer
[IBM i] 要运行该样本，用户必须完成以下步骤：
  1. 启动 Qshell 会话。 在 IBM i 命令窗口中，输入：STRQSH
  2. 将目录切换到 bin 目录，如下所示：
    cd  /QIBM/ProdData/WMQFTE/V7/bin
  3. 在完成所需配置后，通过使用以下命令运行该样本：
    fteant -f /QIBM/ProdData/WMQFTE/V7/samples/fteant/ibmi/librarytransfer/librarytransfer.xml

[IBM i]

physicalfiletransfer (仅限IBM i 平台)

physicalfiletransfer 样本演示如何使用 Ant 任务将源物理文件或数据库文件从一个 IBM i 系统上的库传输到另一个 IBM i 系统上的库。

IBM i 上的 [IBM i]IBM WebSphere MQ File Transfer Edition 7.0.2 不包含对 IBM i 上本机源物理文件或数据库文件传输的直接支持。 physicalfiletransfer 样本使用 IBM i 上的本机保存文件支持以及 Managed File Transfer 中提供的预定义 Ant 任务，在两个 IBM i 系统之间传输完整的源物理文件和数据库文件。 The sample uses a <presrc> nested element within a Managed File Transfer filecopy task to invoke an executable script physicalfilesave.sh to save the requested Source Physical or Database file from a library on the source agent system into a temporary save file. The save file is moved by the filecopy ant task to the destination agent system where a <postdst> nested element is used to invoke the executable script physicalfilerestore.sh then restores the file object inside the save file into a specified library on the destination system.

[IBM i]在运行此样本之前，必须完成一些配置，如 physicalfiletransfer.xml 文件中所述。 您还必须在两个 IBM i 系统上具有有效的 Managed File Transfer 环境。 设置必须由在第一个 IBM i 系统上运行的源代理和在第二个 IBM i 系统上运行的目标代理组成。 两个代理必须能够彼此通信。

[IBM i]physicalfiletransfer 样本包含以下三个文件：
  • physicalfiletransfer.xml
  • physicalfilesave.sh（<presrc> 可执行脚本）
  • physicalfilerestore.sh（<postdst> 可执行脚本）
这些样本文件位于以下目录中：/QIBM/ProdData/WMQFTE/V7/samples/fteant/ibmi/physicalfiletransfer
[IBM i]要运行该样本，用户必须完成以下步骤：
  1. 启动 Qshell 会话。 在 IBM i 命令窗口中，输入：STRQSH
  2. 将目录切换到 bin 目录，如下所示：
    cd  /QIBM/ProdData/WMQFTE/V7/bin
  3. 在完成所需配置后，通过使用以下命令运行该样本：
    fteant -f /QIBM/ProdData/WMQFTE/V7/samples/fteant/ibmi/physicalfiletransfer/physicalfiletransfer.xml

timeout

timeout 样本演示如何使用 Ant 任务尝试文件传输，并在花费时间长于指定的超时值时取消传输。 该脚本通过使用 Managed File Transfer fte: filecopy 任务来启动文件传输。 将延迟该传输的结果。 该脚本使用 Managed File Transfer fte: await结局 Ant 任务 来等待给定秒数以完成传输。 如果传输未在给定时间内完成，那么将使用 Managed File Transfer fte: cancel Ant 任务 来取消文件传输。
[z/OS]

vsamtransfer

[z/OS] vsamtransfer 样本演示如何使用 Ant 任务通过 Managed File Transfer从 VSAM 数据集传输到另一 VSAM 数据集。 Managed File Transfer 当前不支持传输 VSAM 数据集。 样本脚本通过使用 presrc 程序调用嵌套元素 来调用可执行文件 datasetcopy.sh，将 VSAM 数据记录卸载到连续数据集。 该脚本使用 Managed File Transfer fte: filemove 任务将顺序数据集从源代理传输到目标代理。 然后，该脚本使用 postdst 程序调用嵌套元素 来调用 loadvsam.jcl 脚本。 该 JCL 脚本会将传输的数据集记录装入目标 VSAM 数据集。 该样本对目标调用使用 JCL 以演示该语言选项。 通过使用第二个 shell 脚本也可以获得相同的结果。

[z/OS]该样本不需要源和目标数据集是 VSAM。 如果源和目标数据集的类型相同，那么该样本对任何数据集都有效。

[z/OS]要使此样本正常工作，必须将 datasetcopy.sh 脚本放在源代理的命令路径上，将 loadvsam.jcl 脚本放在目标代理的命令路径上。 有关设置代理程序的命令路径的更多信息，请参阅 commandPath MFT 属性。

zip

zip 样本由以下两个脚本组成：zip.xml 和 zipfiles.xml。 该样本演示在执行文件传输移动操作之前如何使用 Managed File Transfer fte: filemove 任务中的 presrc 嵌套元素来运行 Ant 脚本。 由 zip.xml 脚本中的 presrc 嵌套元素调用的 zipfiles.xml 脚本会压缩目录的内容。 zip.xml 脚本将传输压缩文件。 此样本要求 zipfiles.xml Ant 脚本存在于源代理的命令路径上。 这是因为 zipfiles.xml Ant 脚本包含用于压缩源代理上的目录内容的目标。 有关设置代理程序的命令路径的更多信息，请参阅 commandPath MFT 属性。