[IBM i]

IBM i 使用者結束程式上的範例 MFT

Managed File Transfer 會隨您的安裝提供 IBM® i 特定的範例使用者結束程式。 這些範例位在 MQMFT_install_dir/samples/ioexit-IBMiMQMFT_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" meta 資料欄位指定值(例如,使用 -md 參數)。 此參數會擷取檔案成員的 IFS 樣式的路徑,且可以包含檔案及成員萬用字元。 例如,/QSYS.LIB/FOO.LIB/BAR.FILE/*.MBR、/QSYS.LIB/FOO.LIB/*.FILE/BAR.MBR 及 /QSYS.LIB/FOO.LIB/*.FILE/*.MBR。

此範例結束程式還具有選用的 meta 資料欄位 "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" meta 資料指定 "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. 請重新啟動代理程式。