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 ディレクトリーにあります。

coordination.properties ファイルには以下の値が含まれます。
表 1. 調整キュー・マネージャーのプロパティー
プロパティー名 説明 デフォルト値
coordinationQMgr 調整キュー・マネージャーの名前。 デフォルトなし
coordinationQMgrHost 調整キュー・マネージャーのホスト名または IP アドレス。 デフォルトなし
coordinationQMgrPort 調整キュー・マネージャーとのクライアント接続で使用されるポート番号。 1414
coordinationQMgrChannel 調整キュー・マネージャーとの接続に使用される SVRCONN チャネル名。 SYSTEM.DEF.SVRCONN

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

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

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

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

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

 3000
コード・ページ・プロパティー:
coordinationCcsid コマンドが、調整キュー・マネージャーに接続するときに使用するコード・ページ。 エージェントによる調整キュー・マネージャーへのすべてのパブリケーションも、このコード・ページを使用して実行されます。 coordinationCcsid の値を指定する場合は、coordinationCcsidName の値も指定する必要があります。 1208
coordinationCcsidName coordinationCcsid の Java 表記。 coordinationCcsidName の値を指定する場合は、coordinationCcsid の値も指定する必要があります。 UTF8
接続プロパティー:
javaLibraryPath バインディング・モードでキュー・マネージャーに接続する場合、 Managed File Transfer は IBM MQ Java バインディング・ライブラリーにアクセスできなければなりません。 デフォルトでは、 Managed File Transfer は、 IBM MQによって定義されたデフォルトの場所でバインディング・ライブラリーを検索します。 バインディング・ライブラリーが別の場所にある場合は、このプロパティーを使用して、バインディング・ライブラリーの場所を指定してください。 MQ_INSTALLATION_PATH/java/lib
マルチ・インスタンス・キュー・マネージャーのプロパティー:
coordinationQMgrStandby coordinationQMgr プロパティーによって定義されている、複数インスタンスの調整キュー・マネージャーのスタンバイ・インスタンスに、クライアント接続するために使用するホスト名とポート番号 ( IBM MQ CONNAME 形式)。 例えば、host_name(port_number) デフォルトなし
キュー・プロパティー:
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
セキュリティー・プロパティー:
userIdForClientConnect IBM MQへのクライアント接続を介してフローされるユーザー ID。 java が指定されている場合、JVM によって報告されるユーザー名は、 IBM MQ 接続要求の一部として渡されます。 このプロパティーの値は None または java のいずれかになります。 なし
coordinationQMgrAuthenticationCredentialsFile 調整キュー・マネージャーに接続するための MQ 接続資格情報が入ったファイルへのパス。

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

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

[UNIX、Linux、Windows]認証資格情報ファイルの作成について詳しくは、 MFT および IBM MQ の接続認証を参照してください。
サブスクリプションのプロパティ：
coordinationSubscriptionTopic このプロパティーを使用して、 IBM MQ ネットワークの状況に関するパブリケーションを取得するためにサブスクライブする SYSTEM.FTE 以外のトピックを指定します。 すべてのツールは、引き続き SYSTEM.FTE トピック。ただし、 IBM MQ トポロジーを変更して、これらのパブリケーションをその内容に基づいてさまざまなトピックに配布することができます。 それから、この機能を使用して、他のトピックのいずれかにサブスクライブするよう、ツールを強制することができます。

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

 SYSTEM.FTE

SSL プロパティーについては、 MFT の SSL プロパティーを参照してください。

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