AccountUpdateEventHandler

The AccountUpdateEventHandler handles the ParticipantAccountChange event.

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

This event handler issues a Messaging API message on the JMS send queue when the ParticipantAccountChange event occurs. If configured, a message is issued when an account is either opened or closed.

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.

The following table shows the additional event parameters for the account update event handler.
Table 1. AccountUpdateEventHandler parameters
Parameter name Trigger Type Value Description
accountStatus Yes String
  • open
  • closed
 The status of the account that has been updated. It is either open or closed.
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 the following table. The message type can be anything that is required by the target application.
Table 2. Message content for AccountUpdateEventHandler
Message part Value Description
Payload Partner Account instance The payload is an instance of the PartnerAccount class, which has information about the partner and the account. The information includes the partner ID, partner type, account number, account type, and bank code.

Response processing

The AccountUpdateEventHandler does not wait for a response to the account update messages.

Example handler XML

The example XML shows a closeAccount Messaging API message sent on the FXH.RISK.INPUT.QUEUE on localhost when a ParticipantAccountChange event occurs. The only purpose of this example is to show the structure of the XML for this event handler.
<EVENT>
   <NAME>Account Closed</NAME>
   <TYPE>ParticipantAccountChange</TYPE>
   <EXEC>
      com.ibm.paydir.ima.txsvr.event.appbridge.AccountUpdateEventHandler
   </EXEC>
   <PARAMETER name="msgType">closeAccount</PARAMETER>
   <PARAMETER name="accountStatus">closed</PARAMETER>
   <PARAMETER name="destinationID">Risk</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.RISK.INPUT.QUEUE</PARAMETER>
</EVENT>