dropFailedEvent()

This method removes a failed event from a collaboration's event queue. Use this when attempts to resubmit a failed event have been unsuccessful.

Syntax

void dropFailedEvent (String ownerName, String connectorname, int index)

Parameters

connectorName
The name of the connector to which the event belongs.
ownerName
The collaboration to which the event belongs.
index
The index of the failed event. Get this index using the queryFailedEvents method.

Examples

The following example obtains a vector of failed events and then drops them from the queue.

// Set up to query the failed events of a specific type for the collaboration.
EventQueryDef queryOption = new EventQueryDef();
// set query condition of busobj name
queryOption.nameBusObj = "TestBO";
// set query condition of connector name
queryOption.nameConnector = "SourceConnector";
// define query condition array
EventQueryDef[] queryOptions = new EventQueryDef[1];
queryOptions[0] = queryOption;
// query failed events with status of 
// STATUS_DELIVERY_POSSIBLE_DUPLICATE, no time limitation 
FailedEventInfo[]resultArray = queryFailedEvents(queryOptions, 
           "", "", FailedEventInfo.STATUS_DELIVERY_POSSIBLE_DUPLICATE);

// get the query result
for (int i = 0; i < resultArray.length; i++) {
 String busObjName = resultArray[i].nameBusObj;
 String nameConnector = resultArray[i].nameConnector;
 int wipIndex = resultArray[i].wipIndex;
// Drop the failed events with status STATUS_DELIVERY_POSSIBLE_DUPLICATE 
// from the queue.
 dropFailedEvent (busObjName, nameConnector, wipIndex);
 }

See also

See queryFailedEvents() for information about querying failed events.

Copyright IBM Corp. 2004, 2005