WebSphere MQ キュー設定 (MQ 構成)
このパネルを使用して、WebSphere MQ に定義した、
選択したキュー宛先の構成プロパティーを表示または変更します。
キュー宛先を使用して、JMS キューのプロパティーを構成します。
WebSphere MQ JMS プロバイダーで使用するキューには、
WebSphere MQ に定義された以下の追加プロパティーがあります。
注:
- 表示される一部のプロパティーは読み取り専用であるため、変更できません。
- これらのプロパティーを表示または変更するには、
キューが常駐している WebSphere MQ Queue Manager をリモート管理用に構成して、実行する必要があります。
- 指定するプロパティー値は、WebSphere MQ の JMS リソースを構成する際に指定した値と一致していなければなりません。
WebSphere MQ JMS リソースの構成の詳細については、資料「WebSphere MQ Java の使用 」を参照してください。この資料は、WebSphere MQ マルチプラットフォーム・ライブラリーに関する Web ページ
http://www.ibm.com/software/ts/mqseries/library/manualsa/manuals/crosslatest.html
などから入手することができます。
- WebSphere MQ では、名前には最大 48 文字まで使用できますが、
チャネルの場合は例外で最大 20 文字までになります。
この管理コンソール・ページを表示するには、「
リソース」->「WebSphere MQ JMS プロバイダー」-> (コンテンツ・ペイン内、「追加プロパティー」の下にある)「WebSphere MQ Queue Destinations」->「destination_name」-> (コンテンツ・ペイン内、「追加プロパティー」の下にある)「MQ 構成」をクリックします。
-
基本キュー名
- 「基本キュー・マネージャー名」プロパティーで指定したキュー・マネージャー上のメッセージ送信先のキューの名前。
-
基本キュー・マネージャー名
- メッセージの送信先となる WebSphere MQ キュー・マネージャーの名前。
このキュー・マネージャーは、「基本キュー名」プロパティーで指定されたキューを提供します。
-
キュー・マネージャーのホスト
- キュー宛先が作成されるキュー・マネージャーのホストの名前。
-
キュー・マネージャーのポート
- このキューが定義されているキュー・マネージャーが使用するポートの番号。
| データ型 |
整数 |
| 範囲 |
有効な TCP/IP ポート番号。このポートは、WebSphere MQ キュー・マネージャー上で構成される必要があります。 |
-
サーバー接続チャネル名
- WebSphere MQ キュー・マネージャーへの接続に使用されるチャネルの名前。
| データ型 |
ストリング |
| 範囲 |
1 から 20 文字の ASCII 文字 |
-
ユーザー ID
- キュー宛先を定義するためにキュー・マネージャーに接続する際の認証のための、「
パスワード」プロパティーとともに使用するユーザー ID。
「ユーザー名」プロパティーの値を指定する場合は、「
パスワード」プロパティーにも値を指定する必要があります。
-
パスワード
- キュー宛先を定義するためにキュー・マネージャーに接続する際の認証のための、「
ユーザー名」プロパティーとともに使用するパスワード。
「ユーザー名」プロパティーの値を指定する場合は、「
パスワード」プロパティーにも値を指定する必要があります。
-
名前
- WebSphere MQ キュー・マネージャーに定義されているキューの名前。
| データ型 |
ストリング |
| 範囲 |
1 から 48 文字の ASCII 文字 |
-
説明
- WebSphere MQ で管理目的で使用する、WebSphere MQ キューの説明。
| データ型 |
ストリング |
| デフォルト |
Null |
| 範囲 |
1 から 64 文字の ASCII 文字 |
-
プット 禁止
- PUT 操作をこのキューに許可するかどうかを指定します。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
クリア |
| 範囲 |
-
許可
- PUT 操作がこのキューに許可されます。
-
Not allowed
- PUT 操作がこのキューに許可されません。
|
-
パーシスタンス
- 宛先に送信されるすべてのメッセージが永続的か非永続的か、
あるいはメッセージのパーシスタンスをアプリケーションで定義するかを指定します。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
APPLICATION_DEFINED |
| 範囲 |
-
アプリケーションで定義
- 宛先上のメッセージのパーシスタンスは、
そのメッセージをキューに入れたアプリケーションで定義されます。
-
Queue defined
- [WebSphere MQ 宛先のみ] 宛先上のメッセージのパーシスタンスは、
WebSphere MQ キュー定義プロパティーで定義されます。
-
パーシスタント
- 宛先上のメッセージは永続的です。
-
非パーシスタント
- 宛先上のメッセージは永続的ではありません。
|
-
クラスター名
- WebSphere MQ キュー・マネージャーが属するクラスターの名前。
「クラスター名」に値を指定すると、「クラスター名リスト」には値を指定できません。
クラスター名は、「
WebSphere MQ MQSC Command Reference」で説明している規則に準拠していなければなりません。
| データ型 |
ストリング |
| デフォルト |
Null |
| 範囲 |
キュー・マネージャー・クラスターで有効な WebSphere MQ 名。1 から 48 の ASCII 文字。 |
-
クラスター名リスト
- WebSphere MQ キュー・マネージャーが属するクラスターの名前リストの名前。
「クラスター名」に値を指定すると、「クラスター名リスト」には値を指定できません。
| データ型 |
ストリング |
| デフォルト |
Null |
| 範囲 |
キュー・マネージャー・クラスターのリストで有効な WebSphere MQ 名。1 から 48 文字の ASCII 文字。 |
-
Default Binding
- キューがクラスター・キューとして定義されている場合に使用されるデフォルトのバインディング。
| データ型 |
列挙型 |
| デフォルト |
Null |
| 範囲 |
A
-
On open
- キューがオープンしている場合、
キュー・ハンドルは、クラスター・キューの特定のインスタンスにバインドされます。
-
Not fixed
- キュー・ハンドルは、クラスター・キューの特定のインスタンスにバインドされていません。
これにより、メッセージがプットされる際に、キュー・マネージャーは、特定のキュー・インスタンスを選択でき、
必要が生じた場合には、後でその選択を変更できます。
|
-
取得禁止
- 取得操作をこのキューに許可するかどうかを指定します。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
クリア |
| 範囲 |
-
許可
- 取得操作がこのキューに許可されます。
-
Not allowed
- 取得操作がこのキューに許可されません。
|
-
Maximum queue depth
- キューに入れることができるメッセージの最大数。
| データ型 |
整数 |
| 単位 |
メッセージ |
| デフォルト |
|
| 範囲 |
ゼロ以上で、下記の値以下の値。
- キューが OS/390 上にある場合、999 999 999
- キューが別の WebSphere MQ プラットフォーム上にある場合、640 000
指定可能な最大値についての詳細は、「
WebSphere MQ MQSC Command Reference」を参照してください。
この値が減らされた場合、メッセージ数が新規最大値を超えたとしても、
すでにキュー上にあるメッセージはどれも影響を受けません。
|
-
Maximum Message Length
- このキュー上でのメッセージのバイト単位の最大長。
| データ型 |
整数 |
| 単位 |
バイト |
| デフォルト |
|
| 範囲 |
0 以上で、キュー・マネージャーおよび WebSphere MQ プラットフォームの最大メッセージ長以下の値。
指定可能な最大値についての詳細は、「
WebSphere MQ MQSC Command Reference」を参照してください。
この値が減らされた場合、メッセージ長が新規最大値を超えたとしても、
すでにキュー上にあるメッセージはどれも影響を受けません。
|
-
共有可能性
- 複数のアプリケーションがこのキューからメッセージを取得できるかどうかを指定します。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
共有不能 |
| 範囲 |
-
共有不能
- このキューからメッセージを取得できるアプリケーション・インスタンスは、1 つだけです。
-
共有可能
- 複数のアプリケーション・インスタンスがこのキューからメッセージを取得できます。
|
-
入力オープン・オプション
- 入力のためにこのキューをオープンするアプリケーションに対するデフォルトの共有オプション
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
クリア |
| 範囲 |
-
排他的
- オープン要求は、キューからの排他的入力用です。
-
共有
- オープン要求は、キューからの共有入力用です。
|
-
メッセージ・デリバリー・シーケンス
- 取得要求に応じてキューからメッセージが配信される順序。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
優先順位 |
| 範囲 |
-
優先順位
- メッセージが、優先順位内で先入れ先出し法 (FIFO) で配信されます。
これは WebSphere MQ でのデフォルトですが、インストール時に変更されることがあります。
-
FIFO
- メッセージが FIFO 順序で配信されます。
このキュー上のメッセージに対しては、優先順位が無視されます。
|
-
バックアウトしきい値
- メッセージをバックアウトできる最大回数。
このしきい値に達すると、バックアウト再キューイング名プロパティーで指定されているバックアウト・キュー上でメッセージが再キューイングされます。
WebSphere MQ Queue Manager は、それぞれのメッセージがバックアウトされた回数を記録しています。
この数が、構成可能なしきい値に達すると、
接続コンシューマーがメッセージを名前付きバックアウト・キューに再キューイングします。
この再キューイングが何らかの理由で失敗した場合は、
そのメッセージはキューから除去され、送達不能キューに再キューイングされるか、あるいは、廃棄されます。
| データ型 |
整数 |
| デフォルト |
0 |
| 範囲 |
-
0
- メッセージを再キューイングしません。
-
1 以上
- メッセージが戻される回数。
メッセージは、指定されたバックアウト・キューでこの回数だけ再キューイングされます。
|
-
バックアウト再キューイング名
- メッセージがバックアウトしきい値を超えてバックアウトされた場合に、
それらのメッセージが再キューイングされるバックアウト・キューの名前。
WebSphere MQ Queue Manager は、それぞれのメッセージがバックアウトされた回数を記録しています。
この数が、構成可能なしきい値に達すると、
接続コンシューマーがメッセージを名前付きバックアウト・キューに再キューイングします。
この再キューイングが何らかの理由で失敗した場合は、
そのメッセージはキューから除去され、送達不能キューに再キューイングされるか、あるいは、廃棄されます。
| データ型 |
ストリング |
| デフォルト |
Null |
| 範囲 |
1 から 48 文字 |
-
バックアウト取得の強化
- メッセージのバックアウト回数のカウントを正確に保つために強化を使用するかどうかを指定します。
| データ型 |
列挙型 |
| 単位 |
該当なし |
| デフォルト |
クリア |
| 範囲 |
-
非強化
- カウントが強化されません。
これは WebSphere MQ でのデフォルトですが、インストール時に変更されることがあります。
-
強化
- カウントが強化されます。
|