アプリケーション・クライアントの IBM MQ プロバイダーのキュー接続ファクトリー設定

このパネルを使用して、IBM MQ Java™ Message Service (JMS) プロバイダーで使用するために、選択されたキュー接続ファクトリーの構成プロパティーを表示または変更します。これらの構成プロパティーは、JMS プロバイダーと IBM MQ との間に接続を作成する方法を制御します。

この「アプリケーション・クライアント・リソース構成ツール (ACRCT)」ページを表示するには、「ファイル」 > 「オープン」とクリックします。EAR ファイルのブラウズ後、「オープン」をクリックします。 選択した JAR ファイルを展開して、「メッセージング・プロバイダー」 > 「IBM MQ プロバイダー」とクリックします。 「Queue Connection Factories」を右マウス・ボタン・クリックして、「新規」をクリックします。 「一般」タブ上に以下のフィールドが表示さ れます。

注:
  • 指定するプロパティー値は、 IBM MQ の JMS リソースを構成する際に指定した値と一致していなければなりません。 JMS リソース用の IBM MQ の構成について詳しくは、IBM MQ インフォメーション・センターの『Java の使用』セクションを参照してください。
  • IBM MQ では、名前に最大 48 文字まで使用できますが、チャネルの場合は例外で、最大 20 文字までになります。

JMS プロバイダーのキュー接続ファクトリーには、以下のプロパティーがあります。

名前

WebSphere® Application Server 内で、このキュー接続ファクトリーを管理目的で使用する際の名前。 この名前は、WebSphere 管理ドメイン全体の JMS 接続ファクトリー内で固有でなければなりません。

通知
データ型 ストリング

説明

WebSphere Application Server 内で管理目的で使用する、この接続ファクトリーの説明。

通知
データ型 ストリング
デフォルト Null

JNDI 名

アプリケーション・クライアント・ランタイムは、 このフィールドを使用して構成情報を検索します。

ユーザー ID

呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に指定しない場合に、認証で「パスワード」プロパティーと一緒に使用するユーザー ID です。

「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。

呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に提供しない場合 (例えば、呼び出し側のアプリケーションがメソッド createQueueConnection() を使用する場合) は、接続ファクトリーの「ユーザー ID」プロパティーと「パスワード」プロパティーが使用されます。JMS クライアントは、ユーザー ID とパスワードを JMS サーバーに渡します。

通知
データ型 ストリング

Password

呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に提供していない場合、認証のために「ユーザー ID」プロパティーとともにこのパスワードを使用します。

「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。

通知
データ型 ストリング
デフォルト Null

再入力パスワード

パスワードを確認します。

キュー・マネージャー

この接続ファクトリー用の IBM MQ キュー・マネージャーの名前。

このファクトリーによって作成された接続は、そのキュー・マネージャーに接続します。

通知
データ型 ストリング

ホスト名およびポート情報の入力

このラジオ・ボタンはデフォルトで選択されます。これが選択されている場合は、ホスト・プロパティーおよびポート・プロパティーが使用可能になり、接続名リスト・プロパティーが使用不可になります。

通知
データ型 ラジオ・ボタン
デフォルト 選択

ホスト

クライアント接続専用で IBM MQ キュー・マネージャーが実行されているホストの名前。

通知
データ型 ストリング
デフォルト Null
範囲 有効な TCP/IP ホスト名

Port

IBM MQ キュー・マネージャーへの接続に使用される TCP/IP ポート番号 (クライアント接続の場合のみ)。

このポートは、IBM MQ キュー・マネージャー上で構成する必要があります。

通知
データ型 整数
デフォルト Null
範囲 IBM MQ キュー・マネージャー上で構成された有効な TCP/IP ポート番号。

接続名リスト情報の入力

このラジオ・ボタンを選択すると、接続名リスト・プロパティーが使用可能になり、ホスト名プロパティーおよびポート名プロパティーが使用不可になります。このラジオ・ボタンは、マルチインスタンス・キュー・マネージャーに接続する場合に選択します。

