0% found this document useful (0 votes)
59 views35 pages

Dev Studio

Uploaded by

Hmani Emna
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
59 views35 pages

Dev Studio

Uploaded by

Hmani Emna
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 35

TEMENOS T24

DevStudio

User 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,
electronic or mechanical, for any purpose, without the express written permission of TEMENOS Holdings NV.

Copyright 2005 TEMENOS Holdings NV. All rights reserved.


DevStudio

Table of Contents
Overview .................................................................................................................................................. 4
Setup ....................................................................................................................................................... 5
Display Settings ................................................................................................................................... 5
Locations .............................................................................................................................................. 6
Run Time Settings ............................................................................................................................... 6
Your Details ......................................................................................................................................... 7
The Code Editor ...................................................................................................................................... 7
User Details ......................................................................................................................................... 7
The Development Environment ........................................................................................................... 8
The Tool Bar ..................................................................................................................................... 8
The Main Pane ............................................................................................................................... 10
The Navigation Pane ...................................................................................................................... 11
The Tools Pane .............................................................................................................................. 12
Basic Features ................................................................................................................................... 12
Creating a New Program ................................................................................................................ 12
Opening a Program ........................................................................................................................ 13
Editing the Code ............................................................................................................................. 14
Viewing Code on the Server .......................................................................................................... 15
Saving Code ................................................................................................................................... 15
Compiling Code .............................................................................................................................. 15
Find & Replace ............................................................................................................................... 16
Autosave ........................................................................................................................................ 16
Advanced Features ............................................................................................................................ 16
System & User Defined Macros ..................................................................................................... 16
Creating GOSUBs .......................................................................................................................... 18
Creating Regions............................................................................................................................ 18
Bookmarks & Modification Marks ................................................................................................... 19
Program Locking ............................................................................................................................ 20
My T24 Projects ..................................................................................................................................... 22
The Project Console .......................................................................................................................... 22
Creating a New Project ...................................................................................................................... 22
Adding Files to your Project ............................................................................................................... 23
Project Properties .............................................................................................................................. 24
The T24 Visual Debugger...................................................................................................................... 26
Pre-requisite Set-up ........................................................................................................................... 26
Starting the T24 Visual Debugger...................................................................................................... 27

TEMENOS T24 User Guide Page 2 of 35


DevStudio

Debugging Your Programs ................................................................................................................ 28


Adding Watches ................................................................................................................................. 30
Context Menu ..................................................................................................................................... 31
Setting a New Breakpoint .................................................................................................................. 31
Call Stack and Memory Allocation ..................................................................................................... 32
The Debugger Console ...................................................................................................................... 32
Spy Session & Command Session ........................................................................................................ 35

TEMENOS T24 User Guide Page 3 of 35


DevStudio

Overview
The T24 DevStudio contains a set of productivity tools to aid T24 Developers. This component can be
used by both Temenos developers and external clients when writing T24 core or local developments.
Since the T24 DevStudio is provided as a ToolBox plug-in all pre-requisites for installing and running
the ToolBox application must be met.

The T24 DevStudio plug-in

DevStudio contains 5 main components:

The Code Editor


Project Explorer
Visual Debugger
Spy Session
Command Session

Each of these components will be explained in this document.

TEMENOS T24 User Guide Page 4 of 35


DevStudio

Setup
The DevStudio Options can be accessed via the Options Icon shown in ToolBox or via the Code
Editor Tools Menu.

The Options Dialog

The Options dialog allows user to specify all required settings needed by DevStudio alls user
preferences such as colours and fonts to be specified.
The Options have been categorised into four sections:
1. Display Settings: to hold fonts & colours etc.
2. Locations: to hold local and server paths
3. Run Time Settings: to hold required settings
4. Your Details: to hold details required for Program locking.

The Options dialog displays a ‘Restore Defaults’ button that can be used to re-set the options values if
required.

Display Settings
Option Name Description
Background The Background Colour of the Code Editor.
CodeFont The Font Used in the Code Editor.
Comment The Colour Applied to Code Comments
CommonVariables The Colour Applied to T24 Common Variables
CurrentLineHighlight The Colour Applied to the Current Line Highlight
DescriptionText The Colour Applied to the Description Text within the “<desc>…..</desc>’
tags
Foreground The Colour Applied to Normal Text
HighlightCurrentLine If set to True the current line will be Highlighted
IndentationGuides If set to True a faint line will indicate the indentation level

