TransmissionCreatedEventHandler

The TransmissionCreatedEventHandler handles the TransmissionCreated event.

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

This event handler issues a Messaging API message on the JMS send queue when a transmission that matches values specified in the event parameters is created. For example, specifying a value of Risk Engine for the clientApplicationName parameter causes the handler to put a message on the send queue when a transmission with that client application name is created. Transmissions created by other client application names are ignored.

Event parameters

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

Table 1 shows the additional event parameters for the transmission created event handler.
Table 1. TransmissionCreatedEventHandler parameters
Parameter name Trigger Type Value Description
clientApplicationName   String Risk Engine, for example The name of the client application that created this transmission. For additional options available with this parameter, see Specifying Value Modifiers and Special Values.
Note: The following list describes what the value in the trigger column means:
Yes
When the value in this column in the database changes to one of the values that are allowed by the event stanza, the handler places a message on the specified queue.
No
When the value in this column in the database changes, it does not cause a message to be placed on a queue. This parameter can be added to provide more criteria that must be met to send a Messaging API message.
N/A
The parameter is not considered when it is being determined whether a message is sent.

Message contents

When the message is delivered to the target application, it contains the information that is shown in Table 2.
Table 2. Message content for TransmissionCreatedEventHandler
Message part Value Description
Unit of Work Transmission ID as a long This value is used to locate the transmission in the database.
Payload The client application name and, optionally, the tracking ID of the expected event The name of the client application that created the transmission. If an expected event record was generated when the transmission was created, the client application name is followed by a comma and then the tracking ID of the expected event.
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

The example XML shows a transmissionCreated Messaging API message sent on the FXH.SERVICESFRAMEWORK.INPUT.QUEUE on localhost when the Risk engine creates a transmission with Risk Engine as the application name. The client application name is not case sensitive. 
<EVENT>
   <NAME>Post Transmission Created to Services Framework</NAME>
   <TYPE>TransmissionCreated</TYPE>
   <EXEC>
      com.ibm.paydir.ima.txsvr.event.appbridge.TransmissionCreatedEventHandler
   </EXEC>
   <PARAMETER name="msgType">transmissionCreated</PARAMETER>
   <PARAMETER name="clientApplicationName">^Risk Engine</PARAMETER>
   <PARAMETER name="sourceID">RISK-102</PARAMETER>
   <PARAMETER name="destinationID">SERVICES-FRAMEWORK</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>
</EVENT>