デフォルトのメッセージング・プロバイダーのキュー接続ファクトリー [設定]

規則として、 jms/Name という形式の JNDI 名を使用します。ここで、Name はリソースの論理名です。 JNDI の使用およびその構文について詳しくは、トピック『WebSphere® Application Server の JNDI サポート』を参照してください。

これは、作業を処理するいずれかの メッセージング・エンジンを決定するために使用されるターゲットの名前を示します。 ターゲットのタイプは、「ターゲット・タイプ」プロパティーで示されます。

接続は、選択基準を満たす使用可能なメッセージング・エンジン間でロード・バランシングされます。

アプリケーションが、バス内のメッセージング・エンジンに接続できるようにする場合は、 このプロパティーを設定しないでください。

このプロパティーを、他の接続ファクトリー・プロパティーとともに接続のワークロード管理用に使用する方法については、トピック「バスへの JMS 接続の管理プロパティー」を参照してください。

このプロパティーを、他の接続ファクトリー・プロパティーとともに接続のワークロード管理用に使用する方法については、トピック「バスへの JMS 接続の管理プロパティー」を参照してください。

選択したメッセージング・エンジンがアプリケーションと同じサーバーにある場合は、直接プロセス内接続が実行され、このトランスポート・チェーン・プロパティーは無視されます。

このプロパティーを変更する必要があるのは、 アプリケーション・サーバーの外側でクライアント・アプリケーションが実行されているか、 アプリケーションが別のセル内のサーバー上にあり、この接続ファクトリーを 使用して、接続ファクトリーで指定されたターゲットのサービス統合バスに 接続したい場合のみです。

デフォルトのメッセージング・プロバイダーの JMS 宛先を使用するために、アプリケーションは、宛先が割り当てられているターゲット・サービス統合バスのメッセージング・エンジンに接続します。例えば、JMS キューがサービス統合バスのキュー宛先に割り当てられます。

アプリケーション・サーバー外で実行中のクライアント・アプリケーション (例えば、クライアント・コンテナー内あるいは WebSphere Application Server 環境外で実行中のもの) は、接続する適切なメッセージング・エンジンをターゲット・バスで直接見つけることはできません。同様に、 セル内のサーバー上で稼働するアプリケーションが別のセル内のターゲット・ バスに接続する場合、このアプリケーションは、ターゲット・バス内で接続 する適切なメッセージング・エンジンを直接見つけることはできません。

これらのシナリオでは、クライアント (または別のバス内のサーバー) が、 ターゲット・バスのメンバーであるブートストラップ・サーバー を介してブートストラップ・プロセスを完了する必要があります。 ブート ストラップ・サーバーは SIB サービスを実行するアプリケーション・サーバーですが、 メッセージング・エンジンを実行する必要はありません。ブートストラップ・サーバーは、必要なターゲット・トランスポート・チェーンをサポートするアプリケーション・サーバーで稼働するメッセージング・エンジンを選択します。ブートストラップ・プロセスを可能にするには、クライアントが使用する接続ファクトリー内に、1 つ以上のプロバイダー・エンドポイント を構成する必要があります。

ブートストラップ・サーバーは、特定のポートと ブートストラップ・トランスポート・チェーンを使用します。このポートは、 リンクのリモート・エンドをホストするメッセージング・エンジンの SIB_ENDPOINT_ADDRESS (またはセキュリティーが使用可能になっている場合は SIB_ENDPOINT_SECURE_ADDRESS) です。これらは、ホスト名とともにブートストラップ・サーバーのエンドポイント・アドレス となります。

アプリケーションが使用する JMS 接続ファクトリーのプロパティーは、適切なメッセージング・エンジンの選択および選択されたメッセージング・エンジンへのアプリケーションの接続方法を管理します。

• セキュリティー・クレデンシャルが指定されていない場合、デフォルトでは次のようになります。
  • ホストが指定されていない場合、localhost が使用されます。
  • ポートが指定されていない場合、ポート 7276 が使用されます。
  • ブートストラップ・チャネル・チェーンが指定されていない場合、BootstrapBasicMessaging という 名前のブートストラップ・トランスポート・チェーンが使用されます。
