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 目錄中。

MFT command.properties 檔案包含下列值:

表 1. 基本指令佇列管理程式內容
內容名稱	說明	預設值
connectionCredentialsKeyFile	包含加密認證時所使用認證金鑰的檔案名稱。	沒有預設值的字串內容。
connectionQMgr	用來連接至 IBM® MQ 網路的佇列管理程式名稱。	無預設值
connectionQMgrHost	連線佇列管理程式的主機名稱或 IP 位址。	無預設值
connectionQMgrPort	在用戶端模式中用來連接至連線佇列管理程式的埠號。	1414
connectionQMgrChannel	用來連接至連線佇列管理程式的 SVRCONN 通道名稱。	SYSTEM.DEF.SVRCONN

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

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

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


connectionQMgr=PLUTO
connectionQMgrHost=kuiper.example.com
connectionQMgrPort=1930
connectionQMgrChannel=SYSTEM.DEF.SVRCONN

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

進階指令內容

Managed File Transfer 也提供更進階的指令內容。如果您想要使用下列任何內容，請手動編輯 command.properties 檔案，以新增必要的進階內容。當您在 Windows上指定檔案路徑時，請確保將分隔字元反斜線 (\) 輸入為雙反斜線 (\\) ，即跳出反斜線 (\)。或者，您可以使用單一正斜線 (/) 字元作為分隔字元。如需 Java 內容檔中字元跳出的相關資訊，請參閱 Oracle 說明文件 Properties 類別的 Javadoc。

代理程式內容
字碼頁內容
多重實例佇列管理程式內容
佇列內容
安全內容
SSL 內容

表 2. 進階指令內容: 代理程式
內容名稱	說明	預設值
failCleanAgentWithNoArguments	依預設，此內容的值為 true，這表示如果僅指定代理程式名稱參數，則 fteCleanAgent 指令無法執行。如果將此內容設為 false，則表示如果僅設定代理程式名稱參數，則 fteCleanAgent 指令的行為等價於指定 -all 參數。	true

表 3. 進階指令內容: 字碼頁
內容名稱	說明	預設值
connectionCcsid	指令用來連接至指令佇列管理程式的字碼頁。如果指定 connectionCcsid 的值，您也必須指定 connectionCcsidName 的值。	1208
connectionCcsidName	connectionCcsid 的 Java 表示法。如果指定 connectionCcsidName 的值，您也必須指定 connectionCcsid 的值。	UTF8

表 4. 進階連線內容: 多重實例佇列管理程式
內容名稱	說明	預設值
connectionQMgrStandby	針對 connectionQMgr 內容所定義的多重實例指令佇列管理程式的待命實例，用於用戶端連線的主機名稱及埠號，採用 IBM MQ CONNAME 格式。例如，`host_name(port_number)`	無預設值

表 5. 進階指令內容: 佇列
內容名稱	說明	預設值
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
legacyXMLMessageMQMDFormat	Managed File Transfer 指令 XML 訊息現在會傳送至具有空白 MQMD 格式欄位的佇列。舊版的產品將 MQMD 格式欄位設為 MQSTR（文字訊息字串）。將此內容設為 true 可將 Managed File Transfer 指令 XML 訊息傳送至 MQMD 格式欄位為 MQSTR 的佇列。如果 MQMD 格式欄位設為 MQSTR ，且 MQ 網路中有通道已啟用資料轉換，則 Managed File Transfer 指令 XML 訊息可能會毀損。	false

表 6. 進階指令內容: 安全
內容名稱	說明	預設值
userIdForClientConnect	透過用戶端連線傳送至 IBM MQ的使用者 ID。如果指定 `java` ，則會隨著 IBM MQ 連線要求而傳送 JVM 所報告的使用者名稱。此內容值可以是無或 java。	無
connectionQMgrAuthenticationCredentialsFile	包含用於指令佇列管理程式連線之 MQ 連線認證的檔案路徑。	請參閱在 Multiplatforms 上配置 MQMFTCredentials.xml 和在上配置 MQMFTCredentials.xml z/OS®。建立「鑑別認證檔」的進一步詳細資料位於 MFT 及 IBM MQ 連線鑑別中。

