MFT coordination.properties ファイル

coordination.properties ファイルは、調整キュー・マネージャーとの接続の詳細を指定します。 複数の Managed File Transfer インストール済み環境で同じ調整キュー・マネージャーが共用される場合があるため、共用ドライブ上の共通の coordination.properties ファイルへのシンボリック・リンクを使用できます。

coordination.properties ファイルは、インストーラーまたは fteSetupCoordination コマンドにより作成されます。 fteSetupCoordination コマンドを、-f フラグと共に使用して、このファイルの基本調整キュー・マネージャー・プロパティーを変更できます。 拡張調整キュー・マネージャー・プロパティーを変更または追加するには、テキスト・エディターでファイルを編集する必要があります。

coordination.properties ファイルは MQ_DATA_PATH/mqft/config/coordination_qmgr_name ディレクトリーにあります。

MFT coordination.properties ファイルには以下の値が含まれます。
表 1. 基本調整キュー・マネージャー・プロパティー
プロパティー名 説明 デフォルト値
[MQ 9.2.0 Jul 2020]coordinationCredentialsKeyFile 資格情報の暗号化の際に使用される資格情報キーが含まれるファイルの名前。 ストリング・プロパティーにデフォルト値はありません。
coordinationQMgr 調整キュー・マネージャーの名前。 デフォルトなし
coordinationQMgrHost 調整キュー・マネージャーのホスト名または IP アドレス。 デフォルトなし
coordinationQMgrPort 調整キュー・マネージャーとのクライアント接続で使用されるポート番号。 1414
coordinationQMgrChannel 調整キュー・マネージャーとの接続に使用される SVRCONN チャネル名。 SYSTEM.DEF.SVRCONN

coordinationQMgrHost プロパティーの値を指定しない場合は、デフォルトでバインディング・モードが使用されます。

coordinationQMgrHost プロパティーに値を指定し、coordinationQMgrPort および coordinationQMgrChannel プロパティーには値を指定しない場合、ポート番号 1414 およびチャネル SYSTEM.DEF.SVRCONN がデフォルトで使用されます。

以下は、coordination.properties ファイルの内容の例です。
coordinationQMgr=ERIS
coordinationQMgrHost=kuiper.example.com
coordinationQMgrPort=2005
coordinationQMgrChannel=SYSTEM.DEF.SVRCONN
この例での ERIS は、システム kuiper.example.com にあるIBM® MQ キュー・マネージャーの名前です。 キュー・マネージャー ERIS は、 Managed File Transfer がログ情報を送信する先のキュー・マネージャーです。

拡張調整プロパティー

Managed File Transfer は、さらに拡張調整プロパティーも提供します。 以下のプロパティーのいずれかを使用する場合は、coordination.properties ファイルを手動で編集し、必要な拡張プロパティーを追加します。 Windows のファイル・パスを指定する場合は、区切り文字のバックスラッシュ (¥) が 2 つのバックスラッシュ (¥¥) で入力されていること、つまり、バックスラッシュ (¥) がエスケープされていることを確認してください。あるいは、単一のスラッシュ文字 (/) を区切り文字として使用することもできます。 Java プロパティー・ファイルでの文字エスケープについて詳しくは、 Oracle 資料 Properties クラスの Javadocを参照してください。

表 2. 拡張調整プロパティー: エージェント
プロパティー名 説明 デフォルト値
agentStatusJitterTolerance

エージェントの状況メッセージのパブリッシュが遅れてもよい最大時間。その時間を超えると、メッセージは延滞と見なされます。 この値は、ミリ秒単位で指定します。

状況メッセージの経過時間は、調整キュー・マネージャーでパブリッシュされた時点が基点になります。 ただし、メッセージは、 IBM MQ ネットワークを通過するために必要な時間を考慮して、調整キュー・マネージャーで受信される前にエージェントによって発行されます。 この移動にかかる時間が常に同じであれば、実際の移動時間に関わらず、60 秒間隔で作成されるメッセージは、60 秒間隔でパブリッシュされます。 ところが、その移動時間がメッセージごとに異なる場合は、60 秒間隔で作成されたメッセージが、例えば 61 秒、59 秒、58 秒、62 秒などの間隔でパブリッシュされる可能性があります。 この場合に発生する 60 秒からの最大偏差のことをジッターといいます (この例では 2 秒です)。 このプロパティーでは、ジッターによる遅れの最大時間を指定します (その時間を超えると、メッセージは延滞と見なされます)。

 3000