TEMENOS T24 User Guide Page 5 of 35


DevStudio

Keywords The Colour Applied to jBASE Keywords


MarkLineModifications If set to True a line will appear in the margin to indicate a modification has
occurred at that line.
Region The Colour applied to the region tags “<region name=…..>…….</region>”
ShowLineNumbers If set to True the line number margin will be displayed
StringLiteral The Colour applied to all string literals i.e. text between “” and ‘’.

Locations
Option Name Description
LocalWorkPath The local working directory. This is where your local programs and autosave
will be saved.
ServerDirList The list of Directories where your programs are stored on the T24 Server.
Separate each entry by ‘,’ e.g. BP,T24.BP,TEST.BP….

Run Time Settings


Option Name Description
AutoSaveInterval The Interval of the Auto-Save (In Minutes)
DebugPortNumber The Server Socket that the debug listener runs on
ServerIP The Server to connect to for the Spy and Command Sessions
SpyPortNumber The Server Socket that the spy listener runs on

TEMENOS T24 User Guide Page 6 of 35


DevStudio

Your Details
Option Name Description
Email User email address
Telephone User telephone number
Username User Name or ID

The Code Editor


The code editor supports all of the features provided by the previous versions. It provides an IDE
(Integrated Development Environment) that performs many functions. At a simple level, the code
editor may be used as nothing more than a glorified text editor that allows programs to be downloaded,
modified and then saved to the server and compiled.

User Details
The first time the Code Editor is launched a dialog will appear to prompt for user details. One person
can only edit server program files at any one time. This ensures that different people do not make
conflicting changes. In order to facilitate this a locking mechanism has been created which registers
which user has locked which file for edit. Therefore, a User Name must be supplied when logging in to
the T24 DevStudio. This should be clear enough that the person editing a particular file can be
identified should any problems occur. The Login screen also allows you to add additional contact
information, although this will not be stored in the jBASE database at present.
When the OK button is pressed this information is saved to the T24 DevStudio Options file. This
information can be changed at any time via the Options Icon found under the T24 DevStudio plug-in.

The user details dialog.

TEMENOS T24 User Guide Page 7 of 35


DevStudio

The Development Environment

The Main Code Editor Window

The main screen is split into several areas:


1. The Tool Bar
2. The Main Pane
3. The Navigation Pane (Right hand pane)
4. The Tools Pane (Bottom pane)

The Tool Bar


The toolbar contains the most common buttons for performing editing commands. Additional
functionality is also available by using the right mouse button click while in the editing area. This
displays a list of commonly needed commands.
The toolbar contains the following buttons:
Icon Name Shortcut Description
Create a New Ctrl+N Creates a new program file on the local PC.
Program
Open a Local Ctrl+O Opens a program file on the local PC.This may be a new
Program program currently being developed or a program previously
fetched from the server. If any files have been opened or

TEMENOS T24 User Guide Page 8 of 35


DevStudio

saved in past sessions, then when the small down arrow


button is pressed a list of up to 5 file names are displayed.
Selecting one of these files allows quick access to
previously used files.
Open & Lock a Ctrl+Shift+O Launches the Open Server Program dialog that will allow
program from the user to specify the program and the location of the
the Server required program for editing. The file is marked as locked
on the server by an entry in the EB.DEV.LOCKING
application. If any files have been edited in past sessions,
then the small down arrow button is pressed a list of up to 5
file names are displayed. Selecting one of these files allows
quick access to previously edited server files
View a Ctrl+Shift+V Fetches the specified program file from the server for
Program from viewing. The file downloaded will be read-only.
the server
without Locking
it
Save Locally Ctrl+S Saves a program file on the local PC. If not already
supplied a destination is prompted for. This button is only
available for new programs or programs that have been
locked on the server and downloaded.
Save to Server Ctrl+Shift+S Returns the current program file to the server. The file is
saved on the server.
Compile F5 Saves the file locally before saving the file on the server
ready for compilation. The output from the compilation is
displayed in the Output screen and any Tasks that may
result will be shown in the Tasks Window.
Indent Ctrl+T Indents at the current insertion point

Outdent Ctrl+Shift+T Outdents at the current insertion point

Insert a - Inserts a comment line at the current insertion point.


