IBM MQ プロパティー
IBM® MQ プロパティーは、 IBM MQ インストール済み環境全体に適用されます。
以下の表に、 IBM MQに設定できるプロパティーをリストします。
それぞれのプロパティーについて、その構成時に必要となる簡単な説明を記載しています。 「 IBM MQ プロパティー」ダイアログのプロパティーは、構成ファイル内のスタンザに関連しています。
「一般」ページ
下表に、「IBM MQ のプロパティー」ダイアログの「一般」ページで設定可能なプロパティーを示します。
Property | 説明 | スタンザ鍵 |
---|---|---|
デフォルト接頭部 | すべてのキュー・マネージャー・データを保管しているディレクトリーの場所を変更するために、新規ディレクトリーへの絶対パスを入力します。 | DefaultPrefix |
デフォルト・キュー・マネージャー名 | 新規キュー・マネージャーのデフォルト名を指定するには、このフィールドに名前を入力します。 | 名前 |
「拡張」ページ
下表に、「IBM MQ のプロパティー」ダイアログの「拡張」ページで設定可能なプロパティーを示します。
Property | 説明 | スタンザ鍵 |
---|---|---|
デフォルト一時接頭部 | すべての一時キュー・マネージャー・データを保管しているディレクトリーの場所を変更するために、新規ディレクトリーへの絶対パスを入力します。 | DefaultEphemeralPrefix |
EBCDIC 改行を変換 | EBCDIC コード・ページには、ASCII コード・ページでサポートされていない改行 (NL) 文字が含まれて います (ただし一部の ISO 変種の ASCII には同等のものが含まれています)。 EBCDIC コード・ページを使用するシステム (例えば、 z/OS® システム) から ASCII を使用するシステムにメッセージを送信する場合、EBCDIC 改行文字を ASCII フォーマットに変換する方法を制御できます。 デフォルト値は NL_TO_LF で、これはすべての EBCDIC から ASCII への変換に おいて、EBCDIC NL 文字 (X'15') が ASCII 改行文字 LF (X'0A') に変換されることを意味します。 ご使用のオペレーティング・システムの変換テーブルに応じて EBCDIC NL 文字を変換する には、「TABLE」をクリックします。 TABLE 変換の結果は、プラットフォームおよび言語ごとに異なる場合があります。同じプラットフォーム上であっても、異なる コード化文字セット ID (CCSID) を使用すれば、結果は異なる可能性があります。 ISO CCSID を TABLE メソッドを使用して変換し、NL_TO_LF メソッドを他のすべての CCSID に使用する には、「ISO」をクリックします。 | ConvEBCDICNewline |
クラスター・ワークロード・モード | クラスター・ワークロード出口 (CLWL) を使用すると、MQI 呼び出し (MQOPEN または MQPUT など) に応答して、クラスター内のどのクラスター・キューを開くかを指定できます。 デフォルト値は SAFE です。この場合、キュー・マネージャーとは別のプロセスで CLWL 出口が実行されるので、問題がある場合でも、キュー・マネージャーの整合性は保持されます。 ただし、CLWL 出口を別のプロセスとして実行すると、パフォーマンスに対する悪影響が生じる可能性があります。 CLWL 出口をキュー・マネージャーと同じプロセスで実行することによりパフォーマンスを向上させる には、「FAST」をクリックします。 FAST モードは、CLWL 出口に問題がないことが確かな場合にのみ使用してください。 FAST モードに問題がある場合、キュー・マネージャーに障害が発生し、キュー・マネージャーの整合性にリスクが生じるから です。 この値は、クラスター・ワークロード・モード・プロパティーを使用して、個々のキュー・マネージャーに関してオーバーライドすることができます。 詳しくは、 キュー・マネージャー・プロパティーを参照してください。 | CLWLMode |
「出口」ページ
下表に、「IBM MQ のプロパティー」ダイアログの「出口」ページで設定可能なプロパティーを示します。 特定のコンピューター上のすべてのキュー・マネージャーに共通の出口を構成する には、「出口」ページでプロパティーを編集します。
Property | 説明 | スタンザ鍵 |
---|---|---|
出口デフォルト・パス | クライアントのチャネル出口の場所、およびサーバーのチャネル出口とデータ変換を変更するには、 新規ディレクトリーへのパスを入力します。 | ExitsDefaultPath |
共通 API 出口 | IBM MQの新しい共通 API 出口を構成するには、 「追加」 をクリックしてから、 「プロパティー」 ダイアログで出口の詳細を入力します。 テーブルに事前に表示されている共通 API 出口を編集するには、「編集」を クリックします。 テーブルから API 出口を除去するには、「除去」をクリックします。 | ApiExitCommon |
テンプレート API 出口 | IBM MQの新規テンプレート API 出口を構成するには、 「追加」 をクリックしてから、「プロパティー」ダイアログで出口の詳細を入力します。 テーブルに事前に表示されているテンプレート API 出口を編集するには、「編集」を クリックします。テーブルから API 出口を除去するには、「除去」をクリックします。 | ApiExitTemplate |
名前 | MQAXP 構造の ExitInfoName フィールドの API 出口に渡される API 出口の記述名を指定します。 この名前は固有でなければならず、48 文字の長さに制限されています。また、キュー名などの IBM MQ オブジェクトの名前に有効な文字のみを使用する必要があります。 | 名前 |
タイプ | 出口のタイプとして、common または template のいずれかを指定します。 |
(個別のスタンザ鍵以外。) |
シーケンス | このプロパティーは符号なしの数値で、この API 出口が他の API 出口との比較で呼び出されるシーケンスを定義します。 シーケンス番号の小さい API 出口は、シーケンス番号の大きい他の API 出口よりも先に呼び出されます。 同じシーケンス番号を持つ異なる複数の API 出口が呼び出される順序は定義されていません。 つまり、キュー・マネージャーに定義された API 出口のシーケンス番号において確実にギャップが存在します。 | シーケンス |
モジュール | API 出口のコードを含むモジュールを指定します。 このフィールドにモジュールの絶対パス名が入っている場合、それがそのまま使用されます。 このフィールドにモジュール名のみが含まれている場合、モジュールはチャネル出口と同じ方法を使用して配置されます。つまり、「キュー・マネージャー・プロパティー」ダイアログの 「出口」ページにある「Exit default
path 」フィールドの値を使用して配置されます。 |
モジュール |
Function | API 出口のコードを含むモジュールへの関数エントリー・ポイントの名前を指定します。 このエントリー・ポイントは MQ_INIT_EXIT 関数です。 このフィールドの長さは MQ_EXIT_NAME_LENGTH に限定されます。 | Function |
データ | このプロパティーが指定されている場合、先行ブランクと末尾ブランクは削除されて、残りのストリングは 32 文字に切り捨てられ、その結果が MQAXP 構造の ExitData フィールドの出口に渡されます。 このプロパティーが指定されていない場合は、デフォルト値の 32 ブランクが MQAXP 構造の ExitData フィールドの出口に渡されます。 | データ |
デフォルト・ログ設定
下表に、「IBM MQ のプロパティー」ダイアログの「デフォルト・ログ設定」ページで設定可能なプロパティーを示します。 デフォルト・ログ設定を変更するには、「デフォルト・ログ設定」ページでプロパティーを編集します。 これらの設定は、デフォルトですべての新規キュー・マネージャーに適用されます。
Property | 説明 | スタンザ鍵 |
---|---|---|
ログ・タイプ | キュー・マネージャーが再始動時に回復できるようにする には、「循環」をクリックします。 キュー・マネージャーが循環ログを使用する場合、ログ・ファイルがいっぱいになると、そのファイルは先頭から上書きされます。 キュー・マネージャーが再始動時に回復できるようにし、メディアまたは順方向リカバリーを可能にする には、「リニア」をクリックします。 キュー・マネージャーがリニア・ログを使用する場合、ログ・ファイルがいっぱいになると、新規ログ・ファイルが開始されます。 | LogType |
ログ・パス | ログのデフォルトの場所を変更するには、ここに絶対パスを入力します。 ここでパスを指定しない場合、デフォルトは、DefaultPrefix 内の Log というサブディレクトリーです。DefaultPrefix は、「IBM MQ のプロパティー」ダイアログの「一般」ページの Default prefix プロパティーで指定されたディレクトリーです。 |
LogPath |
ログ・ファイル・ページ | 32 から 4095 の範囲で、ログ・ファイル内の 4KB ページの数を入力します。 例えば、次のように入力したとします。256ファイル・サイズは 1MBです。 | LogFilePages |
ログ 1 次ファイル | AIX® and Linux®では、1 次ログ・ファイルの数を 2 から 510 の範囲で入力します。 デフォルト値は 3 です。 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。 Windowsでは、1 次ログ・ファイルの数を 2 から 254 の範囲で入力します。 デフォルト値は 3 です。 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。 |
LogPrimaryFiles |
ログ 2 次ファイル | AIX and Linuxでは、1 から 509 の範囲で、2 次ログ・ファイルの数を入力します。 デフォルト値は 3 です。 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。 Windowsでは、2 次ログ・ファイルの数を 1 から 253 の範囲で入力します。 デフォルト値は 3 です。 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。 |
LogSecondaryFiles |
ログ・バッファー・ページ | 0 から 512 の範囲で、4KB 書き込みバッファー・ページの数を入力します。 0 を指定した場合、キュー・マネージャーは数そのものを選択します。 1 から 17 を指定すると、18 が最小として使用されます。 18 から 512 を指定すると、その数のページが使用されます。 このプロパティーの値を変更する場合は、キュー・マネージャーが変更を検出するように再始動します。 |
LogBufferPages |
ログ書き込み整合性 | ロガーがログ・レコードを確実に書き込むために使用する方法。 デフォルト値は TripleWriteです。 なお、DoubleWrite を選択可能ですが、そのようにした場合、システムでは TripleWrite と解釈されます。 SingleWrite は、IBM MQ リカバリログをホストしているファイルシステムやデバイスが、4KB の書き込みのアトミック性を明示的に保証している場合にのみ使うべきです。 すなわち、何らかの原因で 4KB ページの書き込みが失敗した場合、変更前イメージまたは変更後イメージの 2 つの状態しかありません。 中間の状態は考えられません。 |
LogWriteIntegrity |
ログ管理 | ログを管理する方法。 LogManagement が適用されるのは、LogType が LINEAR の場合に限られます。 LogManagement の値を変更しても、キュー・マネージャーを再始動するまでその変更は有効になりません。 3 つのオプションがあります。 「手動」は、ログ・エクステントを手動で管理します。 このオプションを指定すると、リカバリー用のログ・エクステントが不要になった場合でも、キュー・マネージャーは、ログ・エクステントを再使用したり削除したりしません。 「自動」は、キュー・マネージャーによってログ・エクステントが自動的に管理されます。 このオプションを指定すると、リカバリー用のログ・エクステントが不要になった時点で、キュー・マネージャーがログ・エクステントを再使用したり削除したりできるようになります。 アーカイブ保存はできません。 「アーカイブ」は、キュー・マネージャーによってログ・エクステントが管理されますが、それぞれのログ・エクステントのアーカイブ保存が完了したことをキュー・マネージャーに通知する必要があります。 このオプションを指定すると、不要になったリカバリー用のログ・エクステントのアーカイブ保存が完了したことをキュー・マネージャーに通知した時点で、キュー・マネージャーがログ・エクステントを自由に再使用したり削除したりできるようになります。 デフォルト値は 「手動」です。 |
LogManagement |
「ACPI」ページ
下表に、「IBM MQ のプロパティー」ダイアログの「ACPI」ページで設定可能なプロパティーを示します。 ACPI (Advanced Configuration and Power ® Interface) は、コンピューターが特定のアクティビティー状態を検出し、その結果ハイバネートできるようにするオペレーティング・システム・フィーチャーです。つまり、プログラムが実行されていない低電力モードにコンピューター自体を切り替え、「即時ウェイクアップ」を可能にします。
ACPI がコンピューターをハイバネーションにする場合は、最初に中断要求をすべてのアプリケーションに送信します。 IBM MQ がこの要求に応答する方法を制御するには、 「ACPI」 ページの 「Do ダイアログ」 プロパティーを設定します。
Property | 説明 | スタンザ鍵 |
---|---|---|
ダイアログを実行 | デフォルト値は 「はい」です。これは、 IBM MQ が、実行中のキュー・マネージャーを中断するかどうかをユーザーに尋ねるメッセージを表示することを意味します。 このメッセージを表示せずに IBM MQ を中断するには、 「いいえ」をクリックします。 | DoDialog |
中断を拒否 | Do dialog プロパティーが設定されていない場合、または設定されていてもダイアログを表示できない (例えば、ラップトップ・コンピューターのふたが閉じられている) 場合は、Deny suspend が応答を制御します。 デフォルト値は 「いいえ」です。これは、ダイアログを表示できない場合でも IBM MQ が中断することを意味します。 ダイアログを表示できない場合に IBM MQ が中断しないようにするには、 「はい」をクリックします。 このプロパティーは、Check channels running プロパティーによって無効にすることができます。 | DenySuspend |
チャネルが稼働しているかを検査 | デフォルト値は「いいえ」です。これは、IBM MQ が、実行中のチャネルがあるかどうかを検査せず、Do dialog プロパティーおよび Deny suspend プロパティーの指示に従って応答することを意味します。 実行中のチャネルがあるかどうかを検査するには、「はい」をクリックします。 実行中のチャネルがない場合、IBM MQ は Do dialog プロパティーと Deny suspend プロパティーを無視します。 実行中のチャネルがある場合、IBM MQ は Do dialog プロパティーと Deny suspend プロパティーの指示に従って応答します。 | CheckChannelsRunning |
![[Windows]](ngwin.gif)
「アラート・モニター」ページ
「アラート・モニター」は Windows 上でのみ使用できます。
下表に、「IBM MQ のプロパティー」ダイアログの「アラート・モニター」ページで設定可能なプロパティーを示します。 アラート・モニターは問題判別に役立ちます。 アラートは、何かが正常でない場合にサービスによって起こります。例えば、必要なキューが削除されているために、 チャネル・イニシエーター・サービスが開始できない場合などです。 アラート・モニターを構成するには、「アラート・モニター」ページでプロパティーを編集します。
Property | 説明 | スタンザ鍵 |
---|---|---|
アラート・モニターがユーザーに通知 | デフォルト値は 「いいえ」です。これは、問題がある場合に IBM MQ がユーザーにアラートを送信しないことを意味します。 問題が発生した場合にアラートを送信するように IBM MQ を構成するには、 「はい」をクリックします。 | Enable |
アラート・モニター・ユーザー | IBM MQ がアラートを送信するコンピューター名またはユーザー名を入力します。 | Recipient |
アラート・モニター・アイコンをタスクバーに追加 | デフォルト値は「いいえ」で、これはアラート・モニター・アイコンが Windows システムのトレイ上に表示されないことを意味します。 アラート・モニター・アイコンを Windows システムのトレイ上に表示するには、「はい」を クリックします。 | TaskBar |
「構成情報」ページ
下表に、「IBM MQ のプロパティー」ダイアログの「構成情報」ページに表示されるプロパティーを示します。 「構成情報」ページのプロパティーは、読み取り専用です。
Property | 説明 |
---|---|
インストール・タイプ | 読み取り専用。 このプロパティーは、このコンピューターに IBM MQ のサーバー・バージョンまたはクライアント・バージョンがインストールされているかどうかを示します。 |
ロードされた mqjbnd05 | 読み取り専用。 これは、ローカル・キュー・マネージャーに接続する必要があるライブラリーです。 |
MQ バージョン | 読み取り専用。 これは、このコンピューターにインストールされている IBM MQ のバージョンです。 |
ビルド・レベル | 読み取り専用。 これは、このコンピューターにインストールされている IBM MQ 製品のビルド番号です。 |
ビルド・タイプ | 読み取り専用。 これは、このコンピューターにインストールされている IBM MQ 製品のビルドのタイプです。 |