beautypg.com

IBM WebSphere Adapters User Manual

Page 90

background image

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