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

librarytransfer (仅限IBM i 平台)

[IBM i]库转移示例演示了如何使用 "Ant任务将一个 "IBM i系统上的 "IBM® i库转移到第二个 "IBM i系统上。

[IBM i]Librarytransfer 示例使用 IBM i 上的本地保存文件支持和 Managed File Transfer 中的预定义 Ant 任务,在两个 IBM i 系统之间传输本地库对象。 该示例使用 Managed File Transfer filecopy 任务中的 <presrc> 嵌套元素调用可执行脚本 librarysave.sh ,将源代理系统上请求的库保存到临时保存文件中。 保存文件由 filecopy ant 任务移动到目标代理系统,在该系统中使用 <postdst> 嵌套元素调用可执行脚本 libraryrestore.sh ,将保存在保存文件中的库恢复到目标系统。

[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 上的本地保存文件支持和 Managed File Transfer 中提供的预定义 Ant 任务,在两个 IBM i 系统之间传输完整的源物理文件和数据库文件。 该示例使用 Managed File Transfer filecopy 任务中的 <presrc> 嵌套元素调用可执行脚本 physicalfilesave.sh ,将请求的源物理文件或数据库文件从源代理系统上的库保存到临时保存文件中。 保存文件由 filecopy ant 任务移动到目标代理系统,在该系统中使用 <postdst> 嵌套元素调用可执行脚本 physicalfilerestore.sh ,然后将保存文件中的文件对象还原到目标系统的指定库中。

[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 示例演示了如何使用 任务,通过 从一个 VSAM 数据集传输到另一个 VSAM 数据集。 Ant Managed File Transfer Managed File Transfer目前不支持传输 VSAM 数据集。 示例脚本使用presrc程序调用嵌套元素调用可执行文件datasetcopy.sh。 该脚本使用Managed File Transferfte:文件移动将顺序数据集从源代理传输到目标代理的任务。 然后脚本使用postdst程序调用嵌套元素调用loadvsam.jcl脚本。 该 JCL 脚本会将传输的数据集记录装入目标 VSAM 数据集。 该样本对目标调用使用 JCL 以演示该语言选项。 通过使用第二个 shell 脚本也可以获得相同的结果。

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

[z/OS]要使该示例正常工作,必须将 datasetcopy.sh 脚本放在源代理的命令路径上,将 loadvsam.jcl 脚本放在目标代理的命令路径上。 有关设置代理命令路径的详细信息,请参阅commandPathMFT财产

zip

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