fteSetup指令 (建立 MFT command.properties 檔)

fteSetupCommands 指令會建立 Managed File Transfer command.properties 檔案。 此內容檔指定當您發出指令時連接至 IBM® MQ 網路之佇列管理程式的詳細資料。

重要事項: [AIX、Linux、Windows]在 IBM MQ for AIX®, Linux®, and Windows上，只有身為 IBM MQ 管理者 (及 mqm 群組成員) 的使用者才能執行此指令。 如果您嘗試以非 IBM MQ 管理者的使用者身分執行此指令，則會收到錯誤訊息BFGCL0502E: You are not authorized to perform the requested operation.指令將不會執行。
[z/OS]在 z/OS® 系統上，使用者必須滿足 (至少) 下列其中一個條件，才能執行指令:
  • 是 mqm 群組的成員（如果 mqm 群組已定義在系統上）。
  • 是 BFG_GROUP_NAME 環境變數所指名之群組的成員（如果已指名群組的話）。
  • 指令執行時，BFG_GROUP_NAME 環境變數中未設定任何值。

用途

使用 fteSetupCommands 指令，可在協調佇列管理程式配置目錄中建立 command.properties 檔案。 此指令使用 MQ_DATA_PATH 環境變數和 installation.properties 檔案，來決定 command.properties 檔案所在的位置。 發出 fteSetupCommands 指令之前，請確定您已建立及配置協調佇列管理程式。

如需內容檔的相關資訊，請參閱 MFT command.properties 檔案。

Syntax

fteSetupCommands

Read syntax diagramSkip visual syntax diagramfteSetupCommands -connectionQMgr connection_qmgr_name-connectionQMgrHostconnection_qmgr_host-connectionQMgrPortconnection_qmgr_port-connectionQMgrChannelconnection_qmgr_channel-credentialsFilefile_path-useriduser_id-pconfiguration_options-f

參數

-connectionQMgr 連線佇列管理程式名稱
必要項目。 用來連接至 IBM MQ 網路以發出指令的佇列管理程式名稱。
-connectionQMgr主機 connection_qmgr_host
選用項目。 連線佇列管理程式的主機名稱或 IP 位址。

如果未指定 -connectionQMgrHost 參數，則會採用連結模式連線。 因此，如果要使用用戶端模式連線，此參數是必要項目。

如果您指定-connectionQMgr主機參數的值，但未指定 -connectionQMgrPort 及 -connectionQMgrChannel 內容的值，則埠號為 1414 ，通道為 SYSTEM.DEF.SVRCONN 。

-connectionQMgr埠 connection_qmgr_port
選用項目。 在用戶端模式中用來連接至連線佇列管理程式的埠號。 如果指定了 -connectionQMgrPort 參數，則必須同時指定 -connectionQMgrHost 參數。
-connectionQMgr通道 connection_qmgr_channel
選用項目。 用來連接至連線佇列管理程式的通道名稱。 如果指定了 -connectionQMgrChannel 參數，則必須同時指定 -connectionQMgrHost 參數。
-p configuration_options
選用項目。 此參數決定一組用來設定指令佇列管理程式的配置選項。 請使用非預設協調佇列管理程式的名稱作為此參數的輸入。 然後，fteSetupCommands 指令即會使用與此非預設協調佇列管理程式相關聯的一組內容檔。

如果未指定此參數，則會使用一組以預設協調佇列管理程式為基礎的配置選項。

-credentialsFile 檔案路徑
選用項目。 現有或新認證檔的完整檔案路徑， IBM MQ 鑑別詳細資料會新增至其中。

此指令支援將一組 IBM MQ 鑑別詳細資料新增至具名 Managed File Transfer 認證檔。 當已啟用 IBM MQ 連線鑑別時，請使用這個指令。 如果更新現有的詳細資料，則必須使用 -f 強制參數。

-userid user_id
選用項目。 用來與認證詳細資料相關聯的使用者 ID。 如果未指定使用者 ID，則認證詳細資料將套用至所有使用者。 您還必須指定 -credentialsFile 參數。
-f
選用項目。 強制以此指令中指定的詳細資料來改寫現有的 command.properties 檔。
-? 或 -h
選用項目。 顯示指令語法。

範例


fteSetupCommands -connectionQMgr QM_NEPTUNE -connectionQMgrHost 9.146.157.241
-connectionQMgrPort 1414 -connectionQMgrChannel SYSTEM.DEF.SVRCONN

回覆碼

0
指令已順利完成。
1
指令未順利結束。