表 3. 拡張調整プロパティー: コード・ページ
プロパティー名 説明 デフォルト値
coordinationCcsid コマンドが、調整キュー・マネージャーに接続するときに使用するコード・ページ。 エージェントによる調整キュー・マネージャーへのすべてのパブリケーションも、このコード・ページを使用して実行されます。 coordinationCcsid の値を指定する場合は、coordinationCcsidName の値も指定する必要があります。 1208
coordinationCcsidName coordinationCcsid の Java 表記。 coordinationCcsidName の値を指定する場合は、coordinationCcsid の値も指定する必要があります。 UTF8
表 4。 拡張調整プロパティー: 接続
プロパティー名 説明 デフォルト値
javaLibraryPath バインディング・モードでキュー・マネージャーに接続する場合、 Managed File Transfer は IBM MQ Java バインディング・ライブラリーにアクセスできなければなりません。 デフォルトでは、 Managed File Transfer は、 IBM MQによって定義されたデフォルトの場所でバインディング・ライブラリーを検索します。 バインディング・ライブラリーが別の場所にある場合は、このプロパティーを使用して、バインディング・ライブラリーの場所を指定してください。 MQ_INSTALLATION_PATH/java/lib
表 5. 拡張調整プロパティー: マルチインスタンス・キュー・マネージャー
プロパティー名 説明 デフォルト値
coordinationQMgrStandby coordinationQMgr プロパティーによって定義されている、複数インスタンスの調整キュー・マネージャーのスタンバイ・インスタンスに、クライアント接続するために使用するホスト名とポート番号 ( IBM MQ CONNAME 形式)。 例えば、host_name(port_number) デフォルトなし
表 6. 拡張調整プロパティー: キュー
プロパティー名 説明 デフォルト値
dynamicQueuePrefix このプロパティーは、一時キュー名の生成に使用する IBM MQ 接頭部を定義します。

dynamicQueuePrefixプロパティのフォーマットは、'IBM MQMQOD構造体の'DynamicQNameフィールドのフォーマットに従う。 詳しくは、 動的キューの作成を参照してください。

エージェントからの応答を必要とするコマンドにより生成される一時応答キューに、特定の IBM MQ 接頭辞を使用する場合は、command.properties ファイルでこのプロパティーを定義することもできます。

 WMQFTE.*
modelQueueName このプロパティーは、一時キューの生成に使用する IBM MQ モデル・キューを定義します。

エージェントからの応答を必要とするコマンドによって生成される一時応答キューに特定の IBM MQ モデル・キューを使用する場合は、 command.properties ファイルでこのプロパティーを定義することもできます。 詳しくは、 MFT command.properties ファイルを参照してください。

 SYSTEM.DEFAULT.MODEL.QUEUE
表 7. 拡張調整プロパティー: セキュリティー
プロパティー名 説明 デフォルト値
userIdForClientConnect IBM MQへのクライアント接続を介してフローされるユーザー ID。 java が指定されている場合、JVM によって報告されるユーザー名は、 IBM MQ 接続要求の一部として渡されます。 このプロパティーの値は None または java のいずれかになります。 なし
coordinationQMgrAuthenticationCredentialsFile 調整キュー・マネージャーに接続するための MQ 接続資格情報が入ったファイルへのパス。

[z/OS]認証資格情報ファイルの作成について詳しくは、 z/OS®での MQMFTCredentials.xml の構成を参照してください。

[AIX、Linux、Windows]このファイルの場所と許可については、 MQMFTCredentials.xmlの構成 を参照してください。

[AIX、Linux、Windows]認証資格情報ファイルの作成について詳しくは、 MFT および IBM MQ の接続認証を参照してください。
表 8。 拡張調整プロパティー: SSL/TLS
プロパティー名 説明 デフォルト値
coordinationSslCipherSpec コマンドと調整キュー・マネージャー間でのデータの交換時に使用されるプロトコル、ハッシュ・アルゴリズム、および暗号化アルゴリズムと、そのときに暗号鍵で使用されるビット数を指定します。

coordinationSslCipherSpec の値は、CipherSpec 名です。 この CipherSpec 名は、調整キュー・マネージャー・チャネルで使用されている CipherSpec 名と同じです。 有効なCipherSpec名のリストは、' Javaの 'IBM MQクラスの SSL/TLSCipherSpecsとCipherSuites、およびJMS の 'IBM MQクラスの SSL/TLSCipherSpecsとCipherSuites に含まれている。

