Doc u m e n t Hist o r y

Revi si o
Dat e Ame n d e d Na m e De s c r i p t i o n
n
1 1 st April 2011 TAFJ tea m Initial version
7 st Febr u a r y
2 H. Aube r t R12GA review
2012

16 th Janua r y Manoj
3 R13GA review
2013 Kuma r

4 15 th April 2014 H. Aube r t R14GA review

5 6 th May 2014 JN. Char pi n Logge r cont ext

6 10 th Marc h 2015 H. Aube r t R15 AMR review

7 15 th Marc h 2016 M.Kum a r R16 AMR review

8 13 th May 2016 JN Char pi n SLF4J bindin g

9 17 th June 2016 JN Char pi n Log4j2 bindin g

10 3 rd August 2016 JN Char pi n eclipse link

4 th Sept e m b e r
11 JN Char pi n COMO logge r
2017

14 th Dece m b e r
12 JN Char pi n Prope r t i e s in DB
2017

13 20 th Dece m b e r JN Char pi n Multi- configu r a t io n suppo r t

29 th Dece m b e r
14 Riswa n a Com mit Capt u r e configu r a t io n.
2017

Vinod
15 13 th April 2018 Shun m u g a v e Log redir e c t to Splunk
l

16 22 nd Marc h 2018 R. Vincen t R19 AMR Review

17 24 th Mar 2020 M. Kuma r R20 AMR Review

18 12 th April 2021 Imm a n u e l KJ R21 AMR Review

Pree t hi
19 25 th Marc h 2022 R22 AMR Review
Evang eli n

20 6 th April 2023 M.Kum a r R23 AMR Review

21 16 th May 2023 S. Sakt hi JDK11 Updat e

2
TAFJ S e t u p

Copyri g h t

Copyrig h t © Teme n o s Hea d q u a r t e r s SA 2009- 2023.

All right s rese rv e d.
This docu m e n t cont ain s prop rie t a r y inform a tio n that is prote c t e d by copyrig h t. No part of this docu m e n t may
be repro d u c e d , tra ns m i t t e d , or mad e availa ble direc tly or indirec tly to a third party without the expr e s s
writt e n agre e m e n t of TEMENOS UK Limite d. Receipt of this mate ri al direc tly TEMENO S UK Limite d
constit u t e s its expr e s s per mis sion to copy. Per mis sion to use or copy this docu m e n t expr e s sly exclud e s
modifying it for any purpo s e , or using it to cre a t e a derivative the r ef ro m .

Errat a and Com m e n t s

If you have any com m e n t s reg a r di n g this man u al or wish to repor t any error s in the docu m e n t a t i o n ,
plea s e docu m e n t the m and send the m to the add r e s s below:
Technology Depa r t m e n t
Teme no s Hea d q u a r t e r s SA
2 Rue de l’Ecole- de- Chimie,
CH - 1205 Geneva,
Switze rl a n d

Tel SB: +4 1 (0) 22 708 1150

Fax: +4 1 (0) 22 708 1160

Pleas e includ e your na m e , comp a n y, addr e s s, and telep h o n e and fax num b e r s , and email add r e s s if
applica bl e. TAFJdev@t e m e n o s . c o m

3 Teme no s Application Fra m e w o r k Java – (TAFJ)

 Ta b l e o f C o n t e n t s

What is TAFJ

TAFJ (Tem e n o s Applicatio n Fra m e w o r k Java) is a Pick BASIC runti m e and com pile r, writt e n in 100% java.
It allows compiling and runni n g Pick BASIC progr a m s . TAFJ has bee n writt e n specifically for T24 nee d s,
and all tests and proof of conce p t s have bee n done using T24. TAFJ also man a g e the conn e c tivity on
JDBC com plia n t dat a b a s e s like jBASE, Oracl e, Microsoft SQL Serve r, DB2, derby, der by (Emb e d d e d ). It
com e s with an emb e d d e d expor ti n g tool for migr a t e your Pick dat a to Oracle.

Overvi e w

4
TAFJ S e t u p

Inst a l l gui d e
Prer e q u i s i t e s
Java JDK

To install TAFJ, the only pre r e q ui sit e is having a Java Develop m e n t Kit (JDK) version 11.x inst alled. To
check what version of java you have, type in a consol e:

