[UNIX、Linux、Windows、IBM i]

マルチプラットフォーム環境における.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 ファイルはキューマネージャーに関連するデータの場所を特定するために使用されるため、設定ファイルが存在しない場合や内容が正しくない場合、MQSCコマンドの一部またはすべてが失敗する可能性があります。 また、アプリケーションは、設定 IBM MQ ファイルに定義されていないキューマネージャーには接続できません。
インストール構成ファイル、mqinst.ini
[AIX][Linux]システム AIX® and Linux® 上では、インストール設定ファイルである `` mqinst.ini には、すべてのインストール IBM MQ に関する情報が含まれています。 mqinst.ini ファイルの形式は固定されておらず、変更される可能性があるため、このファイルは編集したり、直接参照したりしないでください。 その代わりに、コマンドを使って編集する必要があります。
キューマネージャーの設定ファイル、 qm.ini
この qm.ini ファイルは、特定のキューマネージャーに対して変更を適用します。 ノード上のキュー・マネージャーごとに一つのqm.iniファイルがあります。
IBM MQ MQI client 設定ファイル、 mqclient.ini
の設定オプションは、通常. という mqclient.ini名前のクライアント IBM MQ MQI clients 設定ファイルに個別に保存されます。
アクティビティトレース設定ファイル、 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を使用したアクティビティトレースの動作の設定」 を参照してください。

手順

  1. 設定ファイルを編集する前に、バックアップをとっておきましょう。そうすれば、万が一のときに元に戻せるようにできます。
    注:

    このディレクトリは内部使用のために予約されているため、バックアップをここに <existing file>.ini.bak 保存しないでください。

  2. 以下のいずれかの方法で .ini 設定ファイルを編集してください:
    • 標準的なテキストエディタを使用して手動で行う。 コメントは、コメント・テキストの前に;または#文字を追加することによって、構成ファイルに組み込むことができます。 ;# をコメントとして扱わずに使用したい場合は、その文字の前に \ を付けることができます。 その文字は、設定データの一部として使用されます。
    • ノード上のキューマネージャの設定を変更するコマンドを使用して、自動的に行います。 詳細については、 「コマンドリファレンス」 を参照してください。

      [Windows]たとえば、特定の Windows コマンドを実行すると、 qm.ini プロパティ amqmdain の一部が自動的に更新されます。 詳細については、 amqmdain を参照してください。

    • [Windows][Linux]( x86 Linux および x86-64 ) では Windows、を使用して qm.ini プロパティ IBM MQ Explorerの一部を更新できます。 詳細については、 「 MQ Explorer を使用した IBM MQ の構成 」を参照してください。
      注: インストール可能なサービスおよびそのコンポーネントを変更することには重大な影響が伴うため、インストール可能なサービスは IBM MQ Explorer. したがって、インストール可能なサービスに変更を加える場合は、ファイルを qm.ini 編集する必要があります。 詳細については、 qm.ini ファイルの「Service」セクションを参照してください。