Quickstart Examples - Event Listener
====================================

This is a simple BPEL engine event listener example, which will display
activity events generated by the ODE engine to the server console. This
can be used to write a custom event listener for logging and management
purposes.

NOTE: This example needs to be deployed when the server is not running.

To deploy the example, open a command line window in the example's folder,
and simply type 'ant deploy'. To undeploy, use the command 'ant undeploy'.

Once the example event listener has been deployed, you will need to manually
update the $AS/server/default/deploy/riftsaw.sar/bpel.properties file to
include the following:

bpel.event.listeners=org.jboss.riftsaw.event.RiftSawEventListener

At this point, you can now start the server and deploy/test any of the other
examples, to see the activity event information being displayed in the
server console log.

NOTE: To generate activity events for a particular BPEL process, you will
need to edit the process's deployment descriptor to indicate what level
of events should be generated. The following example is the 'hello_world'
quickstart modified to indicate that all events should be reported to
a registered listener:

	<process name="bpl:HelloWorld">
		<active>true</active>
		<process-events generate="all"/>

		<provide partnerLink="helloPartnerLink">
			<service name="intf:HelloService" port="HelloPort"/>
		</provide>
	</process>

To find out more about the different levels of filtering that are possible,
please see the ODE documentation: http://ode.apache.org/ode-execution-events.html