If the version repo r t e d is not 11.x, you shoul d install it. Java JDK can be downlo a d e d her e:
http://ww w.o r a cl e. c o m / t e c h n e t w o r k /j av a/j av a s e / d o w nl o a d s/i n d e x. h t m l

NOTE: If you have installe d java 11 but the com m a n d java -version doesn' t repor t the corr e c t version,
this is cert ai nly beca u s e your PATH environ m e n t variabl e points to anot h e r version. This is a bad
prac ti c e to have your java virtual mac hi n e (VM) in the PATH. We highly reco m m e n d rem ovin g it. The
best prac tic e is to set- up an environ m e n t variabl e called JAVA_HOME pointin g to the root direct o ry of
your Java Develop m e n t Kit (JDK) inst allation. Then, you could refe r e n c e JAVA_HOME/bi n in your PATH
environ m e n t variabl e.

5 Teme no s Application Fra m e w o r k Java – (TAFJ)

The differ e n t script s in <TAFJ_HO M E > / b i n will REQUIRE the environ m e n t variabl e JAVA_HO M E .
On Unix/Linux/ :

Or upda t e your file: .pr of i l e

On Window s:
STA R T Me n u -> Se t t i n g s -> Con t r o l Pan e l -> Sys t e m -> Adv a n c e d -> Envi r o n m e n t Vari a b l e s
You cou l d us e Sys t e m vari a b l e s (Pr e f e r r e d ) OR Use r vari a b l e s to se t th e JAVA_HO M E .

Se t u p TAFJ

The inst allation com e s as a single .tar file. On Unix/Linux, run the “ tar -xf <fil e n a m e > ” com m a n d . On
Windows, you can use 7zip ® to extr a c t the zip Cont e n t s .

Then run the script .sh on UNIX or .ba t on Windows oper a ti n g syst e m .
Not e : That the JAVA_HOME environ m e n t variabl e must be set befor e runni n g the script s.

The following section will show a typical inst all proce d u r e on a UNIX platfor m . The proce d u r e will be
exactly the sam e on Windows ® . The user input is in [bl u e ] . If you have value s in brac k e t s, thes e are the
default values (typing <E NTE R > is acce p t i n g the defa ul t).

Not e : If you do not have the T24 sourc e s you will nee d to give any existin g direc t o r y in orde r to continu e
the setu p. The inser t direct o ry is option al.

6
TAFJ S e t u p
A St e p by Ste p TAFJ Inst a l l a t i o n

On UNIX:

On Window s:

Explori n g th e Set u p res u l t

The pat h whe r e you inst all ed TAFJ will be refe r e n c e d as <TAFJ_HO ME >
In the inst a l l Dire c t o r y
<TAFJ_HOME>/
3rdParty/ The directory contains specific 3rd party Libraries. These libraries are not loaded by default in the
Classpath of TAFJ. Refer to the documentation when and where you have to deploy these libraries

appserver/ The directory contains the different application server configuration like jboss, Websphere application
server etc.
bin/ The directo ry contain s the differe n t execu t a b l e scripts (tRun, tCom pile, ...).
CodeCoverageReceiver/ The directo ry contain s the cober t u r a jars.
conf/ The configu r a tio n directo ry.
data/ This direc to ry contains classe s and java folder. classe s folder holds the all the compiled
class files (.class) and java folder holds .java files
dbdrivers/ The directo ry contain s the drivers need e d to differe n t data b a s e comm u ni c a tio n.
dbscripts/ The directo ry contain s all the data b a s e script s.
doc/ The directo ry contain s all the docu m e n t a t io n.
eclipse/plugins/ The directo ry contain s all the plugins to enable the TAFJ persp e c tiv e in eclipse IDE.
ext/ The directo ry contain s java exten sio n (see specific chapt e r).
JarSign e r / The directo ry contain s the stan d alo n e tools to sign and verify a jars
Javadoc/ The directo ry contain s the JavaDoc of TAFJClinetAPI
JbcSonarPlugin/ The directo ry contain s the JBC plugins for Sona rQ u b e
JMSInject o r/ This direc to ry contains the stan d alo n e tools JMSInjec to r.
lib/ The directo ry contain s the TAFJ libra rie s
maven/ The directo ry contain s the TAFJ plugins for mave n
Messa g e I n t e g r i ty/ This direc to ry contains the stan d alo n e tools and jars for Mess a g e I n t e g r i ty.
PROC/ Empty folder need e d for back comp a ti bility
Regression/ Contain s some scripts perfor m regr e s sio n tests.
RulesEn gi n e/ The directo ry contain s some Rules Engine jars to be used by T24 runtim e.
samples/basic/ The directo ry contain s some BASIC Code sample s.

