TEMENOS

Rules Engine

Configuration and Installation Guide

No part of this document may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the express written permission of TEMENOS Holdings NV.

Copyright 2005 TEMENOS Holdings NV. All rights reserved.

Rules Engine

Table of Contents
Overview.................................................................................................................................................. 3
Setup ....................................................................................................................................................... 4
Installation Prerequisites ...................................................................................................................... 4
T24 Release ..................................................................................................................................... 4
Rules Engine JAR (Java Archive) .................................................................................................... 4
Java .................................................................................................................................................. 4
T24 Toolbox ..................................................................................................................................... 4
Profile settings ..................................................................................................................................... 5
JAVA_HOME.................................................................................................................................... 5
PATH ................................................................................................................................................ 5
LIBPATH .......................................................................................................................................... 5
CLASSPATH .................................................................................................................................... 5
Temenos Connector Settings ........................................................................................................... 6
Known Issues .......................................................................................................................................... 7
Java Versioning ................................................................................................................................... 7
Java JVM Errors .................................................................................................................................. 7
Temenos Connector issues ................................................................................................................. 8

TEMENOS User Guide

Page 2 of 8
Rules Engine

Overview
This document explains Pre-requisites and setup details for configuring ARC Rules-engine
components. The Java Rules-Engine components can be obtained from Temenos distribution.
([email protected] )

For a detailed guide on how to use the T24 Rules Engine and Rule Designer, Refer to the main user
guide.

TEMENOS User Guide

Page 3 of 8
Rules Engine

Setup
Installation Prerequisites
T24 Release
The T24 release that includes support for the Rules Engine is R08 (from build 200706 onwards).
Ensure any EB.API records with SOURCE.TYPE equal to “Java” have authorised.

Rules Engine JAR (Java Archive)

The Rules Engine java component (named rules-engine.jar) and its dependent java archives obtained
from Temenos distribution must be installed in the following location.

bnk.run (directory)
|_____ RulesEngine (directory)
| rules-engine.jar
| xml-apis.jar
| xercesImpl.jar
| jaxb-api.jar
| jaxb-impl.jar
| jaxb-xjc.jar
| jsr173_1.0_api.jar
| antlr-2.7.6.jar
| commons.jar
| commons-codec-1.3.jar
These jar files including the rules-engine.jar will be released in the form of a zip file. These entire jar
files will need to be copied into the run directory of the T24 account under a new directory called
RulesEngine.

Java
Recommended version - Java 1.5 or above.

T24 Toolbox
The Rule Designer graphical user-interface is part of the T24 ToolBox suite of applications In order to
use the Rule Designer graphical user-interface, Temenos Toolbox ( version 1.2007.10.4 or above)
must be installed. . For information on how to install the T24 Toolbox product refer to the ‘ToolBox’
user guide available under the ‘Presentation>ToolBox’ section I the T24 User Guides.

TEMENOS User Guide

Page 4 of 8
Rules Engine

Profile settings
Following environment variables needs to be changed in .profile file. (For Win NT below changes must
be done in remote.cmd file).
Note :
- path separator in UNIX is ‘:’ and in Windows should be ‘;
- Below specified directories are for example only

JAVA_HOME
Environment variable must point to the java runtime installation directory.
For Unix [ export JAVA_HOME=/usr/bin/java15 ]
For Win NT [ set JAVA_HOME= C:\Java\jre1.5 ]

PATH
The shell searches for executables in order of path elements appearing in PATH, Hence ensure that
the Java bin directory appears in PATH, and earlier than any other versions. The recommended
approach is to insert $JAVA_HOME/bin at the front of the PATH environment variable.

For Unix [ export PATH=$JAVA_HOME/bin:$PATH ]

For Win NT [ set PATH=%JAVA_HOME%/bin;%PATH% ]

LIBPATH
For Unix [ export LIBPATH=$LIBPATH:$JAVA_HOME/jre/bin:$JAVA_HOME/jre/bin/j9vm ]
For Win NT [ set JBCJVMLIB=C:\Java\jre1.5\bin\client\jvm.dll ]