表 7. 進階指令內容: SSL/TLS
內容名稱	說明	預設值
connectionSslCipherSpec	指定在指令與指令佇列管理程式之間交換資料時所使用的通訊協定、雜湊演算法及加密演算法，以及加密金鑰中使用的位元數。 connectionSslCipherSpec 的值是 CipherSpec 名稱。此 CipherSpec 名稱與指令佇列管理程式通道上使用的 CipherSpec 名稱相同。有效 CipherSpec 名稱的清單包括在 Java 的 IBM MQ 類別中的 SSL/TLS CipherSpecs 和 CipherSuites 和 JMS 的 IBM MQ 類別中的 SSL/TLS CipherSpecs 和 CipherSuites中。 connectionSslCipherSpec 與 connectionSslCipherSuite 類似。如果同時指定 connectionSslCipherSuite 及 connectionSslCipherSpec，則會使用 connectionSslCipherSpec 的值。	無
connectionSslCipherSuite	指定關於指令與指令佇列管理程式如何交換資料的各種 SSL 觀點。 connectionSslCipherSuite 的值是 CipherSuite 名稱。此 CipherSuite 名稱對映至代理程式佇列管理程式通道上使用的 CipherSpec 名稱。如需相關資訊，請參閱 CipherSuite 及 CipherSpec 名稱對映。 connectionSslCipherSuite 與 connectionSslCipherSpec 類似。如果同時指定 connectionSslCipherSuite 及 connectionSslCipherSpec，則會使用 connectionSslCipherSpec 的值。	無
connectionSslPeerName	指定必須符合指令佇列管理程式所提供名稱的識別名稱架構。識別名稱用來檢查指令佇列管理程式在連線時提供的識別憑證。	無
connectionSslTrustStore	指定指令信任的憑證位置。 connectionSslTrustStore 的值是檔案路徑。如果是 Windows 檔案路徑，則反斜線字元 (\) 必須跳出 (\\)。從 IBM WebSphere® MQ 7.5開始，此內容的值可以包含環境變數。	無
connectionSslTrustStoreType	您想要使用的 SSL 信任儲存庫類型。支援 JKS 及 PKCS#12 金鑰儲存庫。此內容值可以是 jks 或 pkcs12。	jks
connectionSslTrustStoreCredentialsFile	包含 connectionSslTrustStore 認證的檔案路徑。從 IBM WebSphere MQ 7.5開始，此內容的值可以包含環境變數。	在 Windows 上，此內容的預設值為 %USERPROFILE%\MQMFTCredentials.xml ，在其他平台上，則為 $HOME/MQMFTCredentials.xml 。
connectionSslKeyStore	指定指令的私密金鑰位置。 connectionSslKeyStore 的值是檔案路徑。如果它是 Windows 檔案路徑，則反斜線字元 (\) 必須跳出 (\\)。只有在指令佇列管理程式需要用戶端鑑別時，才需要此內容。從 IBM WebSphere MQ 7.5開始，此內容的值可以包含環境變數。	無
connectionSslKeyStoreType	您想要使用的 SSL 金鑰儲存庫類型。支援 JKS 及 PKCS#12 金鑰儲存庫。此內容值可以是 jks 或 pkcs12。從 IBM WebSphere MQ 7.5開始，此內容的值可以包含環境變數。	jks
connectionSslKeyStoreCredentialsFile	包含 connectionSslKeyStore 認證的檔案路徑。從 IBM WebSphere MQ 7.5開始，此內容的值可以包含環境變數。	在 Windows 上，此內容的預設值為 %USERPROFILE%\MQMFTCredentials.xml ，在其他平台上，則為 $HOME/MQMFTCredentials.xml 。
connectionSslFipsRequired	指定您想要在指令佇列管理程式層次上啟用 FIPS 支援。此內容值可以是 true 或 false。如需相關資訊，請參閱 MFT 中的 FIPS 支援。	false