7 Teme no s Application Fra m e w o r k Java – (TAFJ)

 T24Email/ The directo ry contain s some T24 Email jars to be used by T24 runti m e .
T24Sms/ The directo ry contain s some T24 Sms jars to be used by T24 runti m e .
Tafc_components
TAFJSessionMonitor/ The directo ry contain s some TAFJ MV42 Monitor tar.gz file.

In the Data directory

<TAFJ_HOME>/data/
/tafj/ The default project directo ry
/tafj/ classes/ The default direc to ry wher e the compiled BASIC goes (like globuslib).
/tafj/java/ The default direc to ry cont ainin g the BASIC conver t e d in java.
/tafj/jars/ The default directory containing jar files produced during compilation when generate jar option is made true in
properties file.

8
TAFJ S e t u p
Set u p Eclip s e Plu g - ins

Once the setu p of TAFJ is compl e t e d and if you have eclipse jdk11 com p a ti bl e version installe d, you can
simply link the conte n t s of the direct o ry <TAFJ_HO M E > / e c l i p s e / p l u g i n s in your direc t o r y
<ECLIP S E_H O M E > / d r o p i n s .
1. Crea t e a file tafj.li n k in <E CLIP S E_ H O M E > / d r o p i n s .

2. Edit the file tafj.li n k and add a prop e r t y key : pa t h = < r e l a t i v e _ p a t h _ t o _TAFJ_HO M E >

3. Set the pat h with the relative pat h from <ECLIP S E_H O M E > to <TAFJ_HO M E >

i.e
For the direc to ry str uc t u r e :

+---3rdParty
| +---eclipse
+---TAFJ

path = ../../TAFJ
Depe n di n g on the TAFJ version you are using you could gene r a t e this tafj.link auto m a t i c a lly
whe n run ni n g TAFJ Set u p and providing your ECLIPSE_HOME pat h. When using am
auto m a t e d set u p (no prom p t ), tafj.link will be gen e r a t e d unde r TAFJ_HOME/co nf.
Once done, in orde r to verify that all TAFJ Plug- ins are loade d with eclipse, you can go in the Eclipse
men u :
Hel p -> Abo u t Ecli p s e SD K , pres s on “Ins t a l l a t i o n De t a i l s ”, and Tab: “Plu g - ins”

Se t u p proje c t .

A projec t is a specific settin g of prope r ti e s. All prop e r t i e s of a project are in file prop e r t i e s in
<TAFJ_HO M E > \ c o n f . the na m e of the projec t is given by the na m e of the prop e r t i e s file.
To Cre at e a new project base on a prope r t i e s file, copy the file <TAFJ_HO M E > \ c o n f \ . p r o p e r t i e s and
ren a m e d it with the nam e of your projec t.
i.e
9 Teme no s Application Fra m e w o r k Java – (TAFJ)
 T24.pro p e r t i e s
MYPROJECT.pro p e r t i e s
All script s in <TAFJ_HO M E > \ b i n nee d a projec t (prop e r t i e s) to work. To specify the projec t to use with
a script, pass the arg u m e n t : -cf Proj e c t N a m e
i.e
tRun –cf T24.properties EX

You can omit the -cf arg u m e n t to use the defa ult project. The defa ult project is specified in the file
<TAFJ_HO M E > \ c o n f \ . d e f a u l t . After a setu p of TAFJ the defaul t project in tafj. p r o p e r t i e s .
By conve n tio n s, the java and class pat h for TAFJ of a projec t have to be set unde r:
<TAFJ_HO M E > / d a t a / < P r o j e c t N a m e > / j a v a an d cla s s e s
i.e
for myProj ec t. p r o p e r t i e s :
# Specify where the java files will be generated
# by the compiler
#
temn.tafj.directory.java = <tafj.home>\data/myProject/java

# Specify where the classes files will be generated

# by the compiler
#
temn.tafj.directory.classes = <tafj.home>\data/myProject/classes

10
TAFJ S e t u p

How it work s with prop e r t i e s file and .def a u l t

When you star t a script in <TAFJ_HO M E > \ b i n the mec h a ni s m is:

