IBM WebSphere Adapters Network Card User Manual


 
Status
The event status is used to track the state of an event. It allows the Foundation
Classes to distinguish among events that are new from those in process or
ineligible.
The adapter must support five different event status values as described in the
table below. All events generated by the event detection mechanism in the EIS
should be in the initial state of New. Only the Foundation Classes, through the
EventStore.updateEventStatus method, change event status.
Possible Event Statuses
Event Status Description Foundation Class Constant
New The event is ready to be
processed.
NEWEVENT
In Progress The adapter is processing
this event. Note that an
event in this state may or
may not yet be delivered.
INPROGRESS
Processed The adapter successfully
processed and delivered the
event.
PROCESSED
Failed The adapter was unable to
process this event due to one
or more problems.
FAILED
Unsubscribed The adapter processed the
event but found no
interested subscribers
UNSUBSCRIBED
XID
The XAResource uses this string field to track transaction IDs in the event table.
The adapter queries and updates that XID field. During recovery, WebSphere
Application Server calls the resource adapter, queries it for XAResources, and then
performs transaction recovery based on the XID.
Event object:
An event object is an instance of the
com.ibm.j2ca.extensions.eventmanagement.Event class as defined in the Foundation
Classes. An event object is the common representation of an event in the Adapter
Foundation Classes and it is populated from an event record in the
getSpecificEvent(String eventId) method described in the Implementing the
EventStore Interface section.
Event object fields
Field Description
eventID Corresponds to the Event Identifier field of
the event record
eventKeys Corresponds to the Object Key field of the
event record
84 WebSphere Adapters: WebSphere Adapter Toolkit User Guide