Pre-R17 Release

Temenos Application Framework Java (TAFJ)

Release Notes

Page 1
 Table of Contents

IMPORTANT RELEASE INFORMATION...............................................................................................3

Release Highlights................................................................................................................ 3
Database Enhancements................................................................................................... 3
Multi-column support...................................................................................................... 3
Locking........................................................................................................................... 3
DBTools............................................................................................................................. 3
Dictionary Cache............................................................................................................... 3
Documentation.................................................................................................................. 3
IDE, Variable Initialisation Check.......................................................................................4
TAFJEE............................................................................................................................. 4
TAFJRestServices......................................................................................................... 4
Sanity check................................................................................................................... 4
Execute servlet.............................................................................................................. 4
T24 Features..................................................................................................................... 4
Breaking change................................................................................................................ 4
PB201072...................................................................................................................... 4
PB201612...................................................................................................................... 5
PB201606...................................................................................................................... 5
PB201607...................................................................................................................... 5
R17 SP3......................................................................................................................... 6
System Component Requirements....................................................................................7
INSTALLATION OF THE SOFTWARE................................................................................................... 8
Upgrading TAFJ.................................................................................................................... 8
Upgrading T24 on TAFJ........................................................................................................ 8

Page 2
IMPORTANT RELEASE INFORMATION
This section outlines new features in TAFJ R17 and contains important
information for upgrading clients. If you are upgrading from an earlier
release of TAFJ, please read and understand all the release information
details for each release before starting the installation.

Release Highlights
This section provides an overview of any new TAFJ components or features and advice
regarding any components which have been replaced, deprecated or modified.

Database Enhancements

Multi-column support

For tables needing super-fast indexing, a table can be turned into a pseudo-relational table
where multi-values are stored in NVARCHAR columns. While this approach provides worse
performance in terms of reads due to the fact a dynamic array needs to be constructed out of
all of the columns, it will provide better indexing speed for single-value columns.

Locking

Now there is a hybrid locking mechanism implemented such that some locks can be taken at
the database by row locking. Non-existant locks (locks on records that do not exist yet) are
still locked by a secondary lock manager. For example, to set up database row level locking
with ORCL locking handling the non-existant records, the following properties would be set.

temn.tafj.locking.mode= DATABASE
temn.tafj.jdbc.db.locking.secondary.lockmanager = ORCL

DBTools
DBTools is now secured, you need to define user and password to be able to login into
DBTools. Refer to DBTools documentation for more details.
All DBTools actions are also being logged to keep trace of command used and user.

Dictionary Cache
Dictionary entries can now be cached by setting the key
temn.tafj.runtime.use.cache.dict.item=true
Note that this should be used in single server mode only. Cluster configurations and multi-
node server configurations coming next year.

Documentation
A run book is now available covering T24 java configuration for all supported stack.

Page 3
IDE, Variable Initialisation Check
Variable initialisation is enforced when using the IDE. Non initialised variables will be
considered as a compilation error. Option can (but should not) be turned off in the IDE.

TAFJEE

TAFJRestServices

A new JAX-RS based webservice component is available in TAFJJEE_EAR, it is intended to

replace former Axis2 based webservice component.
This new component could be secured through basic authentication and related TAFJJEE
client is now accepting user / password parameters. Refer to TAFJ AS documentation for
more details.

Sanity check

A sanity check is available through TAFJEE servlet, this tool runs a validation of the
application server configuration by comparing what is expected at application level (TAFJEE)
and what is effectively configured at application server level in terms of resources and
parameters. Refer to TAFJ AS documentation for more details.

Execute servlet

Messages / actions posted to the EXEC queue for processing are being logged and reported
to the Execute servlet page. A notification is also reported on action completion.
It allows following tSA / command history and status.

T24 Features

LOGOFF has been fixed to time out tSA exceeding T24 time out value.

Breaking change

PB201072

A new property is available at MDB level to configure the time to live for the responses sent.
Default behaviour is unchanged, time to live is unlimited, and doesn’t require any change.
To have a response expiration the following property has to be added at ejb-jar.xml level for
the related MDB.
<env-entry>
<description>the response time to live in milliseconds from its dispatch timdefault is zero is
unlimited</description>
<env-entry-name>com.temenos.tafj.mdb.TransactedMDB/responseTimeToLive</env-entry-name>
<env-entry-type>java.lang.Long</env-entry-type>
<env-entry-value>10000</env-entry-value>
</env-entry>

Refer to TAFJ-AS documentation for detailed explanation.

Page 4
PB201612