通知
データ型 ラジオ・ボタン
デフォルト クリア

接続名リスト

マルチインスタンス・キュー・マネージャーへの接続に使用できるホスト情報とポート情報のコンマ区切りリスト。

リストの形式は、次のとおりです。
host[(port)],[host[(port)]]
ここで、port はオプションで、設定されていない場合はデフォルトで 1414 に設定されます。以下に例を示します。
hostname1,hostname2(1415)

マルチインスタンス・キュー・マネージャーについて詳しくは、IBM MQ インフォメーション・センターを参照してください。

このプロパティーは、マルチインスタンス・キュー・マネージャーに接続する場合にのみ使用する必要があります。個別のキュー・マネージャーのリストへの接続には使用しないでください。使用すると、トランザクションの整合性問題が発生する可能性があります。

チャネル

IBM MQ キュー・マネージャーへの接続に使用されるチャネルの名前 (クライアント接続の場合のみ)。

通知
データ型 ストリング
デフォルト Null
範囲 1 から 20 文字の ASCII 文字

トランスポート・タイプ

IBM MQ キュー・マネージャーとの接続に、IBM MQ クライアント接続を使用するか、JNDI バインディングを使用するかを指定します。外部 JMS プロバイダーが、JMS クライアントと JMS サーバーの間の通信プロトコルを制御します。 非 ASF の非パーシスタント、非永続、非トランザクションのメッセージングを使用している場合、またはセキュリティー問題を解決する必要があり、クライアントがキュー・マネージャー・ノードに対してローカルである場合は、トランスポート・タイプを調整してください。

通知
データ型 列挙型
単位 該当なし
デフォルト BINDINGS
範囲
BINDINGS
JNDI バインディングは、キュー・マネージャーに 接続するために使用されます。BINDINGS は共有メモリー・プロトコルです。BINDINGS は、キュー・マネージャーが JMS クライアントと同じノードにあり、EJB ロールを使用して処理する必要のあるセキュリティー・リスクを見つけた場合にのみ使用できます。
CLIENT
IBM MQ クライアント接続を使用してキュー・マネージャーに接続します。CLIENT は典型的な TCP ベースのプロトコルです。
DIRECT
DIRECT モードを使用する IBM MQ Event Broker 用。DIRECT は軽量のソケット・プロトコルであり、非トランザクション的で、耐久性がなく、非パーシスタントなパブリッシュ/サブスクライブ・メッセージングで使用されます。DIRECT は、非 ASF プロトコルを使用するクライアントおよびメッセージ駆動型 Bean に対してのみ機能します。
QUEUED
QUEUED は、標準的な TCP プロトコルです。
推奨
キュー接続ファクトリー・トランスポート・タイプ
BINDINGS を指定すると 30 % 以上高速になりますが、セキュリティーを確保するために EJB ロールを正しくセットアップする必要があります。 セキュリティー上の懸念があって CLIENT を使用する必要がある場合は、SSL を適切に使用してキュー・マネージャーへの接続を保護してください。
トピック接続ファクトリー・トランスポート・タイプ
DIRECT は最も高速なトランスポート・タイプです。可能であれば DIRECT を使用してください。追加のセキュリティー・タスクを満たす必要があり、キュー・マネージャーが JMS クライアントに対してローカルの場合は、BINDINGS を使用してください。 QUEUED は、それ以外のすべての場合を想定したフォールバックです。DIRECT を設定した、CSD2 以前の IBM MQ MQ 5.3 は、メッセージ駆動型 Bean と併用され、負荷がかかった場合には、メッセージを失ってしまうことがあるので注意が必要です。このようなロスはブローカーの maxClientQueueSize が 0 に設定されていない場合に、クライアント・サイドのアプリケーションでも発生します。次のコマンドを使用すると、この値を 0 に設定できます。
#wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID
ここで、executionGroupUUID は、ブローカーを開始し、 イベント・ログ/アプリケーションのイベント 2201 を調べることにより見つけることができます。 この値は通常、ffffffff-0000-0000-000000000000 です。
注: WebSphere Application Server バージョン 6.1 には Java 5 ランタイムがあるため、IBM MQ 5.3 JMS は、WebSphere Application Server バージョン 6.1 内では使用できません。そのため、IBM MQ 5.3 キュー・マネージャーを使用して、仮想記憶間接続を確立できません。 以前、ユーザー接続に IBM MQ 5.3 と BINDINGS を使用しており、WebSphere Application Server バージョン 6.1 への移行で CLIENT ネットワーク接続に移動した場合は、性能が低下する可能性があります。[z/OS]IBM MQ 5.3 for z/OS® を使用している場合は、追加のフィーチャー・パックのインストールが必要になることがあります。