Comment Line
Comment out Ctrl+Shift+U Adds a comment directive to the currently selected code.
the selected
lines
Uncomment Ctrl+Shift+U Removes any comment directives from the currently
the selected selected code.
lines
Jump to Line Ctrl+G Jumps to the specified line number of the program code

Refresh the Ctrl+R Refreshes the List pane as well as re-processes the
Code Window colouring of the program code
Format the Ctrl+Shift+F Formats the program code by indenting text that is of the
Code same statement level.
Print Ctrl+P Prints the current code.

Display the Ctrl+I Displays a dialog showing the current locking information
current for the currently open program.

TEMENOS T24 User Guide Page 9 of 35


DevStudio

Program’s
Locking info.
Convert Ctrl+Shift+C Converts an F.READ Statement into a CACHE.READ
F.READ to statement if detected.
CACHE.READ
Toggle - Adds or removes a bookmark to the currently open
Bookmark program.
Go to Previous - Jumps to the previous bookmark if any.
Bookmark
Go to Next - Jumps to the next bookmark if any.
Bookmark
Clear - Clears All defined bookmarks.
Bookmark
Go to Previous - Jumps to the Previous Modification mark if any.
Modification
Go to Next - Jumps to the Next Modification mark if any.
Modification
Clear All - Clears all Modification marks.
Modification
Marks

The Main Pane


The main pane comprises of four Tabs. Each Tab performs a specific function:
Start Page: This page provides access to recently used Projects, Server & Local Files. The first time
the Code Editor is launched these will be empty, however as it used any projects or source code
opened is listed. To access theses items at any time users can double-click to launch them.
Code: The ‘Code’ tab is the main editor window. This is where all source code can be created and
modified.
Code Only: The ‘Code Only’ tab will display the source code that is shown in the ‘Code’ tab but
without detected comments i.e. all code minus the comments.
Regions: This page will display an expandable list of detected regions within the code displayed in the
‘Code’ tab.

TEMENOS T24 User Guide Page 10 of 35


DevStudio

The Navigation Pane

The Navigation Pane

The Navigation Pane is split into several sections:


Labels: Displays a list of all Label directives in the loaded program. Clicking on these items will
position the cursor at that point.
Inserts: Displays a list of all $INSERT directives in the loaded program. Clicking on these items will
position the cursor at that point.
Calls: Displays a list of a CALL statements in the loaded program. Clicking on these items will
position the cursor at that point. If there are multiple calls to the same program then each time the
item is clicked on the next occurrence is located.
Macros: Displays a list of Standards and User Macros and the Macro Control Panel. Please see
section on Macros in this document for further information.
Map: This is split into two sections ‘Structure’ and ‘Flow’. The ‘Structure’ will attempt to graphically
represent the structure of the loaded program in terms of labels, gosubs, calls and gotos. The ‘Flow’
will attempt to graphically represent the logical flow of the program in trems of labels, gosubs, calls
and gotos. Clicking on any of the items will position the cursor at that point.
Online Resources: Contains usefull URLS that a jBASIC developer may find useful.
Regions: Lists detected ‘Regions’ within the loaded program. Clicking on these items will position the
cursor at that point.

TEMENOS T24 User Guide Page 11 of 35


DevStudio

The Tools Pane

The Tools Pane

The Tools Pane is split into three sections:


Task List: This will display any Warning, Error or Information level items after a program has been
compiled. Clicking on each item will position the cursor at that point.
Output: This displays all the raw output after a compile action and also provides information after
each action such as a Save or a Load.
Find & Replace: Provides access to the find & replace control panel and a results page. Clicking on
each item will position the cursor at that point.

Basic Features
Creating a New Program
To create a NEW program, click the ‘Create a New Program’ icon from the Toolbar or select the ‘New’
menu item from the ‘File’ Menu.
The New Program wizard will started and the user will be prompted to enter the name for the New
program. The wizard will allow the user to select if a template should be used or a just blank program
be created.

The New Program dialog. Once the user has input a name and
selected whether a template should be applied ‘Next’ should be clicked.

If ‘Use Template’ is selected then the user will be prompted with a list of templates that can be applied.

TEMENOS T24 User Guide Page 12 of 35


DevStudio

Template Selection. The required prefix can be entered and


DevStudio will apply the prefix to required points within the template.

