The event handler gets the Java™ Message Service (JMS) message from the JMS queue, extracts the Common Base Event (CBE) formatted event, and calls the IBM® Case Foundation API to start the workflow based on the event data that is contained in the CBE formatted event.
The administrator starts the event handler at the same time as the event monitor. The event handler connects to the IBM Case Foundation server. After the event handler is started, it retrieves the initial context factory, the provider URL, the queue connection factory, and the queue name from the cmbemconfig.properties file that are used for Java Naming and Directory Interface (JNDI) lookup for connecting to the JMS queue, such as ICMMSGOQ.
The event handler also retrieves the RETRY_COUNT value from the cmbemconfig.properties file. RETRY_COUNT denotes the number of attempts it will make to start the workflow.
When the event monitor adds the JMS message to the JMS queue, the event handler retrieves the JMS message from that queue and parses the JMS message to retrieve the workflow information from the message.
The event handler log file is the icmhandler.log file. You can set the options for logging by modifying the cmbemconfig.properties file. You can also change the default path of the icmhandler.log file in the cmbemconfig.properties file.
