MFT installation.properties ファイル

installation.propertiesファイルは、構成オプションのデフォルト・セットの名前を指定します。 このエントリーは、使用する構成を含むディレクトリーとプロパティー・ファイルの構造化されたセットを Managed File Transfer に指示します。 一般に、構成オプションのセット名は、関連付けられている調整キュー・マネージャーの名前です。

このファイルはインストーラーによって作成され、fteChangeDefaultConfigurationOptions コマンドを使用して変更できます。

installation.properties ファイルは MQ_DATA_PATH ディレクトリーにあります。 例えば、 Windowsの場合、デフォルトのファイル・ロケーションは MQ_DATA_PATH\mqft\installations\installation_name であり、 UNIX システムおよび Linux® システムの場合、デフォルトのファイル・ロケーションは /var/mqm/mqft/installations/installation_nameです。

[V9.1.0 2018 年 7 月] Redistributable Managed File Transfer Agentの場合、データ・パスは fteCreateEnvironment コマンドの実行時に設定されます。 このコマンドを実行するときに、選択した場所を -d パラメーターで指定すると、その場所がデータ・パスに設定されます。 fteCreateEnvironment コマンドで場所を指定しない場合、 Redistributable Managed File Transfer Agent が解凍されたルート・ディレクトリーの下にディレクトリー mftdata が作成されます。 Redistributable Managed File Transfer Agentinstallation.properties ファイルは、 MQ_DATA_PATH\mqft\installations\MFTZipInstall ディレクトリーにあります。

installation.properties ファイルには以下の値が含まれます。
表 1. 基本プロパティー
プロパティー名 説明 デフォルト値
commandMessagePriority

fteStopAgentfteCancelTransfer、および ftePingAgent コマンドに関する内部メッセージとコマンド・メッセージの両方の優先順位を設定します。

例えば、多数の小さいファイルを転送するための大量の転送要求を立て続けに送信する場合、新しい転送要求をソース・エージェントのコマンド・キューで待機状態にすることができます。 外部メッセージと内部メッセージにはデフォルトの IBM® MQ メッセージ優先順位が設定されているため、内部メッセージは新しい転送要求によってブロックされます。 これにより、転送ネゴシエーション時間を超過して、転送がリカバリー状態になることがあります。

また、commandMessagePriority プロパティーを使用すると、内部確認応答メッセージと確認応答が必要なメッセージの優先順位を設定することもできます。

内部 Managed File Transfer メッセージの優先順位を新しい転送要求よりも高くするには、このプロパティーを 1 (最低) から 9 (最高) の間の値に設定します。

commandMessagePriority プロパティーのデフォルト値は 8 です。 これは、エージェント・コマンド・キューの IBM MQ 属性 DEFPRTY (デフォルト優先順位) が 7 以下の場合の場合に、内部のネゴシエーション・メッセージが新しい転送要求よりも優先されるという意味です。 DEFPRTY 属性の値が 8 または 9 のいずれかに設定されている場合、commandMessagePriority プロパティーの有効性を維持するには、DEFPRTY プロパティーまたは commandMessagePriority プロパティーのいずれかを変更する必要があります。

IBM MQ 9.0.0.0 以降の場合、デフォルト値は 8 です。

それ以前のリリースおよびAPARIT06213以前のリリースでは、デフォルト値はMQPRI_PRIORITY_AS_Q_DEF定数で、値は-1です。

defaultProperties 構成オプションのデフォルト・セットの名前。 この値は、構成ディレクトリーにあるディレクトリーの名前です。このディレクトリーには複数のディレクトリーと、構成情報を指定するプロパティー・ファイルが含まれています。 デフォルトなし
enableFunctionalFixPack 使用可能にするフィックスパック機能のレベル。 デフォルトでは、フィックスパックに組み込まれている新しい機能は使用可能になっていません。 このプロパティーをバージョン ID に設定すると、そのバージョンで使用できる新しいフィーチャーを使用可能にすることができます。

バージョン ID は、ピリオド文字 (.) を付けても付けなくても指定できます。 例えば、 IBM MQ 8.0.0 Fix Pack 2で使用可能な関数を使用するには、このプロパティーを 8002 または 8.0.0.2に設定します。

デフォルトなし
messagePublicationFormat
MFT エージェントが状況 XML メッセージに使用するメッセージ・パブリケーション形式を指定できます。 このプロパティーは、以下の値に設定できます。
messagePublicationFormat=mixed
メッセージは MQMD FORMAT なしでパブリッシュされます (MQFMT_NONE)。 ただし、/LOG トピック・ツリーの下で発行されるメッセージは例外で、MQFMT_STRING の MQMD 形式でパブリッシュされます。
messagePublicationFormat=MQFMT_NONE
メッセージは MQMD FORMAT なしでパブリッシュされます。
messagePublicationFormat=MQFMT_STRING
メッセージはストリング形式でパブリッシュされます。

IBM MQ 8.0より前では、 MFT エージェントは XML 状況メッセージを SYSTEM.FTE トピック (MQFMT_STRING)。 可能な場合は、以前に IBM WebSphere® MQ 7.5 を使用していたアプリケーションを、 IBM MQ 8.0 以降の形式のメッセージを処理するように更新する必要があります。 アプリケーションを変更できない場合は、messagePublicationFormatプロパティを MQFMT_STRING に設定して、'IBM WebSphere MQ 7.5動作に戻す。

messagePublicationFormat=mixed
[z/OS]z/OS固有:
[V9.1.0 2018 年 7 月][z/OS]productId MFT 使用量が記録される [V9.1.0 2018 年 7 月][z/OS] 製品タイプ:
  • スタンドアロン Managed File Transfer 製品。 (MFT は productIDです。)
  • IBM MQ Advanced 製品の一部。 (ADVANCED は productIDです。)
  • IBM MQ Advanced for z/OS® Value Unit Edition 製品の一部。 (ADVANCEDVUE が productID)。

製品使用記録の詳細については、製品情報のレポートを参照してください。

[UNIX、Linux、Windows、IBM i]このプロパティーは、 Multiplatforms では無視されます。

[V9.1.0 2018 年 7 月][z/OS]MFT (MFT)
以下のテキストは、installation.properties ファイルの内容の例です。
defaultProperties=ERIS
ERIS は、installation.properties ファイルと同じディレクトリーにあるディレクトリーの名前です。 ディレクトリー ERIS には複数のディレクトリーと一連の構成オプションを記述するプロパティー・ファイルが含まれています。