JMS アクティベーション・スペック [設定]

「宛先タイプ」プロパティーで、宛先のタイプを選択します。

JMS をサポートしているリソース・アダプターの場合は、リソース・アダプターが JMS 宛先からのメッセージを提供できるように、javax.jms.Destinations をアクティベーション・スペックに関連付ける必要があります。 この場合、管理者は、javax.jms.Destination インターフェースを実装して JNDI にそれをバインドする J2C 管理オブジェクトを構成します。

J2C 管理オブジェクトを構成して、 setDestination(javax.jms.Destination) メソッドを実行する ActivationSpec クラスを使用します。 この場合、宛先 JNDI 名を指定することができます (つまり、 javax.jms.Destination を実行する J2C 管理オブジェクト用の JNDI 名 )。

アプリケーションの起動中は、エンドポイントの活動化の一部とし てアクティベーション・スペックが初期化されている場合、サーバーは宛先 JNDI 名を使用し て宛先の管理オブジェクトを検索し、それをアクティベーション・スペックのインスタンス上に設定します。

JMSType='car' AND color='blue' AND weight>2500

セレクター・ストリングは、JMS メッセージ・ヘッダー内のフィールド、およびメッセージ・プロパティー内のフィールドを参照できます。メッセージ・セレクターは、メッセージ本体の値を参照することはできません。

ヌル値 (空ストリング) は、メッセージ・コンシューマー用のメッセージ・セレクターがないことを示します。

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

ホスト名が指定されない場合は、localhost がデフォルト値として使用されます。

ポート番号が指定されない場合は、7276 がデフォルト値として使用されます。

プロトコルが指定されない場合は、BootstrapBasicMessaging などの定義済みのチェーンがデフォルト値として使用されます。

エンドポイントが自動的に停止された場合、管理コンソール・パネルでのその「Status (状況)」は赤です。「再開」をクリックして、手動で再始動する必要があります。

エンドポイント が再始動された後、そのエンドポイントが停止される原因となった失敗したメッセージはすべて再試行 されます。メッセージがそれでも失敗する場合は、構成済みであれば、メッセージは例外宛先に移動されます。

このサブスクリプション名は、所定のクライアント ID 内で固有のものである必要があります。

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

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

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

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

このオプションは、サーバー・クラスターをサポートする WebSphere Application Server 環境でのみ、デフォルトから変更してください。

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

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

コンシューマーに割り当てられているメッセージは、サーバー上でロックされており、その宛先の他のコンシューマーは、それらのメッセージを使用することはできません。 コンシューマーに割り当てられているが、そのコンシューマーがクローズされるまで使用されなかったメッセージは、 クローズ後にサーバー上でアンロックされるため、他のコンシューマーがそれらを受信することができます。

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

このプロパティーが使用されるのは、ターゲット・バスのメンバーであるサーバーで MDB アプリケーションが実行されている場合のみです。 ターゲット・バスのメンバーではないサーバーで MDB が実行されている場合は、このプロパティーは使用されません。

ターゲット・バスのメンバーであるサーバーで MDB アプリケーションが実行されている場合、 そのサーバーが実行中のメッセージング・エンジンもホストしているかどうかに関係なく、 このオプションを有効にすることで MDB アプリケーションはメッセージを処理できるようになります。 このオプションが有効ではない場合、ローカルで ME が実行されていないサーバー上の MDB アプリケーションはメッセージを処理しません。

詳しくは、『メッセージ駆動型 Bean がクラスター内で接続する方法』のトピックを参照してください。