EntryLoadedEventHandler

The EntryLoadedEventHandler handles the EntryUowStateChange event that occurs when the state for the entry transitions to loaded.

EXEC specification: com.ibm.paydir.ima.txsvr.event.appbridge.EntryLoadedEventHandler

This event handler issues a Messaging API message on the JMS send queue when the EntryUowStateChange event occurs. The message issued to the target contains the ID of the entry that has been either created or changed. Because entry numbers are not unique, an entry ID is used to uniquely identify the entry number created. For example, an entry number of 1234 may be used multiple times and span different business days. The target application uses the entry ID to ensure it processes the correct entry number.

Event parameters

This event handler uses the general Messaging API event handler parameters. Event parameters are specified in the Scheduler.xml file.

There are no additional event parameters for this event.

Message contents

When the message is delivered to the target application, it contains the information that is shown in Table 1.

Table 1. Message content for EntryLoadedEventHandler
Message part	Value	Description
Unit of Work	Entry ID as a long	This value is used to locate the entry number that has been created or changed.
Payload	None	No additional payload data is provided within the message other than the unit of work information.

Note: The contents of this message must match what the receiver is expecting.

Response processing

Any response from the target application is ignored.

Example handler XML

This example shows how to initiate the Services Framework CIFFExtractTask task when an entry is loaded. The Services Framework sample task has more information about setting up a task to work with Transaction Server events.

The example XML shows a TaskInitiation Messaging API message sent to the FXH.SERVICESFRAMEWORK.INPUT.QUEUE on localhost.

<EVENT>
   <NAME>Entry Loaded Event</NAME>
   <TYPE>EntryUowStateChange</TYPE>
   <EXEC>
      com.ibm.paydir.ima.txsvr.event.appbridge.EntryLoadedEventHandler
   </EXEC>
   <PARAMETER name="msgType">TaskInitiation</PARAMETER>
   <PARAMETER name="destinationID">CIFFExtractTask</PARAMETER>
   <PARAMETER name="jmsQmgrHostname">localhost</PARAMETER>
   <PARAMETER name="jmsQmgrChannel">SYSTEM.DEF.SVRCONN</PARAMETER>
   <PARAMETER name="jmsQmgrPort">1414</PARAMETER>
   <PARAMETER name="jmsClient">true</PARAMETER>
   <PARAMETER name="jmsQmgrName">FTM.QMANAGER</PARAMETER>
   <PARAMETER name="jmsSendQueue">FXH.SERVICESFRAMEWORK.INPUT.QUEUE</PARAMETER>
   <PARAMETER name="jmsReplyQueue">FXH.TRANSSERVER.INPUT.QUEUE</PARAMETER>
</EVENT>