TAFJ-E c l i p s e
Deb u g g i n g T24 JBC
Invo k e d via IRIS
R19
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
Amendment History:
Revisio
Date Amended Name Description
n
1 21st March 2017 J. Sheeraz Initial version
2 21st March 2017 H. Aubert Format
Sanofar Nisha
3 21st March 2019 R19 AMR Review
H
Page 2
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
Copyri g h t
Copyright (c) Temenos Headquarters SA 2009-2019.
All rights reserved.
This document contains proprietary information that is protected by copyright. No part of this document may
be reproduced, transmitted, or made available directly or indirectly to a third party without the express
written agreement of TEMENOS UK Limited. Receipt of this material directly TEMENOS UK Limited
constitutes its express permission to copy. Permission to use or copy this document expressly excludes
modifying it for any purpose, or using it to create a derivative therefrom.
Errat a and Com m e n t s
If you have any comments regarding this manual or wish to report any errors in the
documentation, please document them and send them to the address below:
Technology Department
Temenos Headquarters SA
2 Rue de l’Ecole-de-Chimie,
CH - 1205 Geneva,
Switzerland
Tel SB: +41 (0) 22 708 1150
Fax: +41 (0) 22 708 1160
Please include your name, company, address, and telephone and fax numbers, and email
address if applicable. TAFJdev@temenos.com
Page 3
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
Table of Contents
Copyright................................................................................................................................................ 3
Errata and Comments............................................................................................................................ 3
Debugging T24 JBC Invoked via IRIS.................................................................................................... 5
Configuration Steps for IRIS WAR........................................................................................ 5
Configuration Step for T24 & TAFJ....................................................................................... 7
Page 4
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
Deb u g g i n g T24 JBC Invok e d via IRIS
Following instructions are applicable if developer would like to debug their JBC code, which
is invoked by IRIS. This feature is not limited to debug UXP Browser but will work for any T24
service deployed using IRIS.
To enable debugging in T24, T24 Adapter for IRIS has been enhanced to communicate with
T24 via JMS queues.
Confi g u r a t i o n Ste p s for IRIS WAR
1. Place a new file called ‘connection.properties’ inside your *-iris.war/WEB-
INF/classes folder (if not available)
2. Set following property in file created in step 1;
invocationMethod=JMS
NOTE: Property and its value is case sensitive, so please take extra care
Page 5
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
3. Add following resource-ref in your WEB-INF/web.xml which will be used to lookup
queue connection factory and queue definition for request and response;
<resource-ref id="ResourceRef_jmsConnectionFactory">
<description>Used to get connections to JMS for Component
Queue</description>
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.ConnectionFactory</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24ComponentQueuee">
<description>OFS queue</description>
<res-ref-name>queue/t24ComponentQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
<resource-ref id="ResourceRef_t24ComponentReplyQueue">
<description>OFS reply queue</description>
<res-ref-name>queue/t24ComponentReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<res-auth>Container</res-auth>
</resource-ref>
4. Add following resource-ref in your WEB-INF/jboss-web.xml to map static queue
definitions to a JNDI name available in jBoss Application Server (though it would work
in all application servers);
<!-- JMS Configuration for Debugging -->
<resource-ref>
<res-ref-name>jms/jmsConnectionFactory</res-ref-name>
<res-type>javax.jms.ConnectionFactory</res-type>
<jndi-name>java:/ConnectionFactory</jndi-name>
</resource-ref>
<resource-ref>
<res-ref-name>queue/t24ComponentQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<jndi-name>java:/queue/t24OFSQueue</jndi-name>
</resource-ref>
<resource-ref>
<res-ref-name>queue/t24ComponentReplyQueue</res-ref-name>
<res-type>javax.jms.Queue</res-type>
<jndi-name>java:/queue/t24OFSReplyQueue</jndi-name>
</resource-ref>
NOTE: Above configuration is mapping request and response queues to
t24OFSQueue and t24OFSReplyQueue. You can choose any other queue
available for your configurations if required.
Page 6
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
5. Redeploy the WAR
At this stage all your communications from IRIS would be redirected to JMS queue.
Confi g u r a t i o n Ste p for T24 & TAFJ
In following configuration, we need to configure and run T24 server side JBC code which can
intercept the requests on above queue and call JBC API in T24.
1. Copy jars provided under TAFJ_HOME/3rdParty/jackson folder and place it under
TAFJ_HOME/ext directory
2. Start/Restart your TAFJ Eclipse IDE whose workspace is using above TAFJ as its home
so that it can add new libs into CLASSPATH
3. Add new JBC subroutine ‘COMPONENT.LISTEN’ provided under
TAFJ_HOME/appserver/basic/TAFJ.BP in your JBC workspace
4. Above subroutine will connect to your local jboss instance via its Remoting API to
intercept JMS messages.
5. Make sure you either stop or un-deploy TAFJJEE_EAR.ear so that above sub routine can
connect to the queues configured
6. Make sure to update JMS Queue names as per your configurations done in Step4 of
previous section.
7. Update the OFSSource variable in routine to suite your needs. Default is set to IRISPA
8. Setup a Break point in COMPONENT.LISTEN or any subroutine, which you want to
debug.
Page 7
TAFJ-E cli p s e Debu g gi n g T24 JBC
Invoke d via IRIS
9. Right click on COMPONENT.LISTEN and select Debug As BASIC Program. This
routine will connect to your local jBoss instance ready for consuming messages posted
by IRIS.
10. Make a request to IRIS URL.
Done!
Page 8