coordinationSslCipherSpec は、coordinationSslCipherSuite とよく似ています。 coordinationSslCipherSuite と coordinationSslCipherSpec の両方を指定した場合は、coordinationSslCipherSpec の値が使用されます。

 なし
coordinationSslCipherSuite コマンドと調整キュー・マネージャーのデータ交換方法に関する SSL の動作を指定します。

coordinationSslCipherSuite の値は、CipherSuite 名です。 この CipherSuite 名は、エージェント・キュー・マネージャー・チャネルで使用される CipherSpec 名にマップされます。 詳細については、CipherSuiteとCipherSpecの名前のマッピングを参照してください。

coordinationSslCipherSuite は、coordinationSslCipherSpec とよく似ています。 coordinationSslCipherSuite と coordinationSslCipherSpec の両方を指定した場合は、coordinationSslCipherSpec の値が使用されます。

 なし
coordinationSslPeerName 調整キュー・マネージャーによって提供される名前と合致しなければならない識別名の骨組みを指定します。 その識別名に基づいて、接続時に調整キュー・マネージャーによって提示される識別用証明書が検査されます。 なし
coordinationSslTrustStore コマンドが信頼する証明書の場所を指定します。 coordinationSslTrustStore の値は、ファイル・パスです。 Windows のファイル・パスの場合、円記号 (¥) はエスケープ (¥¥) する必要があります。

IBM WebSphere® MQ 7.5 以降では、このプロパティーの値に環境変数を含めることができます。

 なし
coordinationSslTrustStoreType 使用する SSL 鍵ストアのタイプ。 JKS および PKCS#12 の鍵ストアがサポートされています。 このプロパティーの値は、jks または pkcs12 のいずれかになります。 jks
coordinationSslTrustStoreCredentialsFile coordinationSslTrustStore 資格情報が含まれているファイルのパス。

IBM WebSphere MQ 7.5以降、このプロパティーの値に環境変数を含めることができます。

 このプロパティーのデフォルト値は、 Windows の場合は %USERPROFILE%\MQMFTCredentials.xml 、その他のプラットフォームの場合は $HOME/MQMFTCredentials.xml です。
coordinationSslKeyStore コマンドの秘密鍵の場所を指定します。 coordinationSslKeyStore の値は、ファイル・パスです。 Windows ファイル・パスの場合は、バックスラッシュ (¥) をエスケープ (¥¥) してください。このプロパティーは、調整キュー・マネージャーがクライアント認証を必要とする場合にのみ、必要です。

IBM WebSphere MQ 7.5以降、このプロパティーの値に環境変数を含めることができます。

 なし
coordinationSslKeyStoreType 使用する SSL 鍵ストアのタイプ。 JKS および PKCS#12 の鍵ストアがサポートされています。 このプロパティーの値は、jks または pkcs12 のいずれかになります。 jks
coordinationSslKeyStoreCredentialsFile coordinationSslKeyStore 資格情報が含まれているファイルのパス。

IBM WebSphere MQ 7.5以降、このプロパティーの値に環境変数を含めることができます。

 このプロパティーのデフォルト値は、 Windows の場合は %USERPROFILE%\MQMFTCredentials.xml 、その他のプラットフォームの場合は $HOME/MQMFTCredentials.xml です。
coordinationSslFipsRequired 調整キュー・マネージャーのレベルで FIPS サポートを使用可能にすることを指定します。 このプロパティーの値は、true または false のいずれかになります。 詳しくは、 MFT での FIPS サポートを参照してください。 false
表 9。 拡張調整プロパティー: サブスクリプション
プロパティー名 説明 デフォルト値
coordinationSubscriptionTopic このプロパティーを使用して、 IBM MQ ネットワークの状況に関するパブリケーションを取得するためにサブスクライブする SYSTEM.FTE 以外のトピックを指定します。 すべてのツールは、引き続き SYSTEM.FTE トピック。ただし、 IBM MQ トポロジーを変更して、これらのパブリケーションをその内容に基づいてさまざまなトピックに配布することができます。 それから、この機能を使用して、他のトピックのいずれかにサブスクライブするよう、ツールを強制することができます。

IBM WebSphere MQ 7.5 およびそれ以降のフィックスパックの場合、 IBM MQ Explorer および fteListMonitors コマンドによってプロパティーが認識されるようにするには、APAR IC96850 の暫定修正が必要です。

 SYSTEM.FTE