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 のファイル・パスを指定する場合は、区切り文字のバックスラッシュ (¥) が 2 つのバックスラッシュ (¥¥) で入力されていること、つまり、バックスラッシュ (¥) がエスケープされていることを確認してください。あるいは、単一のスラッシュ文字 (/) を区切り文字として使用することもできます。 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 MQMQOD構造体の'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 メッセージが、MQSTR の MQMD 形式フィールドとともにキューに送信されます。 MQMD 形式フィールドが MQSTR に設定されている場合、データ変換が有効になっている MQ ネットワーク内にチャネルが存在すると、 Managed File Transfer コマンド XML メッセージが破損する可能性があります。	false

表 6. 拡張コマンド・プロパティー: セキュリティー
プロパティー名	説明	デフォルト値
userIdForClientConnect	IBM MQへのクライアント接続を介してフローされるユーザー ID。 `java` が指定されている場合、JVM によって報告されるユーザー名は、 IBM MQ 接続要求の一部として渡されます。このプロパティーの値は None または java のいずれかになります。	なし
connectionQMgrAuthenticationCredentialsFile	コマンド・キュー・マネージャーに接続するための MQ 接続資格情報が入ったファイルへのパス。	「 Configuring MQMFTCredentials.xml on Multiplatforms 」および「 Configuring MQMFTCredentials.xml on z/OS®」を参照してください。認証資格情報ファイルの作成について詳しくは、 MFT および IBM MQ の接続認証を参照してください。

表 7. 拡張コマンド・プロパティー: SSL/TLS
プロパティー名	説明	デフォルト値
connectionSslCipherSpec	コマンドとコマンド・キュー・マネージャー間でのデータの交換時に使用されるプロトコル、ハッシュ・アルゴリズム、および暗号化アルゴリズムと、そのときに暗号鍵で使用されるビット数を指定します。 connectionSslCipherSpec の値は、CipherSpec 名です。この CipherSpec 名は、コマンド・キュー・マネージャー・チャネルで使用されている名前と同じです。有効なCipherSpec名のリストは、' Javaの 'IBM MQクラスの SSL/TLSCipherSpecsとCipherSuites、およびJMS の 'IBM MQクラスの SSL/TLSCipherSpecsと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