[UNIX、Linux、Windows、IBM i]

Multiplatforms での .ini ファイルの IBM MQ 構成情報の変更

構成 (.ini) ファイル内の情報を編集することにより、 IBM® MQ または個々のキュー・マネージャーの動作を、ご使用のインストール済み環境のニーズに合わせて変更できます。 IBM MQ MQI clientsの構成オプションを変更することもできます。

本タスクについて

IBM MQを管理する一連の構成属性 (またはパラメーター) に指定されている値を変更することにより、ノードまたはキュー・マネージャーのレベルで IBM MQ 構成情報を変更できます。

構成ファイル(またはスタンザ・ファイル)には、一つ以上のスタンザが含まれています。これらのスタンザは、.iniファイル内の行のグループです。これらの行のグループは、共通の機能を持つか、ログ機能、チャネル機能、およびインストール可能サービスなどのシステムの一部を定義します。 IBM MQ 構成属性は、以下の構成ファイル内で変更できます。
IBM MQ 構成ファイル、 mqs.ini
mqs.ini ファイルは、ノード全体に影響を与えます。 IBM MQ のインストールごとに 1 つの mqs.ini ファイルがあります。
キュー・マネージャーに関連付けられたデータを見つけるために IBM MQ 構成ファイルが使用されるため、構成ファイルが存在しないか正しくないと、一部またはすべての MQSC コマンドが失敗する可能性があります。 また、 IBM MQ 構成ファイルで定義されていないキュー・マネージャーにアプリケーションが接続することもできません。
キュー・マネージャー構成ファイル、 qm.ini
qm.ini ファイルは、特定のキュー・マネージャーの変更に影響します。 ノード上のキュー・マネージャーごとに一つのqm.iniファイルがあります。
IBM MQ MQI client 構成ファイル、 mqclient.ini
IBM MQ MQI clients の構成オプションは、クライアント構成ファイル (通常は mqclient.iniという名前) に別個に保持されます。
アクティビティー・トレース構成ファイル mqat.ini
mqat.ini ファイルは、アクティビティー・トレースの動作を構成するために使用されます。
構成ファイルを編集する必要があるのは、次のような場合です。
  • 構成ファイルが失われる場合。 (可能であれば、バックアップからリカバリーしてください。)
  • 1 以上のキュー・マネージャーを新しいディレクトリーに移す必要がある場合。
  • デフォルトのキュー・マネージャーを変更する必要があります。 これは、既存のキュー・マネージャーを誤って削除した場合に発生する可能性があります。
  • IBM サポートからこれを行うようお勧めします。
重要: 構成ファイルに対して行った変更は、通常、キュー・マネージャーが次に開始されるまで有効になりません。
構成ファイルの編集に関する注意点:
  • 構成ファイルの属性の値は、以下の優先順位に従って設定されます。
    • コマンド行に入力されたパラメーターは、構成ファイルに定義されている値よりも優先されます。
    • qm.ini ファイルに定義されている値は、 mqs.ini ファイルに定義されている値よりも優先されます。
  • インストール後に、 IBM MQ 構成ファイル内のデフォルト値を編集できます。
  • キュー・マネージャーをバックアップする場合は、その構成ファイル (qm.ini) と中央の IBM MQ 構成ファイル (mqs.ini) の両方を必ず含めてください。
  • 構成ファイル属性に誤った値を設定すると、属性全体が欠落しているのと同じ結果になります。 値は無視され、問題を示すオペレーター・メッセージが出されます。
  • [IBM i] IBM iでは、 .ini ファイルは IFS に常駐するストリーム・ファイルです。
  • mqat.ini ファイルのフォーマットには、いくつかの構文規則があります。 詳しくは、「アプリケーション・アクティビティー・トレース mqat.iniを使用したアクティビティー・トレース動作の構成」を参照してください。

[UNIX、Linux、Windows] UNIX または Linux®の場合、インストール構成ファイル mqinst.iniには、すべての IBM MQ インストールに関する情報が含まれています。 mqinst.ini ファイルの形式は固定されておらず、変更される可能性があるため、このファイルは編集したり、直接参照したりしないでください。 代わりに、コマンドを使用して編集する必要があります。 詳しくは、 インストール構成ファイル mqinst.iniを参照してください。

手順

  1. 構成ファイルを編集する前に、構成ファイルをバックアップして、必要に応じて元に戻すことができるコピーを用意します。
  2. 以下のいずれかの方法で .ini 構成ファイルを編集します。
    • 標準のテキスト・エディターを使用して手動で行う。 コメントは、コメント・テキストの前に;または#文字を追加することによって、構成ファイルに組み込むことができます。 コメントを表示しない ; または # 文字を使用する場合は、文字の前に ¥ 文字を付けることができます。 この文字は、構成データの一部として使用されます。
    • ノード上のキュー・マネージャーの構成を変更するコマンドを使用して、自動的に。 詳しくは、 コマンド・リファレンスを参照してください。

      [Windows]例えば、 Windows specific コマンド amqmdain は、 qm.ini プロパティーのサブセットを自動的に更新します。 詳しくは、 amqmdainを参照してください。

    • [Windows][Linux] Linux (x86 および x86-64) および Windowsでは、 IBM MQ Explorerを使用して qm.ini プロパティーのサブセットを更新できます。 詳しくは、 MQ エクスプローラーを使用した IBM MQ の構成を参照してください。
      注: インストール可能サービスとそのコンポーネントの変更には大きな影響があるため、 IBM MQ Explorerではインストール可能サービスは読み取り専用です。 そのため、 qm.ini ファイルを編集して、インストール可能サービスに変更を加える必要があります。 詳しくは、 qm.ini ファイルのサービス・スタンザを参照してください。