MFT command.properties 檔案

command.properties 檔案指定當您發出指令時要連接的指令佇列管理程式，以及 Managed File Transfer 聯絡該佇列管理程式所需的資訊。

command.properties 檔由安裝程式或 fteSetupCommands 指令建立。 您可以搭配使用 fteSetupCommands 指令與 -f 旗標，以變更此檔案的基本指令佇列管理程式內容。 若要變更或新增進階指令佇列管理程式內容，您必須在文字編輯器中編輯檔案。

部分 Managed File Transfer 指令會連接至代理程式佇列管理程式或協調佇列管理程式，而不是指令佇列管理程式。 如需哪些指令連接至哪個佇列管理程式的相關資訊，請參閱 哪些 MFT 指令連接至哪個佇列管理程式。

command.properties 檔案位於 MQ_DATA_PATH/mqft/config/coordination_qmgr_name 目錄中。

command.properties 檔包含下列值：
表 1. 基本指令佇列管理程式內容
內容名稱 說明 預設值
connectionQMgr 用來連接至 IBM® MQ 網路的佇列管理程式名稱。 無預設值
connectionQMgrHost 連線佇列管理程式的主機名稱或 IP 位址。 無預設值
connectionQMgrPort 在用戶端模式中用來連接至連線佇列管理程式的埠號。 1414
connectionQMgrChannel 用來連接至連線佇列管理程式的 SVRCONN 通道名稱。 SYSTEM.DEF.SVRCONN

如果未指定 connectionQMgrHost 內容的值，則預設會使用連結模式。

如果指定了 connectionQMgrHost 內容的值，但未指定 connectionQMgrPort 及 connectionQMgrChannel 內容的值，則預設會使用 1414 埠號及 SYSTEM.DEF.SVRCONN 通道。

表 2. 進階指令佇列管理程式內容
內容名稱 說明 預設值
字碼頁內容：
connectionCcsid 指令用來連接至指令佇列管理程式的字碼頁。 如果指定 connectionCcsid 的值，您也必須指定 connectionCcsidName 的值。 1208
connectionCcsidName connectionCcsid 的 Java 表示法。 如果指定 connectionCcsidName 的值，您也必須指定 connectionCcsid 的值。 UTF8
多重實例佇列管理程式內容：
connectionQMgrStandby 針對 connectionQMgr 內容所定義的多重實例指令佇列管理程式的待命實例，用於用戶端連線的主機名稱及埠號，採用 IBM MQ CONNAME 格式。 例如，host_name(port_number) 無預設值
安全內容：
userIdForClientConnect 透過用戶端連線傳送至 IBM MQ的使用者 ID。 如果指定 java ，則會隨著 IBM MQ 連線要求而傳送 JVM 所報告的使用者名稱。 此內容值可以是無或 java。 無
connectionQMgrAuthenticationCredentialsFile 包含用於指令佇列管理程式連線之 MQ 連線認證的檔案路徑。

[z/OS]如需建立「鑑別認證檔」的詳細資料，請參閱 在 z/OS® 上配置 MQMFTCredentials.xml。

[UNIX、Linux、Windows]如需此檔案的位置和許可權的相關資訊，請參閱 配置 MQMFTCredentials.xml 。

[UNIX、Linux、Windows]建立「鑑別認證檔」的進一步詳細資料位於 MFT 及 IBM MQ 連線鑑別 中。
佇列內容:
dynamicQueuePrefix 對於需要代理程式回應的指令，此內容定義用於產生暫時回覆佇列名稱的 IBM MQ 字首。

dynamicQueuePrefix 內容的格式遵循 IBM MQ MQOD 結構的 DynamicQName 欄位格式。 如需相關資訊，請參閱 建立動態佇列。

如果您想要對 WMQFTE 所產生的暫時佇列使用特定的 IBM MQ 字首，您也可以在 coordination.properties 檔中定義此內容。

 WMQFTE.*
modelQueueName 對於需要代理程式回應的指令，此內容定義用於產生暫時回覆佇列的 IBM MQ 模型佇列。

如果您想要對 WMQFTE 所產生的暫時佇列使用特定的 IBM MQ 模型佇列，也可以在 coordination.properties 檔案中定義此內容。 如需相關資訊，請參閱 MFT coordination.properties 檔案。

 SYSTEM.DEFAULT.MODEL.QUEUE
連線內容：
javaLibraryPath 以連結模式連接至佇列管理程式時， Managed File Transfer 必須具有 IBM MQ Java 連結程式庫的存取權。 依預設， Managed File Transfer 會在 IBM MQ所定義的預設位置中尋找連結程式庫。 如果連結程式庫位於不同位置，請使用此內容來指定連結程式庫的位置。 /opt/mqm/java/lib
[z/OS]legacyXMLMessageMQMDFormat [z/OS]

Managed File Transfer 指令 XML 訊息現在會傳送至具有空白 MQMD 格式欄位的佇列。 舊版的產品將 MQMD 格式欄位設為 MQSTR（文字訊息字串）。 將此內容設為 true 可將 Managed File Transfer 指令 XML 訊息傳送至 MQMD 格式欄位為 MQSTR 的佇列。

如果 MQMD 格式欄位設為 MQSTR ，且 MQ 網路中有通道已啟用資料轉換，則 Managed File Transfer 指令 XML 訊息可能會毀損。

 [z/OS]false
代理程式內容    
failCleanAgentWithNoArguments 依預設，此內容的值為 true，這表示如果僅指定代理程式名稱參數，則 fteCleanAgent 指令無法執行。 如果將此內容設為 false，則表示如果僅設定代理程式名稱參數，則 fteCleanAgent 指令的行為等價於指定 -all 參數。 true

如需 SSL 內容，請參閱 MFT 的 SSL 內容。

以下是 command.properties 檔案的內容範例:

connectionQMgr=PLUTO
connectionQMgrHost=kuiper.example.com
connectionQMgrPort=1930
connectionQMgrChannel=SYSTEM.DEF.SVRCONN
在此範例中， PLUTO 是位於系統 kuiper.example.com上的 IBM MQ 佇列管理程式名稱。 佇列管理程式 PLUTO 是 Managed File Transfer 指令所連接的佇列管理程式。