バージョン 5 のデフォルト・メッセージング・トピック接続ファクトリーの設定

このパネルを使用して、WebSphere® Application Server バージョン 5 アプリケーションによる パブリッシュ/サブスクライブ・メッセージング用の選択済み JMS トピック接続ファクトリーの構成プロパティーを表示または変更します。

WebSphere トピック接続ファクトリーは、WebSphere Application Server バージョン 5 アプリケーションが使用する デフォルトのメッセージング・プロバイダーへの JMS 接続を作成するために使用されます。

このページを表示するには、管理コンソールを使用して以下のステップを実行します。
  1. ナビゲーション・ペインで、「「リソース」 > 「JMS」 > JMS プロバイダー」をクリックします。
  2. (オプショナル) コンテンツ・ペインで、「有効範囲」の設定を、JMS リソースがアプリケーションに対して可視になるレベルに変更します。セル有効範囲レベルでバージョン 5 の JMS リソースを定義すると、 セル内のすべてのユーザーがその JMS リソースを検索したり使用したりすることができます。
  3. コンテンツ・ペインで、JMS 宛先をサポートする V5 デフォルトのメッセージング・プロバイダーの名前をクリックします。
  4. 「追加リソース」の下の「トピック接続ファクトリー」をクリックします。 既存の JMS トピック接続ファクトリーのリストが表示されます。
  5. 作業の対象となる JMS トピック接続ファクトリーの名前をクリックします。

V5 のデフォルト・メッセージング・プロバイダーで使用する JMS トピック接続ファクトリーには、以下のプロパティーがあります。

有効範囲

このリソース定義をアプリケーションに対して可視にするレベルを指定します。

メッセージング・プロバイダー、名前空間バインディング、または共用ライブラリーなどのリソースを複数の有効範囲で定義することができます。より限定的な有効範囲で定義されたリソースは、それより広い有効範囲で定義された重複するリソースをオーバーライドします。

表示された有効範囲は情報のためだけです。このパネルで変更することはできません。 異なる有効範囲のこのリソース (あるいは他のリソース) を参照または変更する場合は、メッセージング・プロバイダー設定パネルの有効範囲を変更し、「適用」をクリックしてから、リソース・タイプのリンクをクリックします。

データ型 ストリング
名前

IBM® WebSphere Application Server 内で、この JMS トピック接続ファクトリーを管理目的で使用する際の名前。この名前は、WebSphere 管理ドメイン全体の JMS 接続ファクトリー内で固有である必要があります。

データ型 ストリング
デフォルト Null
JNDI 名

名前空間にトピック接続ファクトリーをバインドするために使用される JNDI 名。

規則として、完全修飾の JNDI 名を、例えば、jms/Name の形式で使用します。ここで、Name はリソースの論理名です。

この名前は、プラットフォームのバインディング情報をリンクするために使用します。 バインディングにより、モジュールのデプロイメント記述子で定義されているリソースと、 プラットフォーム別に JNDI にバインドされている実際の (物理的な) リソースとの関連付けが行われます。

データ型 ストリング
説明

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

データ型 ストリング
デフォルト Null
カテゴリー

IBM WebSphere Application Server 管理レコード用の、このトピック接続ファクトリーを分類またはグループ化するために使用されるカテゴリー。

データ型 ストリング
ノード

JMS サーバーがこの接続ファクトリー用に実行される管理ノードの WebSphere ノード名。 このファクトリーによって作成された接続は、その JMS サーバーに接続します。

データ型 列挙型
デフォルト Null
範囲 WebSphere 管理ドメイン内のノードのドロップダウン・リスト。
ポート

JMS サーバーに接続するために接続が使用する、2 つのポートのうちのいずれかを指定します。QUEUED ポートは、全機能 JMS Publish/Subscribe サポートに使用し、DIRECT ポートは非持続的かつ非トランザクションで、非永続的サブスクリプション専用です。

注: メッセージ駆動型 Bean は、Publish/Subscribe サポートに直接リスナー・ポートを使用できません。 したがって、「ポート」を「Direct」に設定して構成したトピック接続ファクトリーは、メッセージ駆動型 Bean で使用することはできません。
データ型 列挙型
単位 該当なし
デフォルト QUEUED
範囲
QUEUED
全機能 JMS 準拠の Publish/Subscribe サポートに使用するリスナー・ポート。
DIRECT
Publish/Subscribe サポートの直接 TCP/IP 接続 (非トランザクション、 非持続的かつ非永続的サブスクリプション専用) に使用するリスナー・ポート。
コンポーネント管理認証別名

この別名は、アプリケーション管理認証のためのメッセージング・プロバイダーへの接続を認証するのに使用するユーザー ID とパスワードを指定します。

このプロパティーでは、WebSphere Application Server に定義されている J2C 認証データ・エントリー別名のリストを提供します。 使用するデータ・エントリー別名を選択して、 JMS プロバイダーへの新規接続を作成するための認証を受けることができます。

WebSphere Application Server に対する管理セキュリティーを使用可能にしている場合は、 メッセージング・プロバイダーへの新規接続の作成の認証を受けるために使用するユーザー ID とパスワードを指定する別名を選択します。 この別名の使用方法は、アプリケーション・コンポーネントのデプロイメント記述子の接続ファクトリー・リソース参照で宣言されているリソース認証 (res-auth) の設定によって異なります。

