このパネルを使用して、MQSeries 製品 Java Messaging Service (JMS) プロバイダーで使用するために選択された接続ファクトリーの構成プロパティーを表示または変更します。 これらの構成プロパティーは、関連する JMS キュー宛先への接続の作成方法を制御します。
この「アプリケーション・クライアント・リソース構成ツール (ACRCT)」ページを 表示するには、「ファイル」>「オープン」とクリックします。 EAR ファイルのブラウズ後、「オープン」をクリックします。 選択済み JAR ファイル >「JMS プロバイダー」>「JMS プロバイダー・インスタンス」と展開します。 「WebSphere MQ Provider Connection Factories」を右クリックして、「新規」をクリックします。 「一般」タブ上に以下のフィールドが表示さ れます。
アプリケーション・クライアント・ランタイムは、 このフィールドを使用して構成情報を検索します。この名前は、アセンブリー・ツールの「Application Client Resource Reference」セクションの「一般」タブにある 「名前」フィールドの値と一致している必要があります。
呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に指定していない場合に、 認証のために「パスワード」プロパティーとともに使用されるユーザー ID です。
「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。
接続ファクトリーの「ユーザー ID」プロパティーおよび「パスワード」プロパティーは、呼び出し側のアプリケーションに ユーザー ID とパスワードが明示的に指定されていない場合に使用されます。これは、呼び出し側のアプリケーションがメソッド createQueueConnection() を使用する場合などが該当します。JMS クライアントは、ユーザー ID とパスワードを JMS サーバーに渡します。
データ型 | ストリング |
呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に提供していない場合、 認証のために「ユーザー ID」プロパティーとともにこのパスワードを使用します。
「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。
データ型 | ストリング |
デフォルト | Null |
WebSphere MQ キュー・マネージャーへの接続に使用される TCP/IP ポート番号 (クライアント接続の場合のみ)。
このポートは、WebSphere MQ キュー・マネージャー上で構成される必要があります。
データ型 | 整数 |
デフォルト | Null |
範囲 | WebSphere MQ キュー・マネージャー上で構成された有効な TCP/IP ポート番号 |
WebSphere MQ キュー・マネージャーへの接続に使用されるチャネルの名前 (クライアント接続の場合のみ)。
データ型 | ストリング |
デフォルト | Null |
範囲 | 1 から 20 文字の ASCII 文字 |
WebSphere MQ キュー・マネージャーとの接続に、WebSphere MQ クライアント接続を使用するか、JNI バインディングを使用するかを指定します。外部の JMS プロバイダーは、JMS クライアントと JMS サーバーとの間の通信プロトコルを制御します。非 ASF の、非永続的で耐久性のない非トランザクション・メッセージングを使用しているか、またはセキュリティー問題に対処したい場合で、クライアントがキュー・マネージャー・ノードに対してローカルのときは、トランスポート・タイプを調整してください。
データ型 | ストリング |
デフォルト | BINDINGS |
範囲 |
|
推奨 | DIRECT は最も高速なトランスポート・タイプです。可能な限り DIRECT を使用してください。
追加のセキュリティー・タスクを満たしたい場合、およびキュー・マネージャーが JMS クライアントに対してローカルの場合は、BINDINGS を使用してください。 DIRECT を設定した、CSD2 以前の
WebSphere MQ 5.3 は、メッセージ駆動型 Bean と併用され、負荷がかかった場合には、メッセージを失ってしまうことがあるので注意が必要です。これもブローカーの maxClientQueueSize が 0 に設定されていない場合に、
クライアント・サイド・ベースのアプリケーションでも発生します。
次のコマンドを使用すると、この値を 0 に設定できます。
#wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUIDブローカーを開始し、イベント・ログ/アプリケーションのイベント 2201 を調べることにより、executionGroupUUID の場所を見つけることができます。 この値は、通常、ffffffff-0000-0000-000000000000 です。 注: WebSphere MQ 5.3 JMS は、WAS 6.1 が Java 5 ランタイムであるので、WAS 6.1 内で使用できません。
したがって、WebSphere MQ 5.3 キュー・マネージャーでクロスメモリー接続を確立できません。
以前、ユーザー接続に WebSphere MQ 5.3 と BINDINGS を使用し、
WAS 6.1 への移行で CLIENT ネットワーク接続に移動した場合、性能低下を引き起こす可能性があります。
また、WebSphere MQ 5.3 for z/OS を使用している場合、追加機能パックを購入する必要がある場合があります。
|
WebSphere MQ キュー・マネージャーで使用するコード化文字セット ID (CCSID)。
このコード化文字セット ID (CCSID) は、WebSphere MQ で サポートされている CCSID のいずれかである必要があります。
データ型 | ストリング |
サポートされている CCSID、および、あるコード化文字セットから別のコード化文字セットへのメッセージ・データの変換について詳しくは、 「MQSeries システム管理の手引き」および「WebSphere MQ アプリケーション・プログラミング解説書」を参照してください。 これらの資料は、WebSphere MQ メッセージングのマルチプラットフォームおよびプラットフォーム固有の資料の Web ページ、 IBM Publications Center、 または「WebSphere MQ collection kit (SK2T-0730)」から入手可能です。
このチェック・ボックスを選択すると、不要なメッセージがキューに残されます。 このチェック・ボックスが選択されないと、不要なメッセージは後処 理オプションに従 って処理されます。
データ型 | 列挙型 |
単位 | 該当なし |
デフォルト | クリア |
範囲 |
|
すべてのコマンド・メッセージの送信先となる (パブリケー ションおよびパブリケーションの削除要求は除く) ブローカー・コントロール・キューの名前。
データ型 | ストリング |
単位 | En_US ASCII 文字 |
範囲 | 1 から 48 文字の ASCII 文字 |
パブリッシャー/サブスクライバー・メッセージ・ブローカーを 提供する MQSeries キュー・マネージャーの名前。
データ型 | ストリング |
単位 | En_US ASCII 文字 |
範囲 | 1 から 48 文字の ASCII 文字 |
デフォルト・ストリームのすべてのパブリケーション・メッセージを受信する ブローカーの入力キューの名前。
デフォルト・ストリームのすべてのパブリケーション・メッセージを受信するブローカーの入力キュー (ストリーム・キュー) の名前。 アプリケーションは、このキューに対して、 デフォルト・ストリーム上のパブリケーションの削除要求を送信することもできます。
データ型 | ストリング |
単位 | En_US ASCII 文字 |
範囲 | 1 から 48 文字の ASCII 文字 |
耐久性のないサブスクリプション・メッセージの検索元となるブローカー・キューの名前。
耐久性のないサブスクリプション・メッセージの検索元となるブロー カー・キューの名前。 サブスクライバーは、サブスクリプションの登録時にキューの名前を指定します。
データ型 | ストリング |
単位 | En_US ASCII 文字 |
範囲 | 1 から 48 文字の ASCII 文字 |
ConnectionConsumer 要求の耐久性のないサブスクリプション・メッセージの 検索元となるブローカー・キューの名前。 このプロパティーは、Web コンテナーを使用する場合にのみ適用されます。
データ型 | ストリング |
単位 | En_US ASCII 文字 |
範囲 | 1 から 48 文字の ASCII 文字 |
メッセージ・ブローカーを MQSeries MA0C SupportPac または より新しいバージョンの WebSphere ファミリーのメッセージ・ブローカー製 品のいずれから提供するかを指定します。
データ型 | 列挙型 |
デフォルト | 拡張 |
範囲 |
|
パブリッシュ/サブスクライブ・クリーンアップ・ユーティリティーで提供されるクリーンアップのレベルを指定します。
データ型 | 列挙型 |
デフォルト | SAFE |
範囲 |
|
ブローカー・メッセージを選択する場所を指定します。
データ型 | 列挙型 |
デフォルト | BROKER |
範囲 | |
|
WebSphere MQ がアクティブ JMS サブスクリプションに関するデータを保管する場所を指定します。
データ型 | 列挙型 |
デフォルト | MIGRATE |
範囲 |
|
この接続ファクトリーがマルチキャスト・トランスポートを使用するかどうかを指定します。
データ型 | 列挙型 |
デフォルト | AS_CF |
範囲 |
|
ダイレクト・ブローカー権限を使用するかどうかを指定します。
データ型 | 列挙型 |
デフォルト | NONE |
範囲 |
|
トピックに順不同で追加されたメッセージを探すために、トピックをスキャンする間隔 (ミリ秒) を指定します。
この間隔は、トピックに順不同で追加されたメッセージの WebSphere MQ ブラウズ・カーソルを考慮したスキャンを制御します。
データ型 | 整数 |
単位 | ミリ秒 |
デフォルト | 5000 |
範囲 |
WebSphere MQ への SSL 接続に使用する暗号スイートを指定します。
このプロパティーは、ご使用の JSSE プロバイダーで提供されている有効な暗号スイートに設定してください。 この値は SVRCONN チャネル (「チャネル」 プロパティー) で指定された CipherSpec と一致していなければなりません。
「SSL ピア名」プロパティーを設定する場合は、 このプロパティーを設定する必要があります。
SSL 証明書の失効を検査するために使用される、ゼロ個以上の証明書取り消しリスト (CRL) サーバーのリストを指定します。 このプロパティーに値を指定する場合は、Java 2 バージョン 1.4 の WebSphere MQ JVM を使用する必要があります。
ldap://hostname:[port]
シングル・スラッシュ (/) がこの値に続きます。port を省略した場合は、デフォルトの LDAP ポートである 389 が想定されます。接続時に、サーバーから提示された SSL 証明書が、指定された CRL サーバーと照合されます。 CRL セキュリティーについての詳細は、「WebSphere MQ Security」の セクション『"Working with Certificate Revocation Lists"』を参照してください (http://publibfp.boulder.ibm.com/epubs/html/csqzas01/csqzas012w.htm#IDX2254 などにあります)。
SSL の場合は、識別名 のスケルトンです。これは、WebSphere MQ キュー・マネージャーによって提供された名前に一致していなければなりません。 この識別名は、接続時にサーバーによって提示された識別証明書を検査するために使用されます。
このプロパティーが設定されていない場合、このような証明書の検査が行われます。
「SSL 暗号スイート」プロパティーが指定されていない場合は、SSL ピア名プロパティーは無視されます。
CN=QMGR.*, OU=IBM, OU=WEBSPHERE
この例の場合、接続時にサーバーによって提示された識別証明書が検査されます。正常に接続するためには、証明書は QMGR で始まり、少なくとも 2 つの組織単位名 (最初が IBM、 2 つ目が WEBSPHERE) で構成される共通名を持っていなければなりません。検査では、大/小文字が区別されません。
識別名と、WebSphere MQ におけるその使用方法の詳細については、「WebSphere MQ Security」のセクション『"Distinguished Names"』を参照してください。
接続プールの設定のオプショナル・セットを指定します。
接続プール・プロパティーは、すべての J2C コネクターに共通です。
アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 これは、WebSphere MQ 接続プールとは無関係です。 アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。 構成が適切でないと、接続とセッションが正しく動作しない場合があります。
JMS リソースへのサーバー・サイド・アクセスが並行して行われ、それがデフォルト値を超える場合は、接続プールのサイズを変更してください。接続プールのサイズは、キューごと、あるいはトピックごとに設定されます。
データ型 | チェック・ボックス |
デフォルト | 選択 |