11 Teme n o s Application Fra m e w o r k Java – (TAFJ)

Log g i n g
See TAFJ-Logging.p df.

Prop e r t i e s
File con f i g u r a t i o n
TAFJ does n’t use environ m e n t variabl e s but prope r t i e s for its inter n al configu r a t i o n.
Prop e r t i e s can be eit h e r stor e d in a prop e r t i e s file or at data b a s e leve l for appli c a t i o n serv e r
de pl o y m e n t s .
.pro p e r t i e s is the file exten si on to store configu r a t i o n and prop e r t i e s on disk.
File base d prop e r t i e s are store d unde r $TAFJ_HOME/co nf direct o r y.
The file nam e will identify a specific configu r a t i o n or projec t.
e.g.
- produ c tio n- syste m . p r o p e r t i e s
- l3- dev.pro p e r t i e s
To ma k e us e of a sp e c i f i c prop e r t i e s fil e in an appli c a t i o n serv e r envir o n m e n t , se t th e foll o w i n g
syst e m prop e r t y at JVM start u p .
-Dtafj.pr o p e r t i e s = p r o d u c t i o n - syst e m
Or
-Dtafj.p r o p e r t i e s = p r o d u c t i o n - syst e m . p r o p e r t i e s
The file must exist und e r $TAFJ_HOME/ co nf direct o ry.

Dat a b a s e co n f i g u r a t i o n
When using the data b a s e to store prop e r t i e s, the main T24 dat a sourc e is use d and must be available for
the configu r a t i o n servic e to work.
The configu r a t io n service is auto m a ti c ally crea ti n g the configu r a ti o n tabl e ‘TAFJ_CONFIGURATION’, if it
doesn’t alre a dy exists.
Then this table is used to stor e configu r a t i o n s, a configu r a t i o n being identified by a uniqu e configu r a t i o n
id.
e.g.
- produ c tio n- syste m
- l3- dev
To ma k e us e of a data b a s e bas e d co n fi g u r a t i o n ins t e a d of a prop e r t i e s file in an appli c a t i o n
serv e r envir o n m e n t , set th e foll o w i n g sys t e m prop e r t y at JVM start u p .
-Dtafj.c o n f i g u r a t i o n = p r o d u c t i o n - syst e m
The configu r a t io n “produ c ti o n- syste m ” will be crea t e d auto m a ti c ally with default value s if it does n’t exist
in the configu r a t i o n table (no ent rie s for configu r a t i o n_id =’ produ c tio n- syste m’).
The ‘TAFJ_CONFIGURATION’ table struc t u r e is the following:
- CONFIGURATION_ID: the configu r a t i o n identified

- PROPERTY_KEY: the prope r t y key

- PROPERTY_VALUE: the prop e r t y value

12
TAFJ S e t u p
- LAST_MODIFIED: the time st a m p whe n the prope r t i e s has bee n lastly modified

- USER_NAME: the use r na m e respo n si bl e for the modifica tion (default value s are cre a t e d by user
‘syste m’).

Prop e r t i e s
Be it file or dat a b a s e configu r a t io n, eac h par a m e t e r is stor e d as a pair of strin gs , one storin g the nam e of
the para m e t e r (called the key ), and the othe r storin g the value.
All prop e r t i e s are loade d as a Java Syst e m Prope r ti e s.
All Prope r ti e s can be overloa d e d with -D< k e y > = < v a l u e > set to the JVM (Java Virtual Machi n e).
A value can cont ai n:
A strin g as a value
i.e.
tafj.home = \Temenos\T24Enterprise\TAFJ

A strin g includi n g keys betw e e n ‘<’ ’>’, the substit u t io n will be done at runti m e with the
corr e s p o n d i n g key value.
i.e.
tafj.home = \Temenos\T24Enterprise\TAFJ
temn.tafj.runtime.directory.current = <tafj.home>/UD

A String with an Environ m e n t variable ‘<’ ’>’, the substit u ti o n will be done at runti m e with
the corr e s p o n di n g environ m e n t variabl e value.

tafj.home = <%TAFJ_HOME%>
temn.tafj.runtime.directory.current = <$TAFJ_HOME>/UD

