パブリッシュ/サブスクライブ・メッセージング用に、JMS トピックの関連 JMS プロバイダーへの接続を確立する場合に、JMS トピック接続ファクトリーを使用します。トピック接続ファクトリーの管理オブジェクトを使用して、デフォルトのメッセージング・プロバイダーの JMS トピック接続ファクトリーを管理します。
コンソールのこのページを表示するには、以下のパスのいずれかをクリックします。
デフォルトでは、サーバー・コンテナーで (例えば、エンタープライズ Bean から) この JMS 接続ファクトリーを使用して作成された接続は 、Java Platform, Enterprise Edition (Java EE) コネクター・アーキテクチャー (JCA) 接続プールを使用してプールされます。 この接続ファクトリーの接続プール設定は、管理コンソール・パネルの「追加プロパティー」セクションにある「接続プール・プロパティー」を選択することで変更できます。
接続ファクトリーのコンテナー管理認証別名とマッピング・モジュールの構成は、非推奨になりました。 これらのプロパティーは、アプリケーションのリソース参照に対するバインディングで設定しています。既存のアプリケーションのバインディングを変更したくない場合は、J2C パネルでこの接続ファクトリーを確認し、これらのプロパティーを検索します。
「構成」タブは、このオブジェクトの構成プロパティーを表示します。これらのプロパティーの値は、ランタイム環境を停止してから再始動しても保持されています。ランタイム環境に構成変更を適用する方法については、インフォメーション・センターのタスクの説明を参照してください。
アプリケーション・サーバーがこのリソース・オブジェクトを使用できる最高トポロジー・レベルを指定します。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
Java Message Service (JMS) に基づいて非同期メッセージングを有効化する JMS プロバイダーを指定します。JMS プロバイダーは、特定の JMS キュー宛先またはトピック宛先に対して接続を確立するための J2EE 接続ファクトリーを備えています。JMS プロバイダーの管理オブジェクトは、関連する JMS プロバイダーの JMS リソースを管理するために使用されます。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
リソースに必要な表示名。
| 通知 | 値 |
|---|---|
| 必須 | はい |
| データ型 | ストリング |
リソースの JNDI 名。
規則として、 jms/Name という形式の JNDI 名を使用します。ここで、Name はリソースの論理名です。 JNDI の使用およびその構文について詳しくは、トピック『WebSphere® Application Server の JNDI サポート』を参照してください。
| 通知 | 値 |
|---|---|
| 必須 | はい |
| データ型 | ストリング |
リソースのオプションの説明。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | テキスト域 |
リソースの分類またはグループ化の際に使用する、オプションのカテゴリー・ストリング。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
接続先となるバスの名前。
| 通知 | 値 |
|---|---|
| 必須 | はい |
| データ型 | カスタム |
メッセージング・エンジンのグループを識別するターゲットの名前。「TargetType」プロパティーを使用してターゲットのタイプを指定します。
これは、作業を処理するいずれかの メッセージング・エンジンを決定するために使用されるターゲットの名前を示します。 ターゲットのタイプは、「ターゲット・タイプ」プロパティーで示されます。
接続は、選択基準を満たす使用可能なメッセージング・エンジン間でロード・バランシングされます。
アプリケーションが、バス内のメッセージング・エンジンに接続できるようにする場合は、 このプロパティーを設定しないでください。
このプロパティーを、他の接続ファクトリー・プロパティーとともに接続のワークロード管理用に使用する方法については、トピック「バスへの JMS 接続の管理プロパティー」を参照してください。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
ターゲット・プロパティーで指定されたターゲットのタイプ。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
このプロパティーは、ターゲット・グループの重要度を指定します。
このプロパティーを、他の接続ファクトリー・プロパティーとともに接続のワークロード管理用に使用する方法については、トピック「バスへの JMS 接続の管理プロパティー」を参照してください。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
アプリケーションと異なるプロセスにあるメッセージング・エンジンに接続する際に、 アプリケーションがターゲットとするインバウンド・トランスポート・チェーンの名前。別のプロセスのメッセージング・エンジンが選択されたときには、 指定されたインバウンド・トランスポート・チェーンを実行するサーバーにメッセージング・エンジンがある場合にのみ接続が確立されます。詳しくは、インフォメーション・センターを参照してください。
選択したメッセージング・エンジンがアプリケーションと同じサーバーにある場合は、直接プロセス内接続が実行され、このトランスポート・チェーン・プロパティーは無視されます。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
ブートストラップ・サーバーに接続する場合は、hostName:portNumber:chainName という構文を持つ、コンマで区切られたエンドポイント・トリプレットのリストが使用されます。例えば、Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging のようにします。hostName が指定されていない場合、デフォルトはローカル・ホストになります。 portNumber が指定されていない場合、デフォルトは 7276 になります。chainName が指定されていない場合、 デフォルトは BootstrapBasicMessaging になります。詳しくは、インフォメーション・センターを参照してください。
このプロパティーを変更する必要があるのは、 アプリケーション・サーバーの外側でクライアント・アプリケーションが実行されているか、 アプリケーションが別のセル内のサーバー上にあり、この接続ファクトリーを 使用して、接続ファクトリーで指定されたターゲットのサービス統合バスに 接続したい場合のみです。
デフォルトのメッセージング・プロバイダーの JMS 宛先を使用するために、アプリケーションは、宛先が割り当てられているターゲット・サービス統合バスのメッセージング・エンジンに接続します。例えば、JMS キューがサービス統合バスのキュー宛先に割り当てられます。
アプリケーション・サーバー外で実行中のクライアント・アプリケーション (例えば、クライアント・コンテナー内あるいは WebSphere Application Server 環境外で実行中のもの) は、接続する適切なメッセージング・エンジンをターゲット・バスで直接見つけることはできません。同様に、 セル内のサーバー上で稼働するアプリケーションが別のセル内のターゲット・ バスに接続する場合、このアプリケーションは、ターゲット・バス内で接続 する適切なメッセージング・エンジンを直接見つけることはできません。
これらのシナリオでは、クライアント (または別のバス内のサーバー) が、 ターゲット・バスのメンバーであるブートストラップ・サーバー を介してブートストラップ・プロセスを完了する必要があります。 ブート ストラップ・サーバーは SIB サービスを実行するアプリケーション・サーバーですが、 メッセージング・エンジンを実行する必要はありません。ブートストラップ・サーバーは、必要なターゲット・トランスポート・チェーンをサポートするアプリケーション・サーバーで稼働するメッセージング・エンジンを選択します。ブートストラップ・プロセスを可能にするには、クライアントが使用する接続ファクトリー内に、1 つ以上のプロバイダー・エンドポイント を構成する必要があります。
ブートストラップ・サーバーは、特定のポートと ブートストラップ・トランスポート・チェーンを使用します。このポートは、 リンクのリモート・エンドをホストするメッセージング・エンジンの SIB_ENDPOINT_ADDRESS (またはセキュリティーが使用可能になっている場合は SIB_ENDPOINT_SECURE_ADDRESS) です。これらは、ホスト名とともにブートストラップ・サーバーのエンドポイント・アドレス となります。
注: IBM® i プラットフォームの場合は、(少なくとも) デフォルト・ホスト名を
localhost から your.server.name に変更する必要があります。アプリケーションにエンドポイント・アドレスの異なるブートストラップ・サーバーを使用させたい場合は、クライアント・アプリケーションが使用する JMS 接続ファクトリーの「プロバイダー・エンドポイント」プロパティー で、必要なエンドポイント・アドレスを指定する必要があります。ブートストラップ・サーバーのエンドポイント・アドレスは 1 つ以上指定できます。
ブートストラップ・サーバーのエンドポイント・アドレスを、アプリケーション・サーバーの外側のアプリケーションが使用する各 JMS 接続ファクトリーで指定する必要があります。 ブートストラップ・サーバーの長いリストを指定しなくても済むように、 少数の高可用性サーバーを専用ブートストラップ・サーバーとして提供 することができます。これにより、各接続ファクトリーに短いブートストラップ・サーバーのリストを指定するだけですみます。
boothost1:7278:BootstrapBasicMessaging
またはboothost1:7278
また、ホスト boothost2 でセキュア・ポート 7289 が割り当てられたサーバーで、定義済みのトランスポート・チェーン BootstrapTunneledSecureMessaging を使用する場合は、次のように指定します。boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
各部の意味は、次のとおりです。[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
.
値を指定しない場合のデフォルトは、localhost です。
注: IBM i プラットフォームの場合は、(少なくとも) デフォルト・ホスト名を
localhost から your.server.name に変更する必要があります。port_number を指定しない場合のデフォルトは 7276 です。
管理コンソールを使用してこれらの値のいずれかを見つけるには、をクリックします。
以下の定義済みブートストラップ・トランスポート・チェーンが提供されています。
host_name : : chain_name (2 つのコロンを使用) ではなく host_name : chain_name と指定するのは誤りです。 なにも入力しないか、「a」、「a:」、「:7276」、「::chain」などのいずれかを入力することができます。 デフォルト値は、値を指定しない場合に適用されますが、 フィールドを「:」で区切る必要があります。
boothost1:7278:BootstrapBasicMessaging,
boothost2:7289:BootstrapTunneledSecureMessaging,
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | テキスト域 |
接続要求を受け入れることができるメッセージング・エンジンの、ブートストラップ・メッセージング・エンジンに関連した接近性。
このプロパティーを、他の接続ファクトリー・プロパティーとともに接続のワークロード管理用に使用する方法については、トピック「バスへの JMS 接続の管理プロパティー」を参照してください。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
この接続ファクトリーを使用して作成されたすべての接続上の永続トピック・サブスクリプションに必要な JMS クライアント ID。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
この JMS 接続ファクトリーから作成されたオブジェクトの永続サブスクリプションに配信されるメッセージを保管するために使用される、メッセージング・エンジンの名前。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | カスタム |
この接続ファクトリーを使用して送信される非パーシスタント JMS メッセージに適用される信頼性。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
この接続ファクトリーを使用して送信されるパーシスタント JMS メッセージに適用される信頼性。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
先読みは、コンシューマーにメッセージを先制して割り当てる最適化です。これにより、コンシューマーの要求に応えるためにかかる時間が改善されます。
コンシューマーに割り当てられているメッセージは、サーバー上でロックされており、その宛先の他のコンシューマーは、それらのメッセージを使用することはできません。 コンシューマーに割り当てられているが、そのコンシューマーがクローズされるまで使用されなかったメッセージは、 クローズ後にサーバー上でアンロックされるため、他のコンシューマーがそれらを受信することができます。
JMS 宛先の「Read ahead」プロパティーを設定することにより、個々の JMS 宛先でこのプロパティーをオーバーライドすることができます。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
| 範囲 |
|
この接続ファクトリーを使用してアプリケーションが作成した一時トピックの開始時に使用される接頭部。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ストリング |
ラージ・オブジェクト・メッセージまたはバイト・メッセージを送信する際、メッセージ・ペイロードのシリアライズ、デシリアライズ、およびコピーのためのメモリーのコストおよびプロセッサー使用量はかなりのものになることがあります。 接続ファクトリーまたはアクティベーション・スペックで「pass message payload by reference」プロパティーを使用可能にする場合は、JMS 1.1 の指定をオーバーライドするようにデフォルト・メッセージング・プロバイダーに通知することで、このデータ・コピーの量が減ったり、行われなくなったりすることがあります。
有効にすると、この接続ファクトリーを使用してバスに接続されているメッセージ・プロデューサー・アプリケーションが送信したオブジェクト・メッセージまたはバイト・メッセージのデータは、設定時にコピーされず、必要不可欠な場合のみ、システムによってメッセージ・データがシリアライズされます。 そのようなメッセージを送信するアプリケーションは、メッセージに設定されたデータを変更できません。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ブール値 |
有効にすると、この接続ファクトリーに接続されているメッセージ・コンシューマー・アプリケーションが受信したオブジェクト・メッセージのメッセージ・データは、必要不可欠な場合のみ、システムによってシリアライズされます。 これらのメッセージから取得したデータは、アプリケーションで読み取り専用として扱う必要があります。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ブール値 |
接続の獲得時に欠落トランザクション・コンテキストがあることをコンテナーがログに記録するかどうか。
トランザクション・コンテキストなしで確立される接続をログに記録する場合は、このプロパティーを選択します。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ブール値 |
キャッシュ・ハンドル (Bean のインスタンス変数に保持されるハンドル) をコンテナーによって追跡するかどうか。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ブール値 |
XA リカバリー処理中に使用する認証別名。
このプロパティーでは、WebSphere Application Server に定義されている J2C 認証データ・エントリー・エイリアスのリストを提供します。使用するデータ・エントリー・エイリアスを選択して、XA リカバリー処理中に認証を受けることができます。
関連するサービス統合バスに対するセキュリティーを使用可能にしている場合は、WebSphere Application Server のユーザー・レジストリーで有効である XA リカバリーに使用するユーザー ID とパスワードを指定するエイリアスを選択します。このプロパティーは、バス・セキュリティーが使用可能で、XA トランザクションを 使用する場合に設定する必要があります。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
この接続ファクトリーが使用する Java Authentication and Authorization Service (JAAS) マッピング構成のマッピング構成別名を指定します。
このフィールドは、 コンポーネント・リソース参照の loginConfiguration が存在しない場合にのみ使用されます。コンポーネント・リソース参照のログイン構成および関連プロパティーの仕様で、res-auth 値がコンテナーの場合のコンテナー管理対象認証ストラテジーが決定されます。DefaultPrincipalMapping ログイン構成を指定すると、関連のプロパティーは JAAS - J2C 認証 データ入力別名になります。新しい別名を定義するには、関連項目 JAAS - J2C 認証データ・エントリーを 参照してください。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |
この別名は、コンテナー管理認証のための JMS プロバイダーへの接続の認証に使用されるユーザー ID とパスワードを指定します。 この設定は、res-auth 値がコンテナーで、アプリケーションのデプロイ時に認証別名が設定されていない場合にのみ使用されます。
| 通知 | 値 |
|---|---|
| 必須 | いいえ |
| データ型 | ドロップダウン・リスト |