アクティベーション・スペック・プロパティー

アクティベーション・スペック・プロパティーは、メッセージ・エンドポイント用の Inbound イベント処理の構成情報を保持します。 アクティベーション・スペック・プロパティーは、エンタープライズ・サービス・ディスカバリー・ウィザード、WebSphere® Application Server 管理コンソール、または WebSphere Enterprise Service Bus 管理コンソールのいずれかを介して設定できます。

アダプターを構成する際は、以下の表にリストされている各アクティベーション・スペック・プロパティーを指定します。 2 番目の表では、双方向テキスト変換が使用されている場合にのみ構成する必要がある双方向アクティベーション・スペック・プロパティーについて説明しています。

表 1. Adapter for JDBC 用のアクティベーション・スペック・プロパティー
プロパティー 説明 グローバル化 デフォルト値
AssuredOnceDelivery Boolean プロパティーを true に設定すると、イベント・ストアの各イベントに xid 値が設定されます。さらに、各イベントが対応するエンドポイントに送達され、その後イベント・テーブルから 削除されます。 いいえ true
CustomDeleteQuery String 各イベントが処理された後に実行されるカスタム削除照会。これは双方向言語で使用される場合に使用可能化されます。 はい なし
CustomEventQuery String カスタム・イベント処理用の SQL 照会、ストアード・プロシージャー、またはストアード関数。 この照会は、EventQueryType が Dynamic に設定されている場合に、ポーリング周期中に毎回実行されます。これは双方向言語で使用される場合に使用可能化されます。 はい なし
CustomUpdateQuery String 同じイベントが次回のイベント周期で処理対象として取り出されないように、各イベントが処理された後に実行されるカスタム更新照会。 これは双方向言語で使用される場合に使用可能化されます。 はい なし
データベース URL String エンタープライズ情報システム (EIS) への接続を作成するためのドライバー固有の URL。これは双方向言語で使用される場合に使用可能化されます。 はい なし
DataSource
JNDIName
String データベースへの接続を確立するためにアダプターによって使用される名前。 ユーザー名およびパスワードも設定されている場合は、それらも接続の確立時に使用されます。ユーザー名もパスワードも設定されていない場合は、DataSourceJNDIName プロパティーのみが使用されます。 はい なし
送達タイプ String このプロパティーにより、イベントをパブリッシュする順序が決定されます。値は、ORDERED または UNORDERED のいずれかです。Ordered は、イベントが一度に 1 つずつパブリッシュされることを、unordered は、イベントが一度にすべてパブリッシュされることを意味します。 はい ORDERED
EventFilterType String アダプターは、処理するイベントをビジネス・オブジェクト・タイプでフィルターに掛けることができます。 EventFilterType には、コンマで区切られたビジネス・オブジェクト・タイプのリストが含まれ、このプロパティーで指定されたタイプのみが処理対象として取り出されます。プロパティーに値が指定されていない場合、 フィルターは適用されず、すべてのイベントが処理対象として取り出されます。 はい NULL
イベント順序 String イベントが取得および処理される順序。期待される値はイベント・テーブルのコンマで区切られた列名です。 このプロパティーは双方向言語の場合に使用可能。 いいえ なし
EventQueryType String 標準イベント・ストアまたはカスタム照会のいずれを使用するかを決定します。 有効な値は、標準イベント・ストア用の Standard とカスタム・イベント処理用の Dynamic です。 いいえ なし
イベント・テーブル名 String EIS が Inbound 処理のために生成するイベントを格納する EIS 内のテーブル。これは双方向言語で使用される場合に使用可能化されます。 はい なし
FilterFutureEvents Boolean このプロパティーが true に 設定されている場合、アダプターは、タイム・スタンプに基づいてイベントを フィルターに掛けます。アダプターは、各ポーリング周期のシステム時刻を 各イベントのタイム・スタンプと比較します。イベントが将来発生するように設定されている場合は、 その時刻になるまで処理対象として取り出されません。 いいえ false
JDBC ドライバー・クラス String EIS へ接続するために使用される JDBC ドライバー・クラス。 いいえ なし
パスワード String EIS からイベントを検索する際にユーザーを認可するためのパスワード。このプロパティーは双方向言語の場合に使用可能。 はい なし
ポーリング間隔 0 以上の整数 新規 Inbound イベントの EIS イベント・ストアをポーリングする間隔 (ミリ秒単位)。0 を指定すると、アダプターは周期の間待機することはありません。ポーリング周期は固定の間隔で設定されます。つまり、ポーリング周期の実行が遅延すると (例えば、前のポーリング周期の完了が予想よりも遅れた場合など)、遅れを取り戻すために次の周期がすぐに開始されます。このプロパティーは必須です。 はい 500
ポーリング数量 0 より大きい整数。 このプロパティーは、ポーリング周期ごとに各エンドポイントに配信するイベントの数を決定するのに使用されます。このプロパティーは必須です。 はい なし
RetryLimit Integer アダプターによる EIS への接続の再試行の回数。値 0 (ゼロ) を指定すると、アダプターは無限に試行を繰り返します。 いいえ 0
RetryInterval Integer この値が非負数のとき、アダプターで EIS へのインバウンド接続に関連するエラーが発生した場合、アダプターは、接続が再度確立されるまで、指定された間隔後に接続の再試行を繰り返します。値はミリ秒単位です。 いいえ 60000 (1 分)
SPAfterPoll String ポーリング周期の終了ごとに、実行する任意のストアード・プロシージャー。 これは、1 つの入力パラメーター (ポーリング数量) を取ります。これは双方向言語で使用される場合に使用可能化されます。 はい なし
SPBeforePoll String 実際のポーリング照会の呼び出しの前に実行する任意のストアード・プロシージャー。 これは、1 つの入力パラメーター (ポーリング数量) を取ります。これは双方向言語で使用される場合に使用可能化されます。 はい なし
StopPollingOnError Boolean true の場合、ポーリング中にエラーが発生すると、アダプターはポーリングを停止します。false の場合、エラーが発生すると、アダプターは例外をログに記録し、ポーリングを続行します。 いいえ false
ユーザー名 String Inbound イベントのため EIS にログインする際のユーザー名。これは双方向言語で使用される場合に使用可能化されます。 はい なし

