Removing XML headers

When you use the REST event emitter, you can enable or disable XML header removal from the event XML. By default, the XML header removal option is enabled because the event emitters cannot process event XML with XML headers. The Common Base Event envelope that is used to wrap the event has an XML header already. If events that contain an XML header are emitted and XML header removal is disabled, the events are not processed and are discarded.

About this task

When the XML header removal option is enabled, the XML headers are removed automatically.

For the REST event emitter only, you can disable XML header removal. However, if events that contain an XML header are emitted and XML header removal is disabled, the events are not processed and are discarded.

Tip: If XML header removal is disabled and your XML has a header, you might see the following message:
CWMDS6803E: The following error occurred while processing the REST request:
CEIEM0025E: The emitter failed to send the events to the event server. The local event bus enterprise bean on the event server failed during event processing.
Validate your XML and remove XML headers.

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 configure the XML header removal option, use the WebSphere® Application Server administrative console and complete the following steps:

  1. Select Applications > Application Types > WebSphere enterprise applications > IBM_WBM_EMITTER_SERVICES. Under Web Module Properties, click Environment entries for Web modules.
  2. Change the value of REST Emitter XML Header Removal to false, and save your changes.
  3. In the administrative console, restart the IBM_WBM_EMITTER_SERVICES application.