JMS アクティベーション・スペックは、1 つ以上のメッセージ駆動型 Bean と関連付けられ、それらがメッセージを受け取るのに必要な構成を提供します。
メッセージ駆動型 Bean を使用して Java™ EE コネクター・アーキテクチャー (JCA) 1.5 を介したデフォルト・メッセージング・プロバイダーとの通信を行う場合には、JMS アクティベーション・スペックを作成します。JCA は 、WebSphere® Application Server などのアプリケーション・サーバーとエンタープライズ情報システムの間の Java 接続を提供します。JCA は、JMS プロバイダーと Java EE アプリケーション・サーバーを統合するための標準化された方法や、メッセージの形式でデータが転送されるエンタープライズ・システムとのデータ交換用フレームワークを提供します。
「名前」 、「JNDI 名」、 「宛先 JNDI 名」、および「認証別名」以外のすべてのアクティベーション・スペック構成プロパティーは、関連付けられた EJB 2.1 以降のメッセージ駆動 Bean のデプロイメント記述子の、適切に命名されたアクティベーション・スペック・プロパティーによってオーバーライドされます。 EJB 2.0 メッセージ駆動型 Bean の場合、「宛先タイプ」、「サブスクリプション耐久性」、「確認モード」、および「メッセージ・セレクター」の各プロパティーは、デプロイメント記述子の対応するエレメントによってオーバーライドされます。どちらのタイプの Bean でも、「宛先 JNDI 名」プロパティーは、 メッセージ駆動型 Bean のバインディングに指定された値によってオーバーライドできます。
アクティベーション・スペックのプロパティーは、 デフォルト・メッセージング・プロバイダーがメッセージ駆動型 Bean アプリケーションの接続先のメッセージング・エンジンをどう選択するかに影響します。 デフォルトでは、環境が、バス上の使用可能なメッセージング・エンジンにアプリケーションを自動的に接続します。しかし、追加の構成詳細を指定して接続プロセスを制御することができます。例えば、特殊なブートストラップ・サーバーを指定する、使用可能なメッセージング・エンジンのサブグループに接続を限定する、 可用性やパフォーマンスを向上させる、あるいは、受け取ったメッセージが順次処理されるようにする、といったことが可能です。これを行う理由および方法については、JMS アプリケーションをバス上のメッセージング・エンジンに接続する方法 (オンライン)を参照してください。
(オンライン) でマークされたリンクでは、 インターネットへのアクセスが必要です。 それぞれのリンクは、オンラインのインフォメーション・センターでトピックの 検索を開始します。 検索結果がリストされたら、ご使用の構成に最適なトピックを選択してください。
このトピックに対する更新を確認 (オンライン)
「構成」タブには、このオブジェクトの構成プロパティーが表示されます。これらのプロパティー値は、ランタイム環境が停止されて再始動された場合にも保持されます。ランタイム環境に構成変更を適用する方法については、インフォメーション・センターのタスクの説明を参照してください。
Java Message Service (JMS) を基にして非同期メッセージングを使用可能にする、JMS プロバイダーを指定します。これは、J2EE 接続ファクトリーを提供して、特定の JMS キューまたはトピック宛先に対する接続を作成します。 JMS プロバイダーの JMS リソースの管理には、JMS プロバイダー管理オブジェクトが使用されます。
必須 | いいえ |
データ型 | テキスト |
リソースの JNDI 名。
必須 | はい |
データ型 | テキスト |
メッセージ駆動型 Bean がキューまたはトピックのどちらの宛先を使用するかを指定します。
必須 | はい |
データ型 | ドロップダウン・リスト |
範囲 |
|
宛先の JNDI 名。
「宛先タイプ」プロパティーで、宛先のタイプを選択します。
必須 | はい |
データ型 | テキスト |
メッセージ駆動型 Bean が受信するメッセージを決定するために使用する JMS メッセージ・セレクター。 値は、使用可能なメッセージのサブセットを選択するために使用されるストリングです。この構文は、JMS 仕様で説明されているように、SQL 92 条件式構文のサブセットに基づいています。 詳しくは、インフォメーション・センターを参照してください。
JMSType='car' AND color='blue' AND weight>2500
セレクター・ストリングは、JMS メッセージ・ヘッダー内のフィールド、およびメッセージ・プロパティー内のフィールドを参照できます。メッセージ・セレクターは、メッセージ本体の値を参照することはできません。
ヌル値 (空ストリング) は、メッセージ・コンシューマー用のメッセージ・セレクターがないことを示します。
必須 | いいえ |
データ型 | テキスト |
接続先のバスの名前。
必須 | いいえ |
データ型 | カスタム |
セッションが受信したメッセージに応答する方法。
肯定応答は、メッセージが削除されたときに送信されます。
サービスの品質がベスト・エフォート非パーシスタントに設定されている場合、Bean が開始するときにメッセージは削除されます。他のすべてのサービスの品質の場合、メッセージは Bean が完了するときに削除されます。
必須 | いいえ |
データ型 | ドロップダウン・リスト |
範囲 |
|
ターゲット・プロパティーに指定されたターゲットのタイプ。
必須 | いいえ |
データ型 | ドロップダウン・リスト |
範囲 |
|
このプロパティーは、ターゲット・グループの重要度を指定します。
必須 | いいえ |
データ型 | ドロップダウン・リスト |
範囲 |
|
アプリケーションと異なるプロセスにあるメッセージング・エンジンに接続する際に、アプリケーションが宛先とするインバウンド・トランスポート・チェーンの名前。 別のプロセスのメッセージング・エンジンが選択された場合は、メッセージング・エンジンが指定したインバウンド・トランスポート・チェーンを実行するサーバーにある場合にのみ接続が行われます。詳しくは、インフォメーション・センターを参照してください。
選択したメッセージング・エンジンがアプリケーションと同じサーバーにある場合は、直接プロセス内接続が実行され、このトランスポート・チェーン・プロパティーは無視されます。
必須 | いいえ |
データ型 | テキスト |
ブートストラップ・サーバーに接続する場合は、hostName:portNumber:chainName という構文を持つ、コンマで区切られたエンドポイント・トリプレットのリストが使用されます。例えば、Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging のようにします。
ホスト名が指定されない場合は、localhost がデフォルト値として使用されます。
ポート番号が指定されない場合は、7276 がデフォルト値として使用されます。
プロトコルが指定されない場合は、BootstrapBasicMessaging などの定義済みのチェーンがデフォルト値として使用されます。
必須 | いいえ |
データ型 | テキスト域 |
メッセージング・エンジンから単一バッチで受信するメッセージの最大数。
必須 | いいえ |
データ型 | 整数 |
範囲 | 1 から 2147483647 |
メッセージが同時に配信されるエンドポイントの最大数。
必須 | いいえ |
データ型 | 整数 |
範囲 | 1 から 2147483647 |
これらのパラメーターにより、連続して失敗したメッセージの数が指定した制限に達すると、エンドポイントを自動的に停止させることができます。 これは、メッセージ自身の問題により 1 個から 2 個のメッセージが失敗した場合と、システムのリソースの問題により複数のメッセージが連続して失敗した場合とを識別する上で役立ちます。
エンドポイントが自動的に停止された場合、管理コンソール・パネルでのその「Status (状況)」は赤です。「再開 (Resume)」をクリックして、手動で再始動する必要があります。
エンドポイントが再始動されると、そのエンドポイントが停止される原因となった失敗したメッセージはすべて再試行されます。メッセージがそれでも失敗する場合は、構成済みであれば、メッセージは例外宛先に移動されます。
連続的に障害のあるメッセージの数が構成済みの制限に達すると、エンドポイントが停止します。 MDB の並行性により、処理される実際のメッセージ数はこの値を超える可能性があります。
このプロパティーは、繰り返されるメッセージの障害時にエンドポイントを自動停止する プロパティーが有効である場合を除き、無効です。
必須 | いいえ |
データ型 | 整数 |
MDB による処理が失敗したが、その最大デリバリー障害数制限に達していないメッセージは、この時間が経過した後に限り再試行されます。 連続障害しきい値と最大並行性が 1 に設定されていなければ、他のメッセージはこの時間中に試行できます。
失敗を示すメッセージの再試行の間隔を遅らせるように設定すると、MDB が停止されるまでに不必要に例外宛先に移動されるメッセージの数が少なくなります。 移動されるメッセージの数を最小にするには、この遅延を、宛先に到着するメッセージ間の予想される時間間隔よりも大きくします。
このプロパティーは、繰り返されるメッセージの障害時にエンドポイントを自動停止する プロパティーが有効である場合を除き、無効です。
必須 | いいえ |
データ型 | 整数 |
範囲 | ミリ秒単位の時間。値 0 は、再試行間に遅延がないことを指示します。 |
JMS トピック・サブスクリプションが永続的か非永続的かを指定します。
必須 | いいえ |
データ型 | ドロップダウン・リスト |
範囲 |
|
永続トピック・サブスクリプションに必要なサブスクリプション名。 永続トピック・サブスクリプションを使用する場合は、必須フィールドです。
このサブスクリプション名は、所定のクライアント ID 内で固有のものである必要があります。
必須 | いいえ |
データ型 | テキスト |
このアクティベーション・スペックを使用して作成されたすべての接続における永続トピック・サブスクリプションに必要な JMS クライアント ID。
必須 | いいえ |
データ型 | テキスト |
この JMS アクティベーション・スペックから作成されたオブジェクトの永続サブスクリプションに配信されるメッセージを保管するために使用される、メッセージング・エンジンの名前。 これは、永続トピック・サブスクリプションを使用しているときには必要なフィールドです。
必須 | いいえ |
データ型 | テキスト |
有効にすると、このアクティベーション・スペックを使用して受信したオブジェクト・メッセージのメッセージ・データは、必要不可欠な場合のみ、システムによってシリアライズされます。 それらのメッセージから取得されるデータは、アプリケーションによって読み取り専用として扱われます。
必須 | いいえ |
データ型 | チェック・ボックス |
有効にすると、ペイロードが変更されたこのアクティベーション・スペックを介して転送されたオブジェクト・メッセージまたはバイト・メッセージのデータは、メッセージへの設定時にコピーされず、必要不可欠な場合のみ、システムによってメッセージ・データがシリアライズされます。 そのようなメッセージを送信するアプリケーションは、データがメッセージに設定された時点でそのデータを変更することはできません。
必須 | いいえ |
データ型 | チェック・ボックス |
先読みは、前もってメッセージをコンシューマーに割り当てる最適化です。 これにより、コンシューマー要求を満たすための時間が改善されます。
コンシューマーに割り当てられているメッセージは、サーバー上でロックされており、その宛先の他のコンシューマーは、それらのメッセージを使用することはできません。 コンシューマーに割り当てられているが、そのコンシューマーがクローズされるまで使用されなかったメッセージは、 クローズ後にサーバー上でアンロックされるため、他のコンシューマーがそれらを受信することができます。
JMS 宛先の「Read ahead」プロパティーを設定することにより、個々の JMS 宛先でこのプロパティーをオーバーライドすることができます。
必須 | いいえ |
データ型 | ドロップダウン・リスト |
範囲 |
|
このプロパティーが使用されるのは、ターゲット・バスのメンバーであるサーバーで MDB アプリケーションが実行されている場合のみです。 ターゲット・バスのメンバーではないサーバーで MDB が実行されている場合は、このプロパティーは使用されません。
ターゲット・バスのメンバーであるサーバーで MDB アプリケーションが実行されている場合、 そのサーバーが実行中のメッセージング・エンジンもホストしているかどうかに関係なく、このオプションを有効にすることで MDB アプリケーションはメッセージを処理できるようになります。 このオプションが有効ではない場合、ローカルで ME が実行されていないサーバー上の MDB アプリケーションはメッセージを処理しません。
詳しくは
、ク
ラスター内でのメッセージ駆動型 Bean の接続方法 (オンライン)を参照してください。
必須 | いいえ |
データ型 | チェック・ボックス |