‘Finish’ should now be clicked and the program will be generated. The user is now able to edit the
program as required.

Opening a Program
The user is able to open both ‘local’ and ‘server’ programs. Local programs are defined as all
programs saved on the local machine and Server programs are defined as all programs saved on the
T24 server. To open local programs use the ‘Open Local File’ option and DevStudio will display a
standard browse and select dialog so that the required file be specified.
To open a Server sided program use the ‘Open Server File’ option and DevStudio will display the
‘Open Server File’ dialog

The Open Server File dialog

The option is given to ‘Browse’ the directory specified. If this is clicked then DevStudio will display a
list of all programs found under that location.

TEMENOS T24 User Guide Page 13 of 35


DevStudio

The Browse Server dialog

The Browse Server dialog displayed the contents of the specified directory. The user is able to search
for specific files by using the ‘Search Now’ button. The required operand can be specified and a value
to search for.
Once selected the required program can be opened by clicking ‘OK’.

Editing the Code


Once the server of local program has been opened, the user may edit the program as required. To
further facilitate the user a context menu is provided on the main editor screen that can be accessed
by right-clicking within the editor area.

The right-click context menu

The context menu provides standard editing options, cut, copy & paste. It also gives the options to
Open the selected text in the current session of a new session. Selection New session will open a
new DevStudio code editor. A lock will be applied to the program when it is opened. If the selected

TEMENOS T24 User Guide Page 14 of 35


DevStudio