注: 12 文字より長いユーザー ID は、 バージョン 5 のデフォルトのメッセージング・プロバイダーによる認証には使用できません。 例えば、デフォルトの Windows NT® のユーザー ID Administrator は、13 文字なので使用できません。 したがって、WebSphere トピック接続ファクトリー用の認証別名では、 12 文字以下のユーザー ID を指定する必要があります。
コンテナー管理認証別名

この別名は、コンテナー管理認証のためのメッセージング・プロバイダーへの接続を認証するのに使用するユーザー ID とパスワードを指定します。

コンポーネント・リソース参照のログイン構成および関連プロパティーの仕様で、res-auth 値がコンテナーの場合のコンテナー管理対象認証ストラテジーが決定されます。 「DefaultPrincipalMapping」ログイン構成が使用されると、 関連プロパティーはコンテナー管理対象認証別名になります。このフィールドは、 コンポーネント・リソース参照の loginConfiguration が存在しない場合にのみ使用されます。新規別名の定義については、 関連項目の J2EE コネクター・アーキテクチャー (J2C) 認証データ・エントリーを参照してください。

このプロパティーでは、WebSphere Application Server に定義されている J2C 認証データ・エントリー別名のリストを提供します。 使用するデータ・エントリー別名を選択して、 JMS プロバイダーへの新規接続を作成するための認証を受けることができます。

WebSphere Application Server に対する管理セキュリティーを使用可能にしている場合は、 JMS プロバイダーへの新規接続の作成の認証を受けるために使用するユーザー ID とパスワードを指定する別名を選択します。 この別名の使用方法は、アプリケーション・コンポーネントのデプロイメント記述子の接続ファクトリー・リソース参照で宣言されているリソース認証 (res-auth) の設定によって異なります。

注: 12 文字より長いユーザー ID は、 組み込み WebSphere JMS プロバイダーによる認証には使用できません。 例えば、デフォルトの Windows NT ユーザー ID Administrator は、13 文字なので、組み込み WebSphere メッセージングでは使用できません。したがって、WebSphere JMS プロバイダー接続ファクトリー用の認証別名では、 12 文字以下のユーザー ID を指定する必要があります。
マッピング構成別名

認証別名のマップに使用されるモジュール。

コンポーネント・リソース参照のログイン構成および関連プロパティーの仕様で、res-auth 値がコンテナーの場合のコンテナー管理対象認証ストラテジーが決定されます。 このフィールドは、 コンポーネント・リソース参照の loginConfiguration が存在しない場合にのみ使用されます。

このフィールドは、「セキュリティー」 > 「JAAS 構成」 > 「アプリケーション・ログイン構成」プロパティー上で構成されたモジュールのリストを提供します。 マッピング構成について詳しくは、Java™ 認証・承認サービスの構成エントリー設定を参照してください。

データ型 列挙型
デフォルト Null
範囲
ClientContainer
クライアント・コンテナーが認証別名をマップします。
WSLogin
WSLogin モジュールが認証別名をマップします。
DefaultPrincipalMapping
JAAS 構成が、認証別名をユーザー ID およびパスワードにマップします。
クローン・サポート

このチェック・ボックスを選択してクローン・サポートを使用可能にし、 トピック・クローン全体で同一の永続サブスクリプションを使用できるようにします。

データ型 列挙型
デフォルト クリア
範囲
選択
クローン・サポートが使用可能になります。
クリア
クローン・サポートが使用不可になります。

このプロパティーを選択する場合は、「クライアント ID」プロパティーにも値を指定する必要があります。

クライアント ID

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

データ型 ストリング
範囲 有効な JMS クライアント ID
XA 使用可能

接続ファクトリーが、メッセージの XA 調整のためのものか、非 XA 調整のためのものかを指定し、アプリケーション・サーバーが XA QCF/TCF を使用するかどうかを制御します。 複数のリソースが同一のトランザクションで使用されている場合は、XA を使用可能にしてください。

このチェック・ボックス・プロパティーをクリアしても (非 XA 調整の場合)、JMS セッションはトランザクションに参加してはいますが、XA 呼び出しではなく、リソース・マネージャーのローカル・トランザクション呼び出し (session.commit および session.rollback) を使用します。 これによって、パフォーマンスを向上できます。ただし、WebSphere Application Server のトランザクションに参加させることができるリソースは、1 つのみになります。

最終参加者サポートを使用することにより、 1 つの非 XA リソースをその他の XA 可能リソースとともに参加させることができます。

ポート」プロパティーが「DIRECT」に設定されている WebSphere トピック接続ファクトリーの場合、このプロパティーは適用されず、常に非 XA 調整を使用します。

データ型 チェック・ボックス
デフォルト 選択済み (XA 調整に対応)
範囲
選択
接続ファクトリーは、メッセージの XA 調整に対応しています。
クリア
接続ファクトリーは、メッセージの非 XA 調整には対応していません。
推奨 メッセージ・キューまたは受信されたトピックがトランザクションの唯一のリソースである場合は、XA 調整を使用可能にしないでください。 他のキューや他のトピックなど、その他のリソースが関係している場合は、XA 調整を使用可能にしてください。
接続プール

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

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

アプリケーション・サーバーは、メッセージング・プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。構成が適切でないと、接続とセッションが想定どおりに動作しない場合があります。

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

セッション・プール

セッション・プール設定のオプションのセット。

このリンクは、すべての J2C コネクターに共通の、オプションの接続プール・ プロパティーのパネルを提供します。

アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。構成が適切でないと、接続とセッションが想定どおりに動作しない場合があります。




マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。

関連タスク
関連資料
接続プール設定
関連情報


ファイル名: umj_ptcfw.html