fteCreate環境 (設定 Redistributable Managed File Transfer Agent的環境)

fteCreateEnvironment 指令會設定 Redistributable Managed File Transfer Agent的檔案配置及傳送環境。

用途

您可以使用 fteCreateEnvironment 指令來設定環境，以使用 Redistributable Managed File Transfer Agent。

[MQ 9.2.1 2020 年 12 月] 從 IBM® MQ 9.2.1開始，此環境與 Redistributable Managed File Transfer Logger共用。

您可以搭配執行此指令與 -d 參數，以指定 MFT 代理程式資料檔案的位置。如果您未指定 -d 參數，則指令會在 Redistributable Managed File Transfer Agent 下載位置中建立資料檔，並設定資料路徑。

[MQ 9.2.0 2020 年 7 月] 從 IBM MQ 9.2.0， -n 參數可讓您選擇指定 IBM MQ 安裝名稱。您指定給此選項的值會用於從相同主控台階段作業執行的其餘 MFT 指令。

-d data_location

選用項目。在設定環境時，此參數用於指定資料檔的位置。

如果未指定此參數，則會在解壓縮 Redistributable Managed File Transfer Agent 的位置中建立資料目錄 (如果尚未存在) ，並為此位置設定環境變數 (BFG_DATA)。

-? 或 -h

選用項目。顯示指令語法。

-n installation_name

選用項目。此參數用於指定 IBM MQ 安裝的名稱或唯一名稱。唯一名稱必須遵循與 IBM MQ 安裝名稱相同的命名標準。如需命名標準的相關資訊，請參閱 AIX®, Linux®, and Windows上的安裝名稱。

您可能想要使用此參數的狀況範例如下:

如果您想要快速測試新功能或特性，請搭配使用可重新配送套件與現有的配置，其中代理程式已配置為僅以用戶端模式連接至佇列管理程式。 (請注意，此參數不適用於以連結模式配置連接至佇列管理程式的任何代理程式。)
如果您要從標準 Managed File Transfer 安裝架構移轉至 Redistributable Managed File Transfer Agent 套件，且您想要使用標準安裝架構所建立的相同配置。在這種情況下，已安裝標準 Managed File Transfer ，但正在連接另一部機器上執行的代理程式佇列管理程式。

預設安裝名稱變數為 BFG_INSTALLATION_NAME。

在此範例中，在 Windows上， -d 參數指定建立資料資料夾的位置:


fteCreateEnvironment -d C:\mftRedistributable\mftData

在 Linux上，作為必要條件，必須在 Bash Shell 上執行指令。在 Bash Shell 中，可以按不同方式執行此指令，但需要設定指令檔的來源。


source Path_of_MFTZipBin/fteCreateEnvironment

替代方法如下：

. Path_of_MFTZipBin/fteCreateEnvironment

或者，如果是從指令檔所在的目錄執行：

. ./fteCreateEnvironment

注意: 請注意第一個句點字元 (.) 後面的空格

此範例會建立一個環境，您可以在其中同時指定 MFT 配置資料路徑及安裝名稱環境變數:

fteCreateEnvironment -d C:/ProgramData/IBM/mq/mqft -n MFTPROD

此指令的輸出為:


5724-H72 Copyright IBM Corp. 2008, 2023.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ
BFG_INSTALLATION_NAME is MFTPROD

BFG_INSTALLATION_NAME 和 BFG_DATA 環境變數都會更新為新值。

此範例只會為安裝名稱建立新的環境變數。在 C:\ProgramData\IBM\MQ中，資料路徑保持不變。

fteCreateEnvironment -n MFTPROD

指令的輸出為:


5724-H72 Copyright IBM Corp. 2008, 2023.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ
BFG_INSTALLATION_NAME is MFTPROD

BFG_INSTALLATION_NAME 環境變數會更新為新值 MFTPROD。

此範例只會為 MFT 配置資料的路徑建立新的環境變數。安裝名稱在 MFTPROD中保持不變:

fteCreateEnvironment -d C:/ProgramData/IBM/MQ2

指令的輸出為:


5724-H72 Copyright IBM Corp. 2008, 2023.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ2
BFG_INSTALLATION_NAME is MFTPROD