In case of prope r t i e s file stora g e , prope r t i e s nee d s to be edite d manu a lly with a text editor.
In case of dat a b a s e stor a g e , an admi ni st r a t i o n consol e and a REST API are availa bl e to cha n g e
prop e r t i e s.
- /TAFJConfigu r a ti o n/ d a s h b o a r d .x h t m l : GUI admin console acce ss to curr e n t runti m e configu r a t i o n
define d throu g h -Dtafj.configu r a t i o n.

- /TAFJConfigu r a ti o n/ r e s o u r c e s / p r o p e r t i e s : REST base URL to curr e n t runti m e configu r a t i o n

define d throu g h -Dtafj.configu r a t i o n.

- /TAFJConfigu r a ti o n/ r e s o u r c e s / c o nfi g u r a t i o n: REST base URL to any configu r a t i o n define d in the

configu r a t io n table.

Refer to TAFJ AS docu m e n t a t i o n for mor e det ails.

This is imp or t a n t to not e that th e appli c a t i o n mu s t be rest a r t e d wh e n cha n g i n g a prop e r t y
valu e .

13 Teme n o s Application Fra m e w o r k Java – (TAFJ)

Confi g u r a t i o n overri d e – mu l t i- co nf i g u r a t i o n

In develop m e n t or test s environ m e n t s multiple configu r a t i o n s of sa m e type can be loade d by the

syst e m . This mode could be useful to define a “base” configu r a t i o n which could be overri d d e n in a
“specific” configu r a t i o n s for som e para m e t e r s only.
It allows cha n gi n g the syst e m behavior, simply by passin g as par a m e t e r s the prop e r set of configu r a t io n s
withou t having to edit the m .
A mul t i - co nf i g u r a t i o n is a co m a “,” se p a r a t e d list of co nf i g u r a t i o n IDs ord er e d by priority, the
first on e bei n g th e hi g h e s t priori ty.
For prop e r t i e s file
-Dtafj.p r o p e r t i e s = o r a c l e - loc ki n g , b a s e
For dat a b a s e configu r a t i o n
-Dtafj.c o n f i g u r a t i o n = ora c l e - lock i n g , b a s e
In the exam pl e above, 2 configu r a t io n s are refer e n c e d : “oracle- locking” and “base”.
The first configu r a t io n take s prec e d e n c e on the secon d and so on.
It mea n s “oracle- locking” could only define one prope r t y for the lock man a g e r which will over ri d e the
one define d in “base”. “base” cont ai nin g the full set of prop e r t i e s .
The table below resu m e s the priority betw e e n prope r t i e s base d on thei r definition level.
Syst e m prope r t y take s prec e d e n c e on “configu r a t i o n 1” which takes prec e d e n c e on “configu r a t i o n 2 ”. i.e.
-Dtafj.pr o p e r t i e s = c o n f i g u r a t i o n 1 , c o n f i g u r a t i o n 2
-Dtafj.c o n f i g u r a t i o n = c o n f i g u r a t i o n 1 , c o n f i g u r a t i o n 2

Syste m prop e r t y configu r a t i o n 1 configu r a t i o n 2 Value loade d

- tem n.k ey 1 = c o n f 1 tem n.k ey 1 = c o n f 2 syst e m

Dtem n.k e y 1 = s y s t e m

tem n.k ey 2 = c o n f 1 tem n.k ey 1 = c o n f 2 conf1

tem n.k ey 1 = c o n f 2 conf2

14
TAFJ S e t u p

Print e r

TAFJ use the JPS (Java Print Service).

On Window s, JPS use the Print e r Man a g e r . You can conne c t any print e r s installe d on Window s. The
Print e r has to be online.
On UNIX/LINUX, JPS use CUPS (Com m o n Unix Printin g Syste m ). CUPS is not inst all by default. You have
to install it. Pleas e refe r to your OS docu m e n t a t i o n for the installa tion.
In the prop e r t i e s file, cate go r y print e r , the setu p of TAFJ auto m a t i c ally adds your print e r s online with
default drive r nam e PRN #. You can affect the cha n n el to any drive rs’ na m e .

15 Teme n o s Application Fra m e w o r k Java – (TAFJ)

Che c k TAFJ Inst a l l a t i o n

To Check to installatio n of tafj, you can exec ut e the com m a n d “tDia g ” . The com m a n d will show you the
whe r e is set TAFJ_HOME, the version of the JVM, the version of TAFJ, the defaul t project and all det ails
of all project s set in <TAFJ_HO M E > \ c o n f

EarFil e b u i l d e r