クライアント ID

IBM MQ キュー・マネージャーへの接続に使用される JMS クライアント ID。

通知
データ型 ストリング

CCSID

IBM MQ キュー・マネージャーで使用されるコード化文字セット ID。

このコード化文字セット ID (CCSID) は、IBM MQ がサポートする CCSID の 1 つでなければなりません。

通知
データ型 ストリング

サポートされる CCSID、およびコード化文字セット間のメッセージ・データ変換について詳しくは、IBM MQ インフォメーション・センターの『システム管理』および『アプリケーション・プログラミング・リファレンス』の各セクションを参照してださい。

メッセージ保存

このチェック・ボックスを選択すると、不要なメッセージがキューに残るように指定されます。 このチェック・ボックスが選択されないと、不要なメッセージは後処 理オプションに従 って処理されます。

通知
データ型 列挙型
単位 該当なし
デフォルト クリア
範囲
選択
不要なメッセージはキューに残ります。
クリア
不要なメッセージは後処理オプションに従って処理されます。

一時モデル

接続ファクトリーがまだ存在していない場合に、一時接続ファクトリーの作成に使用できるモデル定義の名前。

通知
データ型 ストリング
範囲 1 から 48 文字の ASCII 文字

一時キュー接頭部

動的キュー・ネーミングに使用される接頭部。

通知
データ型 ストリング

静止の場合に失敗

キュー・マネージャーが制御された失敗状態になった場合に、アプリケーションがメソッド呼び出しから戻されるかどうかを指定します。

通知
データ型 チェック・ボックス
デフォルト 選択

ローカル・サーバー・アドレス

ローカル・サーバー・アドレスを指定します。

通知
データ型 ストリング

ポーリング間隔

非同期メッセージの配信中に、すべての受信側の間でのスキャン間隔をミリ秒で指定します。

通知
データ型 整数
単位 ミリ秒
デフォルト 5000

再スキャン間隔

トピックに順不同で追加されたメッセージを探すために、トピックをスキャンする間隔 (ミリ秒) を指定します。

この間隔は、トピックに順不同で追加されたメッセージの IBM MQ ブラウズ・カーソルを考慮したスキャンを制御します。

通知
データ型 整数
単位 ミリ秒
デフォルト 5000

SSL 暗号スイート

IBM MQ への SSL 接続に使用する暗号スイートを指定します。

このプロパティーは、ご使用の JSSE プロバイダーで提供されている有効な暗号スイートに設定してください。 この値は SVRCONN チャネル (「チャネル」プロパティー) で指定された CipherSpec と一致していなければなりません。

「SSL ピア名」プロパティーを設定する場合は、 このプロパティーを設定する必要があります。

SSL 証明書ストア

SSL 証明書の失効を検査するために使用される、ゼロ個以上の証明書失効リスト (CRL) サーバーのリストを指定します。 このプロパティーに値を指定する場合は、Java 2 バージョン 1.4 の IBM MQ JVM を使用する必要があります。

この値は、スペースで区切られた項目のリストで、次のような形式になります。
ldap://hostname:[port]

