Validating Common Base Events

With the REST event emitter, you can validate the XML content of events before emitting them to the server. By default, the event validation option is disabled. When event validation is enabled, an XML parser validates the content. If the XML is invalid, an error is logged to SystemOut.log and the event is discarded.

About this task

Validating events can help you debug errors in the event XML from the source application. However, validating events can adversely affect how the REST event emitter service performs if the XML or batch of events is large. Therefore, use event validation only as a debugging aid.

When you submit events in batch mode (content-type = application/atom+xml) to the REST event emitter, the event validation option and the XML header removal option do not apply. If you are submitting events in batch mode, ensure that the events do not contain an XML header. Otherwise, the events are not emitted and the entire batch is discarded.

Procedure

To enable event validation, use the WebSphere® Application Server administrative console and complete the following steps:

Select Applications > Application Types > WebSphere enterprise applications > IBM_WBM_EMITTER_SERVICES . Under Web Module Properties, click Environment entries for Web modules.
Change the value of REST Emitter Event Validation to true, and save your changes.
In the administrative console, restart the IBM_WBM_EMITTER_SERVICES application.