• セキュリティー・クレデンシャルが指定されている場合、デフォルトでは次のようになります。
  • ホストが指定されていない場合、localhost が使用されます。
  • ポートが指定されていない場合、ポート 7286 が使用されます。
  • ブートストラップ・チャネル・チェーンが指定されていない場合、BootstrapBasicMessaging という 名前のブートストラップ・トランスポート・チェーンが使用されます。

注: IBM® i プラットフォームの場合は、(少なくとも) デフォルト・ホスト名を localhost から your.server.name に変更する必要があります。

アプリケーションにエンドポイント・アドレスの異なるブートストラップ・サーバーを使用させたい場合は、クライアント・アプリケーションが使用する JMS 接続ファクトリーの「プロバイダー・エンドポイント」プロパティー で、必要なエンドポイント・アドレスを指定する必要があります。ブートストラップ・サーバーのエンドポイント・アドレスは 1 つ以上指定できます。

ブートストラップ・サーバーのエンドポイント・アドレスを、アプリケーション・サーバーの外側のアプリケーションが使用する各 JMS 接続ファクトリーで指定する必要があります。 ブートストラップ・サーバーの長いリストを指定しなくても済むように、 少数の高可用性サーバーを専用ブートストラップ・サーバーとして提供 することができます。これにより、各接続ファクトリーに短いブートストラップ・サーバーのリストを指定するだけですみます。

boothost1:7278:BootstrapBasicMessaging
またはboothost1:7278

boothost2:7289:BootstrapTunneledSecureMessaging

[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]

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 宛先の「Read ahead」プロパティーを設定することにより、個々の JMS 宛先でこのプロパティーをオーバーライドすることができます。

• アプリケーションは、JMS オブジェクト・メッセージに含まれているデータ・オブジェクトは変更しません。
• アプリケーションは、writeBytes(byte[]) の単一呼び出しを使用して JMS バイト・メッセージにデータを追加します。 メッセージにバイト配列を設定した後で、そのバイト配列を変更することはありません。

有効にすると、この接続ファクトリーを使用してバスに接続されているメッセージ・プロデューサー・アプリケーションが送信したオブジェクト・メッセージまたはバイト・メッセージのデータは、設定時にコピーされず、必要不可欠な場合のみ、システムによってメッセージ・データがシリアライズされます。 そのようなメッセージを送信するアプリケーションは、メッセージに設定されたデータを変更できません。

• アプリケーションは、JMS オブジェクト・メッセージから取得したデータ・オブジェクトは変更しません。 このデータ・オブジェクトは読み取り専用として取り扱われます。

有効にすると、この接続ファクトリーに接続されているメッセージ・コンシューマー・アプリケーションが受信したオブジェクト・メッセージのメッセージ・データは、必要不可欠な場合のみ、システムによってシリアライズされます。 これらのメッセージから取得したデータは、アプリケーションで読み取り専用として扱う必要があります。

トランザクション・コンテキストなしで確立される接続をログに記録する場合は、このプロパティーを選択します。

このオプションは、コンテナー管理パーシスタンス (CMP) Entity Bean を使用可能にして、メッセージング・エンジンのデータ・ストアが使用するデータベース接続を共有できるようにするタスクの一部として使用します。これによって、メッセージ・スループット全体のパフォーマンスが 15% 向上すると推定されますが、メッセージング・エンジンを含むアプリケーション・サーバーに接続された Entity Bean にしか使用できません。

このオプションの使用について詳しくは、トピック『CMP Entity Bean およびメッセージング・エンジン・データ・ストアの使用可能化によるデータベース接続の共有』を参照してください。

このプロパティーでは 、WebSphere Application Server に定義されている JCA 認証データ・エントリー・エイリアスのリストを提供します。 使用するデータ・エントリー・エイリアスを選択して、XA リカバリー処理中に認証を受けることができます。

関連するサービス統合バスに対するセキュリティーを使用可能にしている場合は、WebSphere Application Server のユーザー・レジストリーで有効である XA リカバリーに使用するユーザー ID とパスワードを指定するエイリアスを選択します。このプロパティーは、バス・セキュリティーが使用可能で、XA トランザクションを 使用する場合に設定する必要があります。