text does not match an existing program DevStudio will be unable to resolve it and it will not be
opened. If ‘View’ is selected then the program will be opened in ‘Read-Only’ mode and a lock will not
be applied to that program.
The ‘Last Position’ option can be used to jump to the previous cursor (usually the position of the cursur
before an item was selected from the navigation tools.

Viewing Code on the Server


DevStudio allows programs to be opened in a ‘Read-Only’ mode. This means that programs can be
viewed but not modified. In this case a lock will not be applied to the program and the user will be
unable to modify the program displayed. This is only applied to ‘Server’ programs.

Open and View Options provided by the ‘File’ menu

Saving Code
Once a program has been modified the user is able to save the program either to the server or locally.
The following options from the ‘File’ menu item can be used to save a program to the server or locally:

Save Options provided by the ‘File’ menu

Compiling Code
Only server programs can be compiled. The option to compile will be disabled for local programs.
To compile a program select the ‘Compile’ toolbar item or select the ‘Compile’ menu item from the
‘Build’ menu. Once requested DevStudio will send a request to the server to compile the program.
Compilation output will be displayed in the ‘Output’ tab of the Tools pane. Any warnings, errors or
information messages will be displayed in the ‘Task List’ pane.

Compile Output

TEMENOS T24 User Guide Page 15 of 35


DevStudio

Compile Task List

Find & Replace

The Find & Replace console

The Find & Replace facility in DevStudio allows users to specify values to find and replace. The
results are displayed and items can be clicked on to move the cursor to that item.

Autosave
DevStudio has a built in Autosave mechanism. All auto-saved items will be saved in the following
location:
[LocalWorkPath]\Autosave\
The LocalWorkPath is specified in the DevStudio Options. A sub-directory will be created called
‘Autosave’ and all programs will be saved to that location using the specified AutoSaveInterval. All
auto-saved programs will have a ‘.sav’ extension.
The DevStudio status bar will indicate if the auto-save has been successful or not.

The Auto-save complete message on the DevStudio status bar

Advanced Features
System & User Defined Macros
DevStudio is deployed with a set of Standard Macros. These Macros or code snippets allow the user
to rapidly insert commonly used code snippets. The standard set of macros can be seen via the
‘Macro’ tab on the navigation pane.
To run a Macro the user can simply position the cursor at the required section in the program. Select
the Marco and either double-click on it or click the ‘Run’ button.

TEMENOS T24 User Guide Page 16 of 35


DevStudio

The ‘Macro’ Pane

After the Marco has been run, any user prompts will be displayed and then the code snippet inserted.
Users have been given the ability to create their own Macros. To create a Macro click the ‘Create’
button and a dialog will be displayed that will allow the user to design the required Macro.

The Macro Editor

The Prompts field holds the sets of questions that the user will be asked when using this command.
This is used to supply command data that will vary each time this command is run.
In the case of the example above, a conditional debug command will be inserted and the user must
supply the operator. When more that one prompt is required, each instance of the prompt should be
placed on a new line. The prompts field is optional. In this case just the text in the Text field is inserted
directly in to the program code pane. This facility is useful when common code is required to be
inserted but no differentiation is required in the text inserted.
The Text field holds the text to be inserted in to the program code when the ‘Run’ button is pressed
from the Macro pane. This text should be inserted including any new line characters that are required.

TEMENOS T24 User Guide Page 17 of 35


DevStudio

The answers to the prompts are placed in the ‘<>’ placeholders, where ‘x’ is a number corresponding
to the prompt number. The prompt numbers start at 1, this matches with the answer to the first prompt
line.

Creating GOSUBs
When writing a large and complicated program, a user may wish to move some code in to a separate
GOSUB within the same file. To do this the ‘Create Gosub’ item should be selected from the ‘Tools’
menu. The user may pre-select the code to be moved into the Gosub before the ‘Create Gosub’ item
is selected. If no text has been selected then a new ‘empty’ Gosub will be created. On selecting this
item the following dialog is displayed:

The Create Gosub dialog.

The name of the new GOSUB should be entered and an optional description. When OK is pressed the
selected code is moved to the end of the program code (or where the previously ‘* ’ label has been
inserted) and the selected code replaced with a call to the new GOSUB.

Creating Regions
Regions are expandable and collapsible user defined areas. Regions help to organise programs
logically and help with maintenance. It allows logical grouping of program subroutines. Creating
regions is done in a very similar manner as when creating GOSUBs.

The Create Region dialog

A name and optional description should be supplied when creating the region. As with GOSUBs if the
user has pre-selected text then the new region will encapsulate it. If the user has not then an empty
region will be created.

TEMENOS T24 User Guide Page 18 of 35


DevStudio

The region code encapsulating some text. The region is shown expanded.

The same region but shown collapsed.

The region as detected by the ‘Regions’ pane. Refresh should be clicked to re-fresh this list.

Bookmarks & Modification Marks

Bookmark and Modification Mark navigation panel.

Users and declare Bookmarks within the open program by simply placing the cursor at the required
line and clicking the ‘Toggle Bookmark’ icon on the toolbar. A blue bookmark icon will appear on the
left hand margin.

A user defined bookmark.

The user can specify multiple bookmarks within the same program and use the Previous and Next
bookmark icons to quickly navigate between them. All bookmarks can be cleared by clicking the
‘Clear bookmarks’ icon.
Bookmark information will NOT be saved with the program. When you closed your program user
bookmarks are not maintained.

Modification marks appear as a highlight line next to every line that has been modified by the user
since the program was opened. Rapid navigation between them is provided and the user can reset
these at any time by using the ‘Clear Modification Marks’ icon. Again these marks are not saved when
the program is closed.

TEMENOS T24 User Guide Page 19 of 35


DevStudio

Program Locking
As previously mentioned, in order that only one person edits server code at any one time, a locking
mechanism is used. This involves adding an entry to the jBASE application EB.DEV.LOCKING. The
key to this application is the program file name.
The underlying jBASE file used by the EB.DEV.LOCKING application is F.EB.DEV.LOCKING.
The EB.DEV.LOCKING application has the following fields :-

Field Description Status

User The name of the user who locked the program file. Taken from the Login
Mandatory
Name screen.

Email The email address of the user who locked the program file. Taken from the
Optional
Address Login screen.

Contact The contact number of the user who locked the program file. Taken from the
Optional
Number Login screen.

Lock Date The date that the program file was locked. Mandatory

The fetching and returning of program code automatically locks and unlocks files. However, the jBASE
EB.DEV.LOCKING program can be used to view current program locks, as well as unlock files that
were locked by mistake or no longer need to be locked.
The use of the Verify function on a EB.DEV.LOCKING record will remove the lock for the specified
program file. Please note that this should only be performed in emergencies and only by a senior
developer.
DevStudio provides a facility to Manage your individual locks and for you to view the program lock
information for the currently open program.

Lock management on the ‘View’ Menu item.

To display all Program locks maintained by the current user the ‘Program Locks…’ item should be
selected. The following dialog will be displayed.

The Program Locks dialog.

TEMENOS T24 User Guide Page 20 of 35


DevStudio

This dialog gives user the facility to un-lock all or individual items. This dialog will be automatically
displayed to the user when all DevStudio code sessions are closed. All locks are held on the T24
server so DevStudio will only attempt to retrieve them if your ToolBox is signed-on.

To display the locking information for the currently open file then select the ‘Program Lock Information’.
A dialog will display the lock information for that program.

The Program Lock Information dialog.

If a user attempts to open a locked program (that does not belog to them) then DevStudio will display
the Program Lock Information dialog but give the user the option to open the program in a ‘Read-Only’
mode.

The user can click on the ‘Open as Read Only’ button.

TEMENOS T24 User Guide Page 21 of 35


DevStudio

My T24 Projects
This component allows developers to group Server and Local program files into projects. It provides a
useful interface to access these items and allows you to include other project resource files such as
Functional and Technical Specifications.

The Project Console

The T24 Project console

When ‘My T24 Projects’ is launched from ToolBox the T24 Project Console is displayed. This allows
users the Open existing projects, Remove existing projects or Create a New Project.
The project console displays the Name & Description of the selected project and lists all files included
within that project.

Creating a New Project


Once ‘New Project’ is clicked the New Project dialog is displayed:

The New Project dialog.

TEMENOS T24 User Guide Page 22 of 35


DevStudio

The user can specify the name of the project, a description and a location. By default the location will
created from the LocalWorkPath option and the Project Name.
Once ‘OK’ is clicked the Project explorer will be displayed:

The Project Explorer

The project explorer is empty so the user must add files to it.

Adding Files to your Project


To add server, local or any other file to your project select the ‘Project’ menu and click on the ‘Add
Project Item…’ menu item.

The ‘Project’ Menu

The following dialog will appear:

Add Project Item dialog

TEMENOS T24 User Guide Page 23 of 35


DevStudio

If you wish to add a server file’ then select the ‘Server File’ Icon and click ‘Add’. If you wish to add a
local file then select the ‘Local File’ icon. If you wish to add any other file such as a document, viso
diagram, spreadsheet, project plan etc.. then select the ‘Other File’ icon and click ‘Add’.
The Project Explorer will display the appropriate dialog to add the particular item.
Once items have been selected the Project Explorer will display the items within a tree.

The Project Explorer showing different project items.

Each project item can be launch by double-clicking on it. All Server and Local Files will be open by
the DevStudio Code editor. All Other Files will be launched using the associated application e.g. MS
Word, MS Project etc.
Once all items have been added to the Project then it must be saved using the save icon on the
toolbar or the ‘Save Local’ option from the File Menu.
To remove an item from the project simply select it within the Project Explorer right-click can select
‘Remove Item’ from the context menu. The item will be removed.

The Project Explorer can be docked to the Left or Right of the Windows Desktop. This allows the
Project Explorer to be always visible and manage your DevStudio and other application sessions.
To Dock the Project Explorer select the ‘Docking’ menu item and check the required docking position
from the menu.

Project Properties

The Project Properties tab

TEMENOS T24 User Guide Page 24 of 35


DevStudio

Each project has the following properties:


Property Name Description
Description Short description of the current project
Project File This is the main file that hold ALL project information. This is the
file to open when you wish to open this project.
Project Folder The projects ‘working’ directory.
Project Name The name of the current project.

TEMENOS T24 User Guide Page 25 of 35


DevStudio

The T24 Visual Debugger


The T24 Visual Debugger is a tool that allows users to interactively debug T24 routines within the
stateless architecture.
It uses the jBASE Debugger engine and it supports ‘Most’ of its commands. The T24 Visual Debugger
relies on the Temenos Connector Server (TCS) to redirect debug output to a specified port.
The debugger eliminates the need for Classic sessions and provides ‘true’ debugging for T24 Browser.
Debugging via classic may not always produce the same results that you would get in Browser.
The T24 Visual Debugger allows users to step in & over code, set break points including conditional
breaks, watch variables etc..

Pre-requisite Set-up

Before the T24 Visual Debugger can be used the T24 Browser, TCServer T24 account must be
configured accordingly:
NOTE: The setup indicated in this document should be used as guide lines only. Please refer to the
documentation of each component for further information.

T24 Account:
Ensure that the environment variable is set in the T24 account that you wish to debug:
JBASE_DEBUG_PIPE=1
This can be set in the .profile, environment.vars or remote.cmd

TC Server:
In the file ‘tcserver.xml’ found under the ‘conf’ directory ensure that the ADAPTER that the T24
Browser channels are using has a <MAX_SESSION> value of at least 2. An example would be:
<ADAPTER id="T24">
<MAX_SESSION> 5 </MAX_SESSION>
<MIN_SESSION> 1 </MIN_SESSION>
<TIMEOUT>3000</TIMEOUT>
<STARTIN>/storage1/globus.accounts/globus.acc.2/srdevc.run</STARTIN>
<JBASEPATH>/usr/jbc</JBASEPATH>
<PROGRAM>tSS</PROGRAM>
<PARAMETER>WZ</PARAMETER>
</ADAPTER>

T24 Browser:
In the file ‘BrowserParameters.xml’ found in the root of the Browser Application the following values
must be set:

<?xml version="1.0"?>

TEMENOS T24 User Guide Page 26 of 35


DevStudio

<browserParameters xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<messageData>
<parameter>
<parameterName>Server Connection Method</parameterName>
<parameterValue>INSTANCE</parameterValue>
<!-- Options: GLOBUSCONNECTOR / INSTANCE / SOCKET / EJB -->
</parameter>
<parameter>
<parameterName>Instance</parameterName>
<parameterValue>production</parameterValue>
</parameter>
.
.

Under the \WEB-INF\conf directory locate the file ‘BrowserConnection.xml’ and ensure it contains an
Instance name as defined above ‘production’ in this case. Ensure that this instance defines the
required channels as defined in ‘channels.xml’.

<instances>
<instance name="production">
<encrypt>false</encrypt>
<compress>false</compress>
<retryperchannel>2</retryperchannel>
<encoding></encoding>
<verbose>false</verbose>
<channels>
<channel>browser.1</channel>
<channel>browser.2</channel>
</channels>
</instance>
</instances>

Starting the T24 Visual Debugger

Before the T24 Visual Debugger can be started the ‘Run Time’ options within the DevStudio Options
dialog must be provided:

DebugPortNumber:
This should be the same port number that the TC Server will redirect the Debugger output to. This
value is held in the ‘tcserver.xml’ file under the <DEBUGGER_PORT> attribute.

ServerIP:
This should be the IP address of your host server.

TEMENOS T24 User Guide Page 27 of 35


DevStudio

Once these parameters have been supplied you should be able to start the T24 Visual Debugger. To
do this, execute the ‘Visual Debugger’ icon shown in the DevStudio tools suite.
The T24 Visual Debugger will attempt to connect to the IP address and port specified. Once
completed a tray icon is created and an information balloon displays the connection details. The main
T24 Visual Debugger window also displays the connection information and informs the user that it is
awaiting a Debug statement:

The Debugger Listener Tray Icon & Information Balloon

The Visual Debugger Main Window awaiting a Debug statement.

Debugging Your Programs

When using Browser to run T24 programs if a DEBUG statement is encountered normally your
program will appear to hang and the an invalid response will be received.
If however the T24 Visual Debugger is active a screen prompt and information balloon will appear
informing you that a DEBUG statement has been detected and will ask you if you wish to launch the
T24 Visual Debugger.

TEMENOS T24 User Guide Page 28 of 35


DevStudio

The Debugger prompt

The Debugger Listener has detected a DEBUG statement

If you click ‘Debug’ then the T24 Visual Debugger is launched. If ‘Continue’ is pressed then the
program will continue until a further DEBUG statement is detected or until execution is complete.
When ‘Debug’ is pressed the T24 Visual Debugger is launched and the source code of your program
is retrieved. (Ensure that you have signed on in ToolBox). The T24 Visual Debugger will display a
dialog that will allow the user to specify the source program to open. The T24 Visual Debugger will
attempt to pre-fill the program name and it directory if it is contained within the Debugger output.

Open Source dialog

Once the program has been opened the current line is highlighted and the user will be able to use the
debugger commands to step-over, step-in, set break points, continue etc as required. The ‘Debug’
menu item shows the commands that can be executed.

Debugger Commands Menu

TEMENOS T24 User Guide Page 29 of 35


DevStudio

The T24 Visual Debugger with source code loaded.

Once debugging is complete the T24 Visual Debugger will close and your program should now be
active.
NOTE: If you have taken a long time to debug your program you may receive the following error
message in T24 Browser:

T24 Browser response after a Time out has been reached.

This indicates that you have exceeded the time-out settings for the response. To over come this
problem set the time out values in Browser and in the TCServer to higher values. Alternatively debug
in an efficient manner so that you do not exceed the time out threshold values.

Adding Watches
The T24 Visual Debugger allows user to evaluate variables by setting watches. The lower pane of the
main debugger window contains a ‘Watches’ section.

The ‘Watches’ pane displaying some variables and their values.

TEMENOS T24 User Guide Page 30 of 35


DevStudio

Watches can be added to the list by clicking the ‘Click to Add..’ item. A dialog will appear and will
allow the user to enter the required variable name.

The ‘Add Watch’ dialog

Once ‘OK’ is clicked the variable will appear on the list. To evaluate that variable simply select that
item and click the ‘Refresh’ icon above it. The variable will be evaluated.
If there are multiple variables in the list each must be ‘refreshed’ by the user individually and each
should be ‘refreshed’ manually during debugging.

Context Menu
The T24 Visual Debugger window provides a context menu to give access to commonly used
commands. To access this menu right-click on the source code window.

T24 Visual Debugger Context Menu

Setting a New Breakpoint

The context menu can be used to set a breakpoint at a given line or a double-click action can be used.
For conditional breakpoints, use the ‘New Breakpoint’ item under the Debug menu to display the
following dialog.

TEMENOS T24 User Guide Page 31 of 35


DevStudio

New Breakpoint dialog

Insert values as required and a conditional break point will be set at the specified location.

Call Stack and Memory Allocation


The T24 Visual Debugger provides a Call Stack and Memory Allocation facility. Do view these select
the required option from the ‘Debug’ menu and each will be displayed in the relevant window. These
can be refreshed at any time during the debugger session.

The Call Stack

Memory Allocation

The Debugger Console


The T24 Visual Debugger provides a console (or a command line) where debugger commands can be
executed. To execute a command enter the command at the command line and click the ‘Go’ button.

TEMENOS T24 User Guide Page 32 of 35


DevStudio

The Debugger Console

The jBASE debugger can accept the following commands:


Command Syntax Description
< filename execute lines in filename as debugger commands
> filename write debugger status as debugger commands to filename
! Command execute Unix Command (!! to execute previous Command)
? help screen
nnn display line nnn of current source
a{bort} Executes an ABORT statement
b display Breakpoints
b nnn set Breakpoint at line nnn in current source
b nnn,filename set Breakpoint at line nnn in source filename
b {-gt} Variable set Breakpoint when contents of Variable changes
b {-gt} expr op expr set Breakpoint based on evaluation of expressions
c Continue program
d {-bdet} {nn|*} Delete {Enable/Disable} Trace/Break points
e filename Edit file filename and make it current source
end End program and return to shell
f {on|off} File name change status trace on/off
g Go - continue program
h {-rs{n}} {nn|on|off} History display and status
i {-v} Information in general
j {-g} Jump GOSUB stack display
l {-acf{nn}} {text} Locate text in current source
m {-v} Memory utilisation
n {nn} display Next nn lines of current source
o log OFF this user
p display Path for current sources
p pathlist set Path for current sources (delimited by ':')
q{uit} Quit program, issue a STOP statement

TEMENOS T24 User Guide Page 33 of 35


DevStudio

r devicename Redirect debugger to devicename


s {-dtcg} {nn} Single step for nn lines
S {-dt} {nn} Single step for nn lines, same GOSUB and CALL level
stop Executes a STOP statement
t display Trace expressions
t {-gmrsv} expr set Trace expression
v {-gmrsv} {expr} display expression
w {nn} display Window of nn lines of current source

TEMENOS T24 User Guide Page 34 of 35


DevStudio

Spy Session & Command Session

Due T24’s stateless architecture it has become increasingly difficult to determine the status of each
message going back and forth. There are many layers and components involved and from a
developers point of view it can be very time consuming to determine what has gone wrong.
The Spy Session allows developers to see all response messages sent from the T24 server.

The Command session allows developers to execute jBASE and shell commands without the need for
3rd party terminal emulator software.

TEMENOS T24 User Guide Page 35 of 35

You might also like