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