[IBM i]

IBM i 用户出口上的样本 MFT

Managed File Transfer 提供了特定于安装的 IBM® i 的样本用户出口。 样本位于目录 MQMFT_install_dir/samples/ioexit-IBMi 和 MQMFT_install_dir/samples/userexit-IBMi 中。

com.ibm.wmqfte.exit.io.ibmi.qdls.FTEQDLSExit
com.ibm.wmqfte.exit.io.ibmi.qdls.FTEQDLSExit 样本用户出口在 IBM i上的 QDLS 文件系统中传输文件。 在安装出口后，对以 /QDLS 开头的文件的任何传输都会自动使用该出口。

要安装该出口，请完成以下步骤：

  1. 将 com.ibm.wmqfte.samples.ibmi.ioexits.jar 文件从 WMQFTE_install_dir/samples/ioexit-IBMi 目录复制到代理程序的 exits 目录。
  2. 将 com.ibm.wmqfte.exit.io.ibmi.qdls.FTEQDLSExit 添加到 IOExitClasses 属性。
  3. 重新启动代理。
com.ibm.wmqfte.exit.user.ibmi.FileMemberMonitorExit
com.ibm.wmqfte.exit.user.ibmi.FileMemberMonitorExit 样本用户出口的行为类似于 MFT 文件监视器，并自动从 IBM i 库传输物理文件成员。

要运行此出口，请指定“library.qsys.monitor”元数据字段的值（例如，使用 -md 参数）。 该参数采用文件成员的 IFS 样式路径，并且可以包含文件和成员通配符。 例如，/QSYS.LIB/FOO.LIB/BAR.FILE/*.MBR、/QSYS.LIB/FOO.LIB/*.FILE/BAR.MBR、/QSYS.LIB/FOO.LIB/*.FILE/*.MBR。

该样本出口还具有一个可选元数据字段“naming.scheme.qsys.monitor”，此字段可用于确定传输期间使用的命名方案。 缺省情况下，此字段设置为“unix”，这会导致将目标文件称为 FOO.MBR。 您还可以指定值 "ibmi" 以使用 IBM i FTP FILE.MEMBER 方案，例如 /QSYS.LIB/FOO.LIB/BAR.FILE/BAZ.MBR 作为 BAR.BAZ。

要安装该出口，请完成以下步骤：
  1. 将 com.ibm.wmqfte.samples.ibmi.userexits.jar 文件从 WMQFTE_install_dir/samples/userexit-IBMi 目录复制到代理程序的 exits 目录。
  2. 将 com.ibm.wmqfte.exit.user.ibmi.FileMemberMonitorExit 添加到 agent.properties 文件中的 sourceTransferStartExitClasses 属性。
  3. 重新启动代理。
com.ibm.wmqfte.exit.user.ibmi.EmptyFileDeleteExit
当在传输期间删除源文件成员时，com.ibm.wmqfte.exit.user.ibmi.EmptyFileDeleteExit 样本用户出口将删除空文件对象。 由于 IBM i 文件对象可能包含许多成员，因此 MFT会将文件对象视为目录。 因此，无法使用 MFT对文件对象执行移动操作; 仅在成员级别支持移动操作。 因此，在对成员执行移动操作时，当前的空文件会遗留下来。 如果希望在传输请求期间删除这些空文件，请使用该样本出口。

当为“empty.file.delete”元数据字段指定“true”并传输 FTEFileMember 时，如果父文件为空，该样本出口将删除该文件。

要安装该出口，请完成以下步骤：
  1. 将 com.ibm.wmqfte.samples.ibmi.userexits.jar 文件从 WMQFTE_install_dir/samples/userexit-IBMi 复制到代理程序的 exits 目录。
  2. 将 com.ibm.wmqfte.exit.user.ibmi.EmptyFileDeleteExit 添加到 agent.properties 文件中的 sourceTransferStartExitClasses 属性。
  3. 重新启动代理。