T24 ATM ISO 8583 Interface

Installation Guide

Information in this document is subject to change without notice.

No part of this document may be reproduced or transmitted in any form or by any means, for any purpose,
without the express written permission of TEMENOS HEADQUARTERS SA.
COPYRIGHT 2007 - 2008 TEMENOS HEADQUARTERS SA. All rights reserved.
 Table of Contents

Document History ...................................................................................................................... 3

1. System Requirements ........................................................................................................ 4
2. General Considerations ...................................................................................................... 4
3. Contents of the Package .................................................................................................... 4
4. Installing the Package - Automated.................................................................................... 5
Pre-Installation ....................................................................................................................... 5
3.1 Development Installation .............................................................................................. 5
3.2 Compilation of Source code ......................................................................................... 6
3.3 Data Libraries Restoration............................................................................................ 6
Authorizing records .................................................................................................................... 8
Post-Installation...................................................................................................................... 8
Installing the ATM Listener ................................................................................................. 8
Configuring the ATM Listener............................................................................................. 8
Logging setup ................................................................................................................... 10
5. Configuring the System .................................................................................................... 10
Local reference fields/T24 USERs creation ......................................................................... 10
Interface Parameter Tables ................................................................................................. 11
Verifying installation ............................................................................................................. 11

2
 Document History

Author Version Date

K. Divya 1.0 25.07.2008

K. Divya 1.1 07-07-2009
S.Anitha 1.2 05-10-2009
Pradeep Kumar 1.3 30-11-2009

3
 1. System Requirements

The following are the pre-requisites for installing this package.

 jBASE Release 4.1.5 or above
 T24 Release R6 or above
 TC 1.5 is required to support all features. (Recommended: TC 1.5_13)
 Dependency – radlib component

2. General Considerations
 When transferring object code via FTP the transport method must be set to binary.
 When transferring data libraries via FTP the transport method must be set to ASCII
and the FTP client should be configured to preserve the case names of the source
files.

3. Contents of the Package

The ATM ISO 8583 Package consists of a
 isolistener.jar – java based ATM listener software
 TMNS000-GR0800012.tar.Z – data records
 GR0800012Ins.tar.Z, radIns.tar.Z-Inserts
 GR0800012lib,radlib – object code

4
 4. Installing the Package - Automated
Pre-Installation
3.1 Development Installation
The following steps are to be followed for the installation of ATM ISO8583 Development.
 GR0800012Ins.tar.Z, radIns.tar.Z, is a compressed tar file that contains the Insert Files
of the development.
 GR0800012lib.tar.Z, radlib.tar.Z is a compressed tar file that contains the necessary
executables (object codes) and libraries
 TMNS000-GR0800012.tar.Z is a compressed data record
 Do a FTP of these files in Binary mode into the “.run” directory of the area in which
you wish to install the development.
 Go to the Unix Prompt from the jBASE prompt by typing the following command

Command Syntax - Example - Entering UNIX prompt from jBASE Prompt

jshsh (Hit Enter Key)

 This will take you to the $ prompt

 Uncompress the GR0800012lib.tar.Z, radlib.tar.Z, by giving the following command at
the UNIX prompt

Command Syntax - Example - Executing the uncompress command

$uncompress -c – GR0800012lib.tar.Z | tar –xvf –

$uncompress –c – radlib.tar.Z | tar –xvf –

 Extraction will create a directory GR0800012lib , radlib

 Grant permission to the directory

Command Syntax - Example - Executing the grant permissions command

$chmod –R 777 GR0800012lib

$chmod –R 777 radlib

$exit

 In the .profile change the value of environment variables.

 JBCOBJECTLIST

5
 Command Syntax - Example - Executing the .profile

jsh JED .profile

In the .profile in the following line (sample displayed below - Environment specific)

export JBCOBJECTLIST=$HOME/globuspatchlib:$HOME/globuslib:$HOME/lib

Append the following string: $HOME/GR0800012lib:$HOME/radlib

Logout and login again to GLOBUS server.

 Uncompress the insert files GR0800012ins.tar.Z , radins.tar.Z