CLASSPATH
For Unix
export RELIB=$HOME/RulesEngine
export CLASSPATH=$CLASSPATH:$RELIB/rules-engine.jar
export CLASSPATH=$CLASSPATH:$RELIB/xml-apis.jar
export CLASSPATH=$CLASSPATH:$RELIB/ xercesImpl.jar
export CLASSPATH=$CLASSPATH:$RELIB/ xalan.jar
export CLASSPATH=$CLASSPATH:$RELIB/ jaxb-api.jar
export CLASSPATH=$CLASSPATH:$RELIB/ jaxb-impl.jar
export CLASSPATH=$CLASSPATH:$RELIB/ jsr173_1.0_api.jar
export CLASSPATH=$CLASSPATH:$RELIB/antlr-2.7.6.jar
export CLASSPATH=$CLASSPATH:$RELIB/commons.jar
export CLASSPATH=$CLASSPATH:$RELIB/commons-codec-1.3.jar

TEMENOS User Guide

Page 5 of 8
Rules Engine

CLASSPATH For Win NT

set RELIB=%HOME%\RulesEngine
set CLASSPATH=%CLASSPATH%;%RELIB%\rules-engine.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\xml-apis.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\xalan.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\jaxb-api.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\jaxb-impl.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\jsr173_1.0_api.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\antlr-2.7.6.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\commons.jar
set CLASSPATH=%CLASSPATH%;%RELIB%\commons-codec-1.3.jar

Temenos Connector Settings

See the Temenos T24 Connector User Guide for detailed information on configuring TC Server.
Note: Its mandatory to update all system and environment variables setup in .profile and remote.cmd
files (specified above) in environment.vars file.

TEMENOS User Guide

Page 6 of 8
Rules Engine

Known Issues
Java Versioning
It is essential that jBase and Java are using compatible bit architecture (i.e). If running on NT, 64 bit
jBase with 64 bit NT etc. Following command can be used to determine java version

java -version

The output should be similar to the following lines:

java version "1.5.0_07"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_07-b03)
Java HotSpot(TM) Client VM (build 1.5.0_07-b03, mixed mode, sharing)

If a message such as 'command not found', is observed or an older version of Java being reported,
check the PATH environment variable.

Java JVM Errors

In order for the rules engine to function correctly, CALLJ must be correctly configured for jBASE. See
the jBASE Programmers Reference Guide for detailed information on configuring jBASE to support
CALLJ. This usually means configuring a specific path variable depending on the T24 Server platform.

Windows : JBCJVMLIB
Linux : LD_LIBRARY_PATH
HP-UX : SHLIB_PATH
AIX : LIBPATH
Solaris : LD_LIBRARY_PATH

These environment variables should be set in the .profile file.

In order to fully verify that CALLJ is working, a simple test can be executed:
Compile and run the testcallj.b file, this test routine is contained in the Rules Engine zip file along
with the Rules Engine Java code jars:

$ BASIC . testcallj.b
$ CATALOG . testcallj.b

TEMENOS User Guide

Page 7 of 8
Rules Engine

If this fails to compile, it must be ensured that the routine testcallj.b has the correct line endings
for the environment. This is achieved using either:
$ dos2ux testcallj.b > testcall2.b2
$ tr -d '\r' < testcallj.b > testcallj.b2
Once testcallj compiles, check if CALLJ is correctly configured.
$ testcallj
received from Java
Input: param
java.version: 1.5.0
java.vendor: IBM Corporation

If CALLJ is working, a message something similar to the lines above should be observed, depending
on the T24 server platform. If not, retry same after checking environment variables
If CALLJ is not configured correctly, the Rules Designer should report an error when attempting to
validate, save, or test a rule.

Temenos Connector issues

Having confirmed that CALLJ works from the command line, It must be ensured that CALLJ works
when communicating from Browser to the T24 server through TCServer. Often its observed that
connector specific environment variables ( stored in environment.vars file ) should contain accurate
references of JAVA_HOME, CLASSPATH, PATH, etc.
Use the env command in Unix (set for Win NT) to compare and verify settings

If Tag is being used instead of TCServer please consult the TAG consultant for configuration
information.

TEMENOS User Guide

Page 8 of 8