Warnin g : This step is only specific to weblogic applica tio n serve r

!

Unde r TAFJ_HOME/ bi n the utility tEARFileb uild e r . s h/ b a t will help gene r a t i n g the nece s s a r y EAR file for
TAFJ and T24 libra ri e s relat e d, includin g all nec e s s a r y deploym e n t files specific to weblogic cont ain e r .
The following is the help for the tEARFileb uild e r utility.
tEarFil e b u i l d e r . s h / b a t -h
Usag e: Ear FileBuilde r -na m e <e a r- file- nam e > -so ur c e <ja r s- path > -de s t < d e s t > -de p {option al }
[dep e n d e n c y- spec- version] -incl u d e {option al } [jar- nam e s]
whe r e argu m e n t s can be :
-na m e :Nam e of the ear file to be gene r a t e d with {,spe cifica tion,i m pl e m e n t a t i o n }
version (defa ul t 0.0 for both)
-sou r c e : The list of folder you want to pars e (os pat h sepa r a t o r bet w e e n folde rs)
-de s t : The pat h whe r e you want the ear file to be gene r a t e d
-dep <o p t > : Depe d e n c y modul e na m e s followe d by {,spe cifica tion,i m pl e m e n t a t i o n } version if any
sepa r a t e d with , (os pat h sepa r a t o r bet w e e n for mor e than one depe n d e n c y).
-incl u d e <o p t > : when specified with , sepe r a t e d jar nam e s will only be include d part of ear file
from mention e d sourc e direct o ri e s. i.e TAFJCor e.ja r,TAFJBasic.ja r
Exam pl e:
tEARFileb uil d e r -nam e TAFJ_LIB,201 8 0 3 -sourc e
C:\Tem e n o s\ D ev el op m e n t \TAFJ_SOURC ES\TAFJ_DEV\Relea s e Di r\lib;C:\Te m e n o s\ D ev el op m
ent\TAFJ_SOURCES\TAFJ_DEV\Rele a s e Di r\ ex t;C:\Te m e n o s \ D ev el o p m e n t \ D EV\TAFJ\Rule sE
ngine -dest C:\Tem e n o s\D ev elo p m e n t \ D EV\T24 -dep T24_LIB,20 1 8 0 3
Sea r c hi n g direct o ry ... C:\Tem e n o s\D e v elop m e n t \ TAFJ_SOURCE S\TAFJ_DEV\Rele a s e Di r\lib [ OK ]
Sea r c hi n g direct o ry ... C:\Tem e n o s\D e v elop m e n t \ TAFJ_SOURCE S\TAFJ_DEV\Rele a s e Di r\ ex t [ OK ]
Sea r c hi n g direct o ry ... C:\Tem e n o s\D e v elop m e n t \ DEV\TAFJ\RulesE n gi n e [ OK ]
gene r a t i n g applica tion.x ml file ... [ OK ]
gene r a t i n g weblogic- applica tio n.x ml file ... [ OK ]
gene r a t i n g Manifes t file ... [ OK ]
16
TAFJ S e t u p
gene r a t i n g TAFJ_LIB file ... [ OK ]
clea n up ... [ OK ]
Ear file is gen e r a t e d und e r : C:\Tem e n o s\ D ev el op m e n t \ D EV\T24 in 4565 ms.
Not e : pleas e make a note in the above exam pl e the specifica tio n version is pass e d while gene r a t i n g EAR
file nam e along with dep e n d e n c y nam e, s p e cifica tio n version.
While gen e r a t i n g TAFJ_LIB ear file, one nee d to make sure to pass all nec e s s a r y folde r s whe r e the
depe n d e n c y jars are pre s e n t i.e TAFJ/lib (TAFJCore,TAFJCom m o n etc…) ,TAFJ/ext
(TAFJBasic,t Co m p o n e n t F r a m e w o r k etc…),TAFJ/rule s e n gi n e (rulesE n gi n e ).
While gen e r a t i n g T24_LIB, one nee d to need to pass the dep e n d e n c y infor m a t i o n about TAFJ_LIB nam e
with appr o p ri a t e specifica tio n/i m pl e m e n t a t i o n version.
i.e
tEARFileb uil d e r -nam e T24_LIB,20 1 8 0 3 -sour c e C:\Tem e n o s\ D ev elo p m e n t \ D EV\T24\lib\t 2 4lib_20 1 8 0 3
-dest C:\Tem e n o s\D e v elop m e n t \ DEV\T24 -dep TAFJ_LIB,201 8 0 3

