You are on page 1of 6

How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

((//ss//)) C
Coom
mmmu
unniittyy LLe
eaarrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))

How to configure Rules Engine with browser using TOCF(EE)


Explore product details, discuss issues, find the latest news, and
contribute to best practices.

How to (/s/how-to)  >  How to configure Rules Engine with browser using TOCF(EE)

   Rate    Like    Bookmark

(/s/profile/0056A000000izetQAA) How to configure Rules Engine with browser using TOCF(EE)


Vinay Jain - Admin (/s/profile/0056A000000izetQAA)  •  Apr 28, 2021  •  Technology > Core-Tech > ToolBox (TB)

      18

How to configure Rules Engine with browser using TOCF(EE)

Overview
This document explains Pre-requisites and setup details for configuring ARC Rules-engine components. The Java Rules-Engine components can be obtained from
the Temenos distribution. distribution@temenos.com (mailto:distribution@temenos.com)
For a detailed guide on how to use the T24 Rules Engine and Rule Designer, Refer to the main user guide.

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" has
authorized.

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

1 of 6 2/10/2023, 7:35 PM
How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

location.
     bnk.run (directory) ((//ss//)) C
Coom
mmmu
unniittyy LLe
eaarrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
           |_____ 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.

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                                             ]

2 of 6 2/10/2023, 7:35 PM
How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

CLASSPATH
For Unix ((//ss//)) C
Coom
mmmu un
niittyy LLe
eaarrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
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
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

TOCF(EE) Settings
See the TOCF(EE) User Guide for detailed information on configuring TOCF(EE).
Note: If the jbase agent is started via scripts then it is mandatory to update all system and environment variables setup in .profile and remote.cmd files (specified
above) in the script file.

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. The following command can be used to
determine the 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

3 of 6 2/10/2023, 7:35 PM
How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

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
((//ss//)) usually
C
Coom means
mmmu
un configuring
niitty
y LLeaarspecific
ea rn
n path
PPrrovariable
od uccttss depending
du TTrra
aiinon
niin
ngthe T24 Server
g D
Doow
wnplatform.
nllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))
     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
 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 similar to the lines above should be observed, depending on the T24 server platform. If not, retry the same after checking environment
variables. Also, a sample output is shown below,

4 of 6 2/10/2023, 7:35 PM
How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

If CALLJ is not configured correctly, the Rules Designer should report an error when attempting to validate, save, or test a rule.
((//ss//)) C
Coom
mmmu
unniittyy LLe
eaarrn
n PPrro
oddu
uccttss TTrra
aiin
niin
ngg D
Doow
wnnllo
oaad
dss SSu
uggg
geesstt ((//ss//iid
deea
attiio
onn))

0 Comments

PPo
osstt Q
Quue
essttiio
onn

Share an update... Share

Sort by:

Most Recent Activity Search this feed...

Collaborate here!
Here's where you start talking with your colleagues about this.

Supplier Information Terms of use Base Camp FAQ


ww.temenos.com (https://www.temenos.com (https://www.temenos.com (https://basecamp.temenos.com Follow US
/information-for- /legal-information /s/article-detail

5 of 6 2/10/2023, 7:35 PM
How to configure Rules Engine with browser using TOCF(EE) https://basecamp.temenos.com/s/article-detail/a042K00001KIplsQAD/how-to-configure-rules...

suppliers/) /website-terms-and- /a046A000001lZe4QAE/temenos- (https://www.linkedin.com (https://www.linkedin.com


((//ss//)) conditions/)
C
Coom
mm muun
niittyy LLe
eaarrn
n base-camp-faq)
PPrro
oddu
uccttss TTrra
aiin
niin
ngg /company/temenos)
D
Doow
wn nllo
oaad
dss SSu
uggg
ge/company/temenos/)
es
stt ((//ss//iid
deea
attiio
onn))

6 of 6 2/10/2023, 7:35 PM

You might also like