Command Syntax - Example - Executing the uncompress command

$ uncompress –c – GR0800012Ins.tar.Z | tar –xvf –

$ uncompress –c – radIns.tar.Z | tar – xvf –

 On compressing the tar files folders namely Gr0800012Ins,radins,

AKIBA.ATM.BP,RAD.BP is created

Now we have successfully installed the development into the client‟s machine.

3.2 Compilation of Source code

Not applicable.

3.3 Data Libraries Restoration

The following steps are to be followed for the installation of the GR0800012 Data Libraries
 Do an ftp in BINARY mode and put the TMNS000-GR0800012.tar.Z in mbdemo.run
 Uncompress the TMNS000-GR0800012.tar.Z by giving the following command at the
Unix prompt

Command Syntax - Example - Entering Unix Prompt from Universe Prompt

Jsh->sh (Hit Enter Key)

 This will take you to the $ prompt

Command Syntax - Example - Executing the uncompress command

$ uncompress –c TMNS000-GR0800012.tar.Z | tar –xvf –

6
  Login into TEMENOS GLOBUS TM.

 In the Command Prompt of the TEMENOS GLOBUS TM to open the Library

Parameter SYSTEM Record type DL.PARAMETER<<space>> I<<space>>
SYSTEM

INPUT IN THE DL.PARAMETER, IN INPUT MODE OF THE SYSTEM RECORD

Field OPERATION – Should contain the value R

Field FROM.FILE – /server12/APAC/HNBnew/small/live/live.run

Field OVERWRITING – Should contain the value Y

Field RESTORE.UNITS – Should contain the name of the Library (TMNS000-

GR0800012)

The SCREEN SHOT (1) below shows a sample DL.PARAMETER record

Please refer to the Path in SCREEN SHOT (1) and make the required changes to
point to the path you wish to install

It is advised that the USER performing this action, has access to all the Companies in
the Account, if the installation is on a MULTI COMPANY Environment

The field values defined in SYSTEM record of DL.PARAMETER are ENVIRONMENT

SPECIFIC and the values shown in the screen shot are only
Examples.

The SCREEN SHOT (3) below shows a sample DL.DEFINE record IN “Verify” function.

SCREEN SHOT2 - DL.DEFINE entry for restoring the pack

 Commit the record –TMNS000-GR0800012

7
  Once this Record is Committed using the “Verify” function, the Data Records will get
placed into the corresponding files in IHLD Status in the $NAU Files, and in Live in
LIVE Files.

Authorizing records
Authorise all the records found in IHLD Status in the below applications,

1. PGM.FILE

2. EB.API

3. STANDARD.SELECTION

4. ENQUIRY

5. INTRF.MAPPING

6. VERSION

7. OFS.SOURCE

Post-Installation
Now, the listener plug-in to TC (Temenos Connector) needs to be installed and configured.

Installing the ATM Listener

The interface uses Temenos Connector (TC) to communicate with the external world. TC has
in-built listener for TCP/IP, MQ for many other standard protocols. ISO-8583 through TCP
requires a special feature where-in the first 4 bytes of the message should correspond to the
length of the message.
This is necessary as ISO messages are neither fixed length nor delimited. To accommodate
this special listener is required and since TC supports the concept of custom listeners as
plug-ins a custom listener is built for ISO as a plug-in.
All plug-ins are developed as jar file which contains a descriptor file which tc will refer to in
order to identify the plug-in.
The jar file isolistener.jar is to be dropped into the “jboss-
4.2.3.GA\server\default\deploy\tocfplugin-ra.rar”. Extract the rar file and update the
isolistener.jar in the file and compress it.

Configuring the ATM Listener

The adapter and the listener configuration are to be done the “tcserver.xml” file. This file will
exist in the path (path from home directory) –
“jboss-4.2.3.GA\server\default\deploy\tocfplugin-ra.rar”
The below screenshot contains the configuration to be done for the ADAPTER ID. This
should be updated below the ADAPTER Ids that exist as of now.
Under the <LISTENERS> tag a new listener has to be configured as below.
The value in the attribute „type‟ has to exactly correspond to what‟s given in the file plug-
in.desc as plug-in-id.
The value in the attribute „type‟ has to exactly correspond to what‟s given in the file plug-
in.desc as plug-in-id.

