Enabling batch job events publishing

By using Java Messaging System (JMS), the batch server can publish job-related events to external clients.

1. Enable JMS support by adding the appropriate JMS feature to the feature manager in the server.xml file.
   If you are using the WebSphere® Application Server Liberty default messaging provider, add the wasJmsClient-2.0 feature and related JMS configurations for the message engine. If you are using WebSphere MQ Messaging provider, add the wmqJmsClient-2.0 feature. If you are using WebSphere MQ Messaging provider on z/OS in BINDINGS mode, add the zosTransaction-1.0 feature.
2. Add the batchJmsEvents element to the server.xml file.

   <batchJmsEvents connectionFactoryRef="batchConnectionFactory" />

   Note: If you do not specify the connectionFactoryRef attribute, the default value for connectionFactoryRef is batchConnectionFactory. You must still configure the batchConnectionFactory JMS connection factory in the server.xml file.
   1. To update the batch event topic root, add the topicRoot attribute to the batchJmsEvents element.

      <batchJmsEvents connectionFactoryRef="batchConnectionFactory" topicRoot="NEW_ROOT" />

      The topicRoot attribute value replaces the default root batch, so that batch/jobs/* becomes NEW_ROOT/jobs/*.

3. Add the corresponding JMS connection factory to the server configuration. This is not specific to batch configuration.
   The following example illustrates the batch events configuration and its JMS configuration by using the WebSphere MQ messaging provider.

   <!-- wmq resource adapter -->
   <variable name="wmqJmsClient.rar.location" value="${server.config.dir}/wmq.wlp.rar"/>
   <!-- required for BINDINGS mode -->
   <wmqJmsClient nativeLibraryPath="/mqm/jms/java/lib"/>
   
   <batchJmsEvents connectionFactoryRef="batchConnectionFactory" />
   
   <jmsConnectionFactory id="batchConnectionFactory">
     <properties.wmqJms
       transportType="BINDINGS"
       queueManager="WMQX" />
   </jmsConnectionFactory>

   The following example illustrates the batch events configuration and its JMS configuration by using the Liberty default messaging provider.

   
   <batchJmsEvents connectionFactoryRef="batchConnectionFactory" />
   <jmsConnectionFactory id="batchConnectionFactory">
     <properties.wasJms></properties.wasJms>
   </jmsConnectionFactory>