データ・ストアからのイベントの削除

イベント・コンシューマーまたは管理ツールを使用すると、イベント・アクセス・インターフェースを使用してデータ・ストアからイベントを削除できます。

このタスクを実行する理由と時期

データ・ストアからすべてのイベントを削除するか、 またはイベント・グループかイベント・セレクター (あるいはその両方) のみを削除することができます。

注: WebSphere セキュリティーが使用可能に設定されている場合、アプリケーション・ユーザーID を eventAdministrator ロールにマップして、イベントを削除する必要があります。

このタスクのステップ

データ・ストアからイベントを削除するには、イベント・アクセス Bean の purgeEvents() メソッドを使用します。
int purged = eventAccess.purgeEvents(eventGroup,
                                     eventSelector,
                                     transactionSize);
パラメーターは、以下のとおりです。
eventGroup
削除するイベントを含むイベント・グループの名前を含むストリング。これは、イベント・インフラストラクチャー構成で定義されている 既存のイベント・グループの名前である必要があります。イベント・グループを指定しない場合は、このパラメーターをヌルにします。
eventSelector
削除するイベントを識別するオプションのイベント・セレクターを含むストリング。イベント・セレクターは、XPath 式の形式で指定されています (詳しくは、イベント・セレクターの書き込みを参照してください)。 イベント・セレクターを指定しない場合は、このパラメーターをヌルにします。
transactionSize
単一データベース・トランザクションで削除するイベントの数を指定するゼロ以外の整数。ほとんどの場合、EventAccess インターフェースで定義される定数 DEFAULT_PURGE_TRANSACTION_SIZE を使用できます。

結果

purgeEvents() メソッドは、指定したすべての基準と一致するすべてのイベントを削除します。eventGroup および eventSelector パラメーターの両方がヌルの場合は、データ・ストア内のすべてのイベントが削除されます。削除操作が開始された後に着信するイベントは、パージされません。戻される値は、削除されたイベントの数を示す整数です。

注: transactionSize パラメーターの値がデータ・ストア・プロファイルで定義されている最大パージ・トランザクション・サイズを超過する場合は、PurgeThresholdExceededException 例外がスローされ、イベントは削除されません。デフォルトの最大パージ・トランザクション・サイズは 100 000 です。

ご利用条件 |


(c) Copyright IBM Corporation 2005, 2006.
本製品では Eclipse テクノロジーが採用されています。(http://www.eclipse.org)