シングル・スラッシュ (/) がこの値に続きます。port を省略した場合は、デフォルトの LDAP ポートである 389 が想定されます。接続時に、サーバーから提示された SSL 証明書が、指定された CRL サーバーと照合されます。 CRL セキュリティーについて詳しくは、IBM MQ インフォメーション・センターの『セキュリティー』セクションの『証明書失効リストの取り扱い (Working with Certificate Revocation Lists)』を参照してください。

SSL ピア名

SSL の場合は、識別名スケルトンです。これは、IBM MQ キュー・マネージャーによって提供された名前に一致している必要があります。この識別名は、接続時にサーバーによって提示された識別証明書を検査するために使用されます。

このプロパティーが設定されていない場合、このような証明書の検査が行われます。

「SSL 暗号スイート」プロパティーが指定されていない場合は、SSL ピア名プロパティーは無視されます。

このプロパティーは、コンマまたはセミコロンで区切られた、属性名と値の対のリストです。以下に例を示します。
CN=QMGR.*, OU=IBM, OU=WEBSPHERE

この例では、接続時にサーバーによって提示される識別証明書が検査されます。正常に接続するためには、証明書は QMGR で始まり、少なくとも 2 つの組織単位名 (最初が IBM®、2 つ目が WEBSPHERE) で構成される共通名を持っている必要があります。検査では、大/小文字が区別されません。

識別名、および IBM MQ での識別名の使用方法について詳しくは、IBM MQ インフォメーション・センターの「識別名」に関する情報を参照してください。

接続プール

接続プールの設定のオプショナル・セットを指定します。

接続プール・プロパティーは、すべての J2C コネクターに共通です。

アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 この接続プールは、IBM MQ 接続プールとは無関係です。ご使用のアプリケーションに合わせて接続およびセッションのプールのプロパティーを構成する必要があります。 そうしないと、接続およびセッションが期待どおりの動作をしない場合があります。

JMS リソースへのサーバー・サイド・アクセスが並行して行われ、それがデフォルト値を超える場合は、接続プールのサイズを変更してください。接続プールのサイズは、キューごと、あるいはトピックごとに設定されます。

通知
データ型 チェック・ボックス
デフォルト 選択

クライアント再接続オプション

通信またはキュー・マネージャーの障害が発生した場合に、クライアント・モード接続の再接続を自動的に実行するかどうかを指定します。このプロパティーは、接続ファクトリーがシン・クライアント環境または管理対象クライアント環境で使用されている場合でない限り、無視されます。

通知
データ型 ドロップダウン・リスト
デフォルト DISABLED
範囲
DISABLED
クライアント再接続は自動的に実行されません。
ASDEF
クライアント構成ファイルのチャネル・スタンザの DefRecon 属性からの値が使用されます。DefRecon 値が指定されていない場合、この設定の効果は、DISABLED の値の場合と同じになります。
RECONNECT
再接続は、キュー・マネージャー属性の値と一致するすべてのキュー・マネージャーに対して実行されます。これは、接続の最初の確立先のキュー・マネージャーとは異なる場合があります。
QMGR
再接続は、接続の最初の確立先のキュー・マネージャーに対してのみ実行されます。

自動クライアント再接続について詳しくは、IBM MQ インフォメーション・センターを参照してください。

クライアント再接続タイムアウト

通信またはキュー・マネージャーの失敗の後で、クライアント・モード接続がキュー・マネージャーに自動的に再接続しようと費やす最大秒数。シン・クライアント環境または管理対象クライアント環境で接続ファクトリーが使用されていない限り、このパラメーターは無視されます。 このパラメーターが使用されるかどうかは、クライアント再接続オプション・パラメーターの値によって決まります。

通知
データ型 整数
単位
デフォルト 1800
範囲 ゼロより大きく 2147483647 以下の値。

自動クライアント再接続について詳しくは、IBM MQ インフォメーション・センターを参照してください。


トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ucli_pqcfm
ファイル名:ucli_pqcfm.html