fetchEvents()

Retrieves a specified number of Ready-for-Poll events from the application's event store.

Syntax

public abstract void fetchEvents();
 

Parameters

None.

Return values

None.

Exceptions

StatusChangeFailedException
Thrown if the underlying application throws an exception while fetching the event from its event store.

Notes

The fetchEvents() method searches the event store for event records with the READY_FOR_POLL status and puts them in the even. The number of events that fetchEvents() retrieves is determined by the value of the PollQuantity connector configuration property. For each retrieved event, the method must create a CWConnectorEvent event object and put this event object into a Java Vector. The method then calls the setEventsToProcess() to save this event vector into the eventsToProcess vector, which is a member of the CWConnectorEventStore object. The fetchEvents() method determines the order in which event objects are stored in the eventsToProcess vector.

Important:
The fetchEvents() method is an abstract method. Therefore, the event-store class must implement this method to provide the ability to fetch READY_FOR_POLL events from the event store.
Note:
The fetchEvents() method is usually called from the poll method, pollForEvents().

See also

getNextEvent(),, pollForEvents(),, setEventsToProcess()

Copyright IBM Corp. 1997, 2004