Webservices components:
TAFJServices.war, axis2 based webservices component is deprecated.
TAFJRestServices.war, JAX-RS based webservices component is replacing it.
For back compatibility reason, both archives are packaged in TAFJJEE_EAR until R17-AMR
and TAFJServices.war removal.
Refer to TAFJ-AS documentation for more details.
TAFJEE client:
TAFJJEE client classes, e.g. TAFJJEEClientFactory, part of TAFJClient.jar have been re-
factored to match the new JEE services available, JAX-RS webservices, Websocket
endpoint etc…

Client applications should migrate to make only use of classes which are part of

package com.temenos.tafj.jee.client;

instead of formerly

package com.temenos.tafj.j2ee.client.impl;

package com.temenos.tafj.j2ee.client.impl;

PB201606

TAFJ is using SLF4J as logging API and is shipped with a default logger configuration for
log4j (TAFJTrace.properties).
This won’t make any difference from end user perspective since SLF4J-API and SLF4J-
LOG4J12 are part of the application classpath.
These libraries are part of standard TAFJ_HOME/lib distribution.
For application server setup, please refer to the related TAFJ documentation.

PB201607

Following above mentioned 201606 migration to SLF4J logging API, the class loading setup
required in weblogic stack might be a concern for some.
Hence PB201607 gives the ability to use either SLF4J or log4j2 as the main logging API.
The default API being used is now log4j2 with a provided default logger configuration,
TAFJTrace.properties. Log4j 2 properties format is not compatible with former log4j 1.2
configuration.
When upgrading to PB201607, existing TAFJTrace.properties will be overridden to match
log4j2 requirement.
Log4j2 libraries are part of standard TAFJ_HOME/lib distribution, SLF4J libraries introduced
in PB201606 have been removed of the default lib directory.
For application server setup, please refer to the related TAFJ documentation.

Page 5
To preserve backward compatibility please note this is still well possible to keep using former
log4j 1.2 setup but this is not recommended as further logging enhancements are not going
to be supported when using log4j 1.2.
It could be either behind SLF4J as in PB201606 or natively with little configuration change.
See TAFJ standalone documentation for more details.

R17 SP3

Adding Stored Functions tafjsplice, tafjupcase and tafjlowcase. These functions are now
supported

Page 6
System Component Requirements
The following table shows the minimum recommended Temenos components and release
numbers which are designed to run with TAFJ.

Component Release JDK

Temenos Application Framework Java R17-AMR Supported JDK
TAFJ JDK 1.7.x and JDK 1.8.x

Application Server Version

WebSphere 8.5.5.x
WebLogic 12c (12.1.x)
jBoss 6.4 EAP

DataBase Server Version

DB2 DB2 v10 / DB2 v10 Workgroup edition / DB2 v10 zOS
Oracle 11g(11.2.x) 12c
MS-SQL 2012

Broker (JMS) Server Version

WebSphere MQ 7.5.x / 8.x

HornetQ 2.4.0
ActiveMQ 5.11.x /5.13.x

Page 7
INSTALLATION OF THE SOFTWARE
Transfer the archive to the target machine and unzip the archive to a
suitable directory.
Execute the scripts Setup_TAFJ.Rxx_Y.

Upgrading TAFJ
If you have an earlier version of TAFJ installed you should stop all TAFJ processes, services,
and save any system configuration files before proceeding with the installation of TAFJ.
Upgrade Summary
Transfer the archive to the target machine and unzip the archive to a
suitable directory.
 Setup environment variable JAVA_HOME to path where java is installed.
 Setup environment variable TAFJ_HOME to path where TAFJ is already installed.
 Setup environment variable ECLIPSE_HOME to the folder %TAFJ_HOME
%\eclipse
 Execute Patch_TAFJ.Rxx_Y.

Upgrading T24 on TAFJ

If you have an earlier version of T24 on TAFJ installed you should stop all TAFJ processes,
services, and save any system configuration files before proceeding with the installation of
TAFJ.
Upgrade Summary
 From DBTools under TAFJ_HOME/bin execute the TEMP-RELEASE
option with valid parameters as below.
Ex: DBTools - TEMP.RELEASE <path_to_temp_release>
<path_to_precompiled> -bp {path_to_BP_folder} -i
{path_to_inserts_folder}
Where in –bp and –i are option parameters.
 Check that the TEMP.RELEASE is pointing to the correct upgrade
path under SYSTEM>TEMP.RELEASE file.
 Run T24.PRE.RELEASE(logout and login with a new session)

You are now ready to follow any pre-release procedures described below:
 Respond to the Model Bank question appropriately.
 Provide a USER id as requested.
Once this is complete you are ready to sign on to T24 to initiate the upgrade service.
 Start the TSA.SERVICE record BNK/T24.UPGRADE.
 Authorise any CONVERSION.PGMS records.
 Initiate the service RUN.CONVERSION (TSM must also be run)
 Recompile any local code (New inserts provided by the release and
or TAFJ upgrades require this)

Page 8
Once this is finished the record review and authorisation process can
start.

Page 9