<LISTENER Name="atm" type="isolistener" active="true">

<ADAPTERID>ATM</ADAPTERID>

8
 <PORT> 4002 </PORT>
</LISTENER>

(The below screen shot was taken in a windows installation for better illustration)
The adapter for this listener should be a normal T24adapter with
Note: The values in STARTIN and JBASEPATH below, are for illustration only. The
values may change depending on the implementation site.
<ADAPTER id="ATM">
<!--
<REQUEST_FORMATTER>Thai2UTF, OFSML, UTF2Thai</REQUEST_FORMATTER>
<RESPONSE_FORMATTER>Thai2UTF, OFSML, UTF2Thai</RESPONSE_FORMATTER>
-->
<MAX_SESSION> 5 </MAX_SESSION>
<MIN_SESSION> 0 </MIN_SESSION>
<TIMEOUT>30</TIMEOUT>
<LOGIN_CONTEXT></LOGIN_CONTEXT>
<STARTIN>/glois/Tempareas/priyag/bnk/bnk.run</STARTIN>
<JBASEPATH>/jbase/jbc507</JBASEPATH>
<PROGRAM>tSS</PROGRAM>
<PARAMETER>ATM</PARAMETER>
</ADAPTER>

The <PARAMETER> tag should contain the OFS.SOURCE record to be used by this
adapter.

(The below record is supplied with the package and the BUILD.CONTROL should
automatically authorise this record subject to the availability of GENERIC.USER
mentioned, the same needs to be verified. If the record is in un-authorised status the
existence of GENERIC.USER must be checked and the loginid should be changed to the
UNIX login of the environment. Both of these fields are not used by the interface but are
required just for authorising the OFS.SOURCE record.)

9
 Logging setup
Logging for the interface is achieved by using monitoring adapter of TCServer used for T24
event logging. The level of logging is controlled through a parameter definition in a parameter
table called RAD.LOG.PARAMETER as shown below.

<LISTENER Name="FILE.1" type="filelistener" active="true">

<ADAPTERID>monitor</ADAPTERID>
<REQUEST_PATH>/glois/Tempareas/priyag/bnk/interfaces/log/request</REQUEST_PATH>
<RESPONSE_PATH>/glois/Tempareas/priyag/bnk/interfaces/log/response</RESPONSE_PATH>
<ERROR_PATH>/glois/Tempareas/priyag/bnk/interfaces/log/response</ERROR_PATH>
</LISTENER>

This listener should be tagged to a monitoring type of adapter.

Note: All listeners are defined inside <LISTENERS> </LISTENERS> tag and all adapters are
defined inside <ADAPTERS></ADAPTERS> tag.

5. Configuring the System

Local reference fields/T24 USERs creation
A set of USERs should be created which will be used by the interface as sign on details for
transaction inputs and enquiry executions through OFS. In a multi-company environment
these users must have full access to all companies.

10
 The users created must have the following sign on names and passwords if the mapping files
provided are to be used as they are.

TEMENOS01/123456,
TEMENOS02/123456
TEMENOS03/123456
TEMENOS04/123456

The interface doesn‟t force the above. If USERs are created with a different SIGN.ON.NAME
and/or PASSWORD the INTRF.MAPPING records should be changed accordingly.

Interface Parameter Tables

There are a few interface parameter tables in T24 that need to be configured. Please refer to
the ISO 8583 ATM User Guide for details on how to set the parameter tables.

Verifying installation
To make sure the configurations shown above are in place the interface can be run without
actually connecting to the switch s/w.
This can be achieved at two levels.

1. From tSS
2. From the listener
The basic program tSS needs to be run from jbase prompt and a sign on message needs to
be fed as shown.

When the listener is left unlocked the same test can be extended to one more level where the
request is fed through the listener. This is achieved using the atmsimulator if the simulator is
supplied with the package or the same can be achieved by using telnet as well.

11