Adapter for JDBC 用の双方向アクティベーション・スペック・プロパティー

プロパティー 説明
BiDi コンテキスト EIS String EIS への固有接続用アダプターによってサポートされるビジネス・オブジェクト・ランタイム・インスタンスすべてにあるコンテンツ・データの双方向形式を定義します。
BiDiContextMetadata String EIS への固有接続のメタデータまたは構成プロパティーの双方向形式を定義します。
BiDiContextSkip Boolean リソース・アダプター・レベルでの双方向言語サポートの呼び出しを制御するフラグ。true と等しければ、サポートは呼び出されません。false と等しければ、サポートは呼び出されます。
BiDiContextSpecialFormat String EIS への固有接続のコネクター・プロパティーすべての場合に、特殊な処理を受けるプロパティーのカテゴリーを指定します。
CustomDeleteQuery BiDi プロパティー   *CustomDeleteQueryEIS
CustomDeleteQuerySkip
CustomEventQuery BiDi プロパティー   *CustomEventQueryEIS
CustomEventQuerySkip
CustomUpdateQuery BiDi プロパティー   *CustomUpdateQueryEIS
CustomUpdateQuerySkip
データベース URL BiDi プロパティー   *DatabaseURLEIS、 DatabaseURLSpecialFormat (デフォルト値は JDBC_URL_SQL)、 DatabaseURLSkip
イベント・テーブル名 BiDi プロパティー  

*EventTableNameEIS、
EventTableNameSkip

EventOrderBy BiDi プロパティー   *EventOrderByEIS、EventOrderBySkip
パスワード BiDi プロパティー   *PasswordEIS、PasswordSkip
SPAfterPoll BiDi プロパティー   *SPAfterPollEIS、SPAfterPollSkip
SPBeforePoll BiDi プロパティー   *SPBeforePollEIS、SPBeforePollSkip
ユーザー名 BiDi プロパティー   *UserNameEIS、UserNameSkip
*BiDi サポートの各プロパティーに関連付けられた 3 つの双方向 (BiDi) プロパティー。これらのプロパティーは以下の表に記述されています。
BiDi プロパティー 説明

BiDiContextCP<property_
Name>EIS

String EIS への固有接続の固有コネクター構成プロパティーの双方向形式を定義します。

BiDiContectCP<property_
Name>SpecialFormat

String コネクター構成プロパティー・レベルで双方向言語サポートの呼び出しを制御するフラグ。true と等しければ、サポートは呼び出されません。false と等しければ、サポートは呼び出されます。

BiDiContextCP<property_
Name>Skip

Boolean EIS への固有接続の固有コネクター・プロパティーの特殊形式を定義します。
重要: CustomEventQuery、CustomUpdateQuery、および CustomDeleteQuery プロパティーのカスタム照会は、それらがストアード・プロシージャーまたはストアード関数の形式であれば、双方向変換用にサポートされます。しかし、標準 SQL の場合、SQL ステートメント内のストリング定数のみがサポートされます。
関連資料
リソース・アダプター・プロパティー
管理 (J2C) 接続ファクトリー・プロパティー

ご利用条件 |


(c) Copyright IBM Corporation 2005, 2006.
(C) Copyright IBM Japan 2006
このインフォメーション・センターでは Eclipse テクノロジー (http://www.eclipse.org) が採用されています。