Professional Documents
Culture Documents
Customer Support
Portal
(/SitePages/Home.aspx)
This document is to con gure listeners in TOCF(EE) which can be deployed in websphere application server. Here we
(/SitePages/Home.aspx)
have taken sample as Batch le listener and mqseries listener.
(/SitePages/T24Intelligence.aspx)
Install T24 RA:
Resource Adapters
(/TCSPProfileCenter/infodefault.aspx)
à Install tocfT24ra-ra.rar using default values
(/Support/DashBoard.aspx)
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 1/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
In this case, we are going to create separate connection factories for separate message driven bean in order to
process the batch le listener and mq series listener requests separately. Create separate connection factories as
given below.
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 2/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
Resource adapters > T24RA > J2C connection factories > T24 JCA Connection Factory > Custom properties
Resource adapters > T24RA > J2C connection factories > T24 JCA Connection Factory > Connection pool properties
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 3/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
Note : Stop and Restart the Application Server in order to take e ect the changes.
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 5/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
In this case, we are going to create two di erent JMS request queues each one for accepting requests from BFL and
MQ and two di erent JMS response queues each one for accepting responses from OFS MDB. In order to access
these JMS queues, the JMS connection and queue connection factories should be created as given below.
à Create a new JMS connection factory using e.g. the 'Default Messaging Provider' for BFL.
- Bus: BrowserBus
à Create a new JMS connection factory using e.g. the 'Default Messaging Provider' for MQ.
- Bus: BrowserBus
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 6/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
à Create a new JMS Queue connection factory using e.g. the 'Default Messaging Provider' for BFL
- Bus: BrowserBus
à Create a new JMS Queue connection factory using e.g. the 'Default Messaging Provider' for MQ
- Bus: BrowserBus
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 7/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
à Create a new JMS request Queue for BFL using e.g. the 'Default Messaging Provider'
- Bus: BrowserBus
à Create a new JMS request Queue for MQ using e.g. the 'Default Messaging Provider'
- Bus: BrowserBus
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 8/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
à Create a new JMS response Queue for MQ using e.g. the 'Default Messaging Provider'
Yes
- NAME: T24 OFS Reply Queue BFL
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 9/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
- Bus: BrowserBus
à Create a new JMS response Queue for MQ using e.g. the 'Default Messaging Provider'
- Bus: BrowserBus
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 10/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
à Create a new Activation speci cation using e.g. the 'Default Messaging Provider' for BFL
Yes
- NAME: T24 OFS Message MDB BFL
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 11/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
- Bus: BrowserBus
à Create a new Activation speci cation using e.g. the 'Default Messaging Provider' for MQ
- Bus: BrowserBus
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 12/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 13/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
You can open tocfplugin-ra.rar resource adapter archive with winzip and view the tcserver.xml. The adapter must
be a "TOCF" adapter type. After setting up the tcserver.xml, just zip up the rar again and copy this le to the deploy
directory - in the next step toc istener-ejb.jar will activate this inbound resource adapter.
<TCSERVER>
<ADAPTERS>
<!-- Type TOCF will process requests using the message endpoint that activated the plugin e.g. TOCFListener-
ejb.jar -->
<ADAPTER id="T24.BFL" type="TOCF" active="true">
<!--
<REQUEST_FORMATTER>Thai2UTF, OFSML, UTF2Thai</REQUEST_FORMATTER>
<RESPONSE_FORMATTER>Thai2UTF, OFSML, UTF2Thai</RESPONSE_FORMATTER> -->
<MAX_SESSION> 5 </MAX_SESSION>
<MIN_SESSION> 1 </MIN_SESSION>
<TIMEOUT>30</TIMEOUT>
</ADAPTER>
<ADAPTER id="T24.MQ" type="TOCF" active="true">
<!--
<REQUEST_FORMATTER>Thai2UTF, OFSML, UTF2Thai</REQUEST_FORMATTER>
<RESPONSE_FORMATTER>Thai2UTF, OFSML, UTF2Thai</RESPONSE_FORMATTER> -->
<MAX_SESSION> 5 </MAX_SESSION>
<MIN_SESSION> 1 </MIN_SESSION>
<TIMEOUT>30</TIMEOUT>
</ADAPTER>
</ADAPTERS>
<MESSAGEFORMATTERS>
<!--================================================
Sample Formatters converting charsets
=================================================-->
</MESSAGEFORMATTERS>
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 14/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<LISTENERS>
<ADAPTERID>T24.MQ</ADAPTERID>
<MQHOST>127.0.0.1(1414)</MQHOST>
<MQMANAGER>NBFU</MQMANAGER>
<MQQUEUE>QIN</MQQUEUE>
<MQCHANNEL>NBFU.CH</MQCHANNEL>
<NBTHREADS>106</NBTHREADS>
<WAITINTERVAL>1000</WAITINTERVAL>
<CONSUMER>
<MQQUEUE>QOUT</MQQUEUE>
</CONSUMER>
</LISTENER>
</LISTENERS>
</TCSERVER>
This MDB is responsible for activating a TOCF "inbound" resource adapter and providing con guration to the
resource adapter. If you unzip this .jar you will see an "ejb-jar.xml" le that contains the following xml. The
important part is the activation con g – you are telling the tocfplugin-ra.rar which plugin you want to activate.
<message-driven id="MessageDriven_OFSListenerMDBBFL">
<display-name>OFSListener Bean</display-name>
Was this page
<ejb-name>OFSListenerMDBBFL</ejb-name>
<ejb-class>com.temenos.tocf.listener.mdb.TOCFListenerMDB</ejb-class>
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 15/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<messaging-type>com.temenos.tocf.common.jca.OFSMessageListener</messaging-type>
<transaction-type>Bean</transaction-type>
<activation-con g>
<activation-con g-property>
</activation-con g-property>
</activation-con g>
<resource-ref id="ResourceRef_OFSListenerMDB_jmsQueueConnectionFactoryBFL">
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.QueueConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_OFSListenerMDB_t24OFSQueueBFL">
<description>OFS queue</description>
<res-ref-name>queue/t24OFSQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_OFSListenerMDB_t24OFSReplyQueueBFL">
<res-ref-name>queue/t24OFSReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
</message-driven>
<message-driven id="MessageDriven_OFSListenerMDBMQ">
<display-name>OFSListener Bean</display-name>
<ejb-name>OFSListenerMDBMQ</ejb-name>
<ejb-class>com.temenos.tocf.listener.mdb.TOCFListenerMDB</ejb-class>
<messaging-type>com.temenos.tocf.common.jca.OFSMessageListener</messaging-type>
Was this page
<transaction-type>Bean</transaction-type>
<activation-con g>
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 16/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<activation-con g-property>
</activation-con g-property>
</activation-con g>
<resource-ref id="ResourceRef_OFSListenerMDB_jmsQueueConnectionFactoryMQ">
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.QueueConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_OFSListenerMDB_t24OFSQueueMQ">
<description>OFS queue</description>
<res-ref-name>queue/t24OFSQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_OFSListenerMDB_t24OFSReplyQueueMQ">
<res-ref-name>queue/t24OFSReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
</message-driven>
In addition to activating the TOCFPlugin this MDB is the message endpoint "TOCF" that you con gured in the
"tcserver.xml". OFS messages are received from the TOCF adapter and placed onto the OFS request queue. This
MDB then waits for OFS responses on the OFS response queue and hands them back to the "TOCF" adapter.
<ejbJar href="META-INF/ejb-jar.xml#EJBJar_TOCFListenerMDB"/>
<ejbBindings
xmi:type="com.ibm.ejs.models.base.bindings.ejbbnd:MessageDrivenBeanBinding"xmi:id="MessageDrivenBeanBindi
Was this page
ng_OFSListenerMDBBFL" activationSpecJndiName="jca/t24PluginsResourceAdapter">
<enterpriseBean xmi:type="org.eclipse.jst.j2ee.ejb:MessageDriven" href="META-INF/ejb-
jar.xml#MessageDriven_OFSListenerMDBBFL"/> Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 17/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_jmsQueueConnectionFactoryBFL"jndiName="jms/
t24QueueCxFactoryBFL">
<bindingResourceRef href="META-INF/ejb-
jar.xml#ResourceRef_OFSListenerMDB_jmsQueueConnectionFactory"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_t24OFSQueueBFL" jndiName="jms/t24OFSQueue
BFL">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_OFSListenerMDB_t24OFSQueue"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_t24OFSReplyQueueBFL"jndiName="jms/t24OFSRe
plyQueueBFL">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_OFSListenerMDB_t24OFSReplyQueue"/>
</resRefBindings>
</ejbBindings>
<ejbBindings
xmi:type="com.ibm.ejs.models.base.bindings.ejbbnd:MessageDrivenBeanBinding"xmi:id="MessageDrivenBeanBindi
ng_OFSListenerMDBMQ" activationSpecJndiName="jca/t24PluginsResourceAdapter">
<enterpriseBean xmi:type="org.eclipse.jst.j2ee.ejb:MessageDriven" href="META-INF/ejb-
jar.xml#MessageDriven_OFSListenerMDBMQ"/>
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_jmsQueueConnectionFactoryMQ"jndiName="jms/
t24QueueCxFactoryMQ">
<bindingResourceRef href="META-INF/ejb-
jar.xml#ResourceRef_OFSListenerMDB_jmsQueueConnectionFactory"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_t24OFSQueueMQ" jndiName="jms/t24OFSQueue
MQ">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_OFSListenerMDB_t24OFSQueue"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_OFSListenerMDB_t24OFSReplyQueueMQ"jndiName="jms/t24OFSRe
plyQueueMQ">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_OFSListenerMDB_t24OFSReplyQueue"/>
</resRefBindings>
</ejbBindings>
</com.ibm.ejs.models.base.bindings.ejbbnd:EJBJarBinding>
As de ned Message driven bean in ejb-jar.xml, the corresponding MDB's has to be de ned in the websphere
descriptor le ibm-ejb-jar-bnd.xmi.
Was this page
4) ejb-jar.xml (which is present inside the tocfee.ear\tocfOFSmessage-ejb.jar\META-INF)
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 18/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
This MDB is responsible for getting a requests from request queue and give to T24 via TOCF resource adapter.
<message-driven id="MessageDriven_OfsMessageMDBBFL">
<display-name>OFSMessage Bean</display-name>
<ejb-name>OFSMessageMDBBFL</ejb-name>
<ejb-class>com.temenos.tocf.ofsmessage.mdb.OFSMessageMDB</ejb-class>
<messaging-type>javax.jms.MessageListener</messaging-type>
<transaction-type>Bean</transaction-type>
<message-destination-type>javax.jms.Queue</message-destination-type>
<activation-con g>
<activation-con g-property>
</activation-con g-property>
</activation-con g>
<resource-ref id="ResourceRef_jmsQueueConnectionFactoryBFL">
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.QueueConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24ConnectionFactoryBFL">
<res-ref-name>eis/t24ConnectionFactory</res-ref-name>
<res-type>com.temenos.tocf.t24ra.T24ConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24OFSReplyQueueBFL">
<res-ref-name>queue/t24OFSReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
</resource-ref>
</message-driven> Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 19/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<message-driven id="MessageDriven_OfsMessageMDBMQ">
<display-name>OFSMessage Bean</display-name>
<ejb-name>OFSMessageMDBMQ</ejb-name>
<ejb-class>com.temenos.tocf.ofsmessage.mdb.OFSMessageMDB</ejb-class>
<messaging-type>javax.jms.MessageListener</messaging-type>
<transaction-type>Bean</transaction-type>
<message-destination-type>javax.jms.Queue</message-destination-type>
<activation-con g>
<activation-con g-property>
</activation-con g-property>
</activation-con g>
<resource-ref id="ResourceRef_jmsQueueConnectionFactoryMQ">
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.QueueConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24ConnectionFactoryMQ">
<res-ref-name>eis/t24ConnectionFactory</res-ref-name>
<res-type>com.temenos.tocf.t24ra.T24ConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24OFSReplyQueueMQ">
<res-ref-name>queue/t24OFSReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
</message-driven>
Was this page
5) ibm-ejb-jar-bnd.xmi (which is present inside the tocfee.ear\toc istener-ejb.jar\META-INF)
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 20/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
<ejbJar href="META-INF/ejb-jar.xml#EJBJar_OfsMessageMDB"/>
<ejbBindings xmi:type="com.ibm.ejs.models.base.bindings.ejbbnd:MessageDrivenBeanBinding"
xmi:id="MessageDrivenBeanBinding_OfsMessageMDBBFL" activationSpecJndiName="jms/t24OfsMessageMDBBFL">
<resRefBindings xmi:id="ResourceRefBinding_jmsQueueConnectionFactoryBFL"
jndiName="jms/t24QueueCxFactoryBFL">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_jmsQueueConnectionFactory"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_t24ConnectionFactoryBFL"
jndiName="jca/t24ConnectionFactoryBFL">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_t24ConnectionFactory"/>
</resRefBindings>
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_t24OFSReplyQueue"/>
</resRefBindings>
</ejbBindings>
<ejbBindings xmi:type="com.ibm.ejs.models.base.bindings.ejbbnd:MessageDrivenBeanBinding"
xmi:id="MessageDrivenBeanBinding_OfsMessageMDBMQ" activationSpecJndiName="jms/t24OfsMessageMDBMQ">
<resRefBindings xmi:id="ResourceRefBinding_jmsQueueConnectionFactoryMQ"
jndiName="jms/t24QueueCxFactoryMQ">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_jmsQueueConnectionFactory"/>
</resRefBindings>
<resRefBindings xmi:id="ResourceRefBinding_t24ConnectionFactoryMQ"
jndiName="jca/t24ConnectionFactoryMQ">
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_t24ConnectionFactory"/>
</resRefBindings>
<bindingResourceRef href="META-INF/ejb-jar.xml#ResourceRef_t24OFSReplyQueue"/>
</resRefBindings>
Was this page
</ejbBindings>
</com.ibm.ejs.models.base.bindings.ejbbnd:EJBJarBinding>
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 21/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
As de ned Message driven bean in ejb-jar.xml, the corresponding MDB's has to be de ned in the websphere
descriptor le ibm-ejb-jar-bnd.xmi.
Enterprise Applications
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 22/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
Enterprise Applications > TOCF(EE)_EAR > Manage Modules > TOCFPLUGIN > Resource Adapter > J2C Activation
speci cations > com.temenos.tocf.common.jca.OFSMessageListener
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 23/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
à Start TOCF(EE)_EAR
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 24/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
Resource adapters > T24RA > J2C connection factories > T24 JCA Connection Factory BFL > Custom properties
Put the SWIFT messages in the directory which you have speci ed in <DIR_IN> batch lelistener and the messages
will be processed via batch lelistener.
For example, we created a text le called r1_swift.txt which contains the actual SWIFT message and put it in the
<DIR_IN> directory.
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 25/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
The message has been processed and record has been created in SWIFT.IN.LIST.
Start the jbase_agent with port number(20003) on the host(127.0.0.1) speci ed in the custom properties of T24 JCA
connection factory.
Resource adapters > T24RA > J2C connection factories > T24 JCA Connection Factory MQ > Custom properties
Put any sample messages in the directory which you have speci ed in MQ input queue and the messages will be
processed via mqseries listener.
For example, we have a sample enquiry message and put it in queue INQ and you can get the output in OUTQ.
Yes
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 26/27
3/19/2018 How to configure listeners in websphere using TOCF(EE)
https://tcsp.temenos.com/HowTo/ConfLstnWebSph.aspx 27/27