Com m i t Capt ur e

Com mi t capt u r e , trigge r s a dat a event when a WRITE/DELETE is perfor m e d inside or outside tra n s a c t i o n
boun d a r y on configu r e d files. The trigg e r e d Data event s are the n stor e d in event table, F.DATA.EVENTS.

Prope r t y Setu p
In your TAFJ prope r t i e s file, set the below prop e r t y to ena bl e com mi t capt u r e
tem n. t afj.r u n ti m e . u s e . df.c a c h e = true
Set the below prop e r t y to write the event to disk when ev e r the event size exce e d s 32K.
tem n. t afj.r u n ti m e . df.c a c h e . h u g e . e v e n t = t r u e

Configu r a tio n
Execut e the below com m a n d from a JBC progr a m to turn ON/OF F the feat u r e for a file. Inte r n a lly, the
option is set in TAFJ_VOC, henc e it will not be rese t still it is cha n g e d agai n.
DF_COMMIT_CAPTURE( FileN a m e , Filter M o d e )
Wher e, FileN a m e is the nam e of the file as in TAFJ_VOC.
Filter Mo d e should set to eithe r “U” or “Y” or by defa ult it is NULL. Wher e NULL indica t e s the
featu r e is turn e d OFF.
In U Mode, the write event s are capt u r e d whe r e a s in Y Mode, both the WRITE and DELETE event s are
capt u r e d .
17 Teme n o s Application Fra m e w o r k Java – (TAFJ)
Sam pl e com m a n d to turn ON the feat u r e for a file:
EXECUTE "DF_COMMIT_CAPTURE('FBNK.CURRENCY','Y')" CAPTURING EXE.OUT

Events table
The capt u r e d event s in F.DATA.EVENTS is const r u c t e d with the following fields,
 Field1 - Timest a m p recor d crea t e d in milliseco n d s. e.g. 13860 8 2 8 9 1 . 9 9 4 9

 Field2 - Timest a m p recor d proc e s s e d . (Initially left blank)

 Field3 - Not applica bl e for TAFJ

 Field4 - Not applica bl e for TAFJ

 Field5 - Multivalue d list of file nam e s. e.g. FBNK.STMT.ENTRY]FBNK.ACCOUNT

 Field6 - Sub- value d list of recor d keys relat e d to the file nam e s

 Field7 - Sub- value d list of dat a relat e d to the key or {DELETE} if recor d delet e d .

 Field8 - Sub- value d list of tabl e nam e .

The filter recor d keys have the following form a t :

X<Por t N o > _ < U U I D > _ < s e q u e n c e num b e r >
Wher e:
X - Is an indica t o r as eithe r ‘U’ for une nc r y p t e d or ‘E’ for enc ryp t e d filter recor d s
Port N o - Is the port num b e r of the proc e s s perfor mi n g the write.
UUID - Univer s a lly Uniqu e Identifier
Seq No - Incre m e n t i n g sequ e n c e num b e r for multipl e filter reco r d s desc ri bi n g a tra n s a c t i o n

Outb o x Even t s
Base d on T24- Trans a c t raising busine s s event s on dem a n d using SYSTEM (5005), the event s are
collect e d par t of tran s a c t i o n boun d a r y and are emit t e d to outbox MS libra ry to proc e s s it (upd a t e some
relation al table s) and rec eive back event Id’s which are push e d to a configu r e d queu e.

Prope r t y Setu p
In your TAFJ prope r t i e s file, set the below prop e r t y to ena bl e outbox Event s
te m n . t a f j.r u n t i m e . o u t b o x . e v e n t s = true
Set the below prop e r t y to specify the que u e nam e to which the event s has to be deliver e d par t of
tran s a c t io n.
te m n . t a f j.r u n t i m e . o u t b o x . q u e u e . n a m e =q u e u e / TAFJ- outboxIdQ u e u e
Set the below prop e r t y to specify the conne c t io n F a c t o r y to be use d for inter a c ti n g with the queu e nam e
specified above. If the prop e r t y is left em pty, the defa ul t conne c tio n Facto ry is use d to resolve the queu e.
te m n . t a f j.r u n t i m e . o u t b o x . c o n n e c t i o n . f a c t o r y =

18