T24 Enterprise Console
T24 Enterprise Console
T24 Enterprise Console
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.
Table of Content
Table of Content ...................................................................................................................................... 1
Table of Content ...................................................................................................................................... 2
T24 Enterprise Console........................................................................................................................... 3
Application Overview ........................................................................................................................... 3
What does the tEC show me?.......................................................................................................... 3
Application Design ............................................................................................................................... 5
TEC.ITEMS ...................................................................................................................................... 5
TEC.PROFILE.................................................................................................................................. 7
TEC.ACTIVE.ITEMS ........................................................................................................................ 8
TEC.OUTPUT .................................................................................................................................. 9
Overview of Input and Processing ..................................................................................................... 11
Worked Example ............................................................................................................................ 11
Dynamic modification of active profile............................................................................................ 13
Monitoring custom items using tEC................................................................................................ 13
Monitoring GLOBUS using tEC...................................................................................................... 18
Sample TEC.ITEMS record............................................................................................................ 19
Enquiry TEC.DETAIL ..................................................................................................................... 20
Enquiry TEC.SUMMARY................................................................................................................ 21
Enquiry TEC.OVERVIEW............................................................................................................... 22
Enquiry TEC.PANEL ...................................................................................................................... 23
Application Overview
The T24 Enterprise Console (tEC) is a comprehensive system management framework, built to internet
standards, that provides a robust console, a rich set of tools, and the ability to detect, solve, and
simplify the full range of problems that can arise in any managed environment.
tEC is based upon a lightweight architecture with minimal impact to your T24 installation.
This allows T24 users to monitor every aspect of performance and behaviour of their T24 environments
by defining a monitoring profile that reports on the use and activity of the system, as well as the tools
to solve any exceptional behaviour.
Menus and graphical displays with full drilldown and investigative facilities ensure that the information
is easily accessible, and includes the ability to store this information historically for reporting purposes,
as well as the full help and documentation you would expect from T24.
Application Design
TEC.ITEMS
This is the main table where all the items that can be monitored are defined.
Sample Data
Field Name Value
TEC.ITEM.ID DELIVERY.CALL
LL.DESCRIPTION Count of call to Delivery
TYPE COUNT
XX<THRESHOLD.TYPE
XX>THRESHOLD
TEC.PROFILE
This is the table where we can specify the specific items that we wish to monitor and the list of users
for which they need to be monitored.
Once a record with the necessary items to be monitored are specified in the TEC.PROFILE, the
record needs to be verified in order for the record to be made as an active profile. Verifying a record in
the TEC.PROFILE will write the verified record into the TEC.ACTIVE.ITEMS file. It is this file that the
tEC will refer to in order to obtain the items to be monitored (active items).
TEC.ACTIVE.ITEMS
File Type : L File Classification : INT
This is the file that hols the currently active profile. This file is automatically updated when the
TEC.PROFILE is verified.
ACTIVE.PROFILE*TEC.PROFILE ID
SequenceNumber_TEC.ITEM ID_ _Thresholds( if any delimited by , )
Sequence Number : Multi value number of the item in the TEC.PROFILE table
Thresholds : The values specified in the TEC.ITEMS in the field THRESHOLD
Sample Data
ACTIVE.PROFILE*TEC.TRG.PROFILE
1_READ.RESPONSE_ _
2_WRITE.SIZE_ _1000,3000,
3_SELECT_ _1000,3000,
4_READ.SIZE_ _100000
TEC.OUTPUT
File Type : L File Classification : INT
SessionNumber.LogSetNumber.ItemName
Session Number : Whenever the user logs in, the initial initialisation process of the tEC environment
is performed. It loads the active profile from TEC.ACTIVE.ITEMS on to the memory and also reads the
F.LOCKING table with the id TEC.SESSION.NUMER. This record contains a sequence number,
which is incremented by one and written back into the F.LOCKING table. This incremented number is
the first part of the TEC.OUTPUT table. The field SESSION.MAX in the TEC.PROFILE table allows us
to set the maximum value that this session number can hold. For example, if this is set to 50, once the
session number crosses 50, it will automatically be reset to 1.
LogSetNumber : Making the TEC.OUTPUT file store all the activities for ever could be very
expensive on storage space. Therefore, the TEC.OUPUT file has been built with a self-cleaning
mechanism. There are 2 fields that control this in the TEC.PROFILE table namely, LOG.SETS (the
number of log sets to maintain) and FLUSH.TIME (the number of seconds after which the data will be
flushed from the memory to the disk).
Worked Example
Let us understand the working of the tEC using a simple example.
Assume that the following record is created in the TEC.PROFILE table and verified:
So, the only item that we wish to monitor is the time taken for every F.READ to be executed.
When the user INPUTTER signs on, the active profile in the TEC.ACTIVE.ITEMS gets loaded on to
the memory. The load routine will then check to see if the current user needs to be monitored and
monitor only if the current signed on user name is specified in active profile (TEC.PROFILE record).
If the user performs an activity that invokes an F.READ, (e.g. typing CUSTOMER L), find below the
sample data that could be written on to the TEC.OUTPUT file for the READ.RESPONSE item.
the activity
METRIC.AVG
METRIC.HIGH 1001 The highest time taken in milliseconds to
execute the activity
TOP.KEY 100069 The ID of the record that took the highest time
to be read/written/executed
TXN.REF 100069 ID of the record read/written
APPLICATION CUSTOMER Application that triggered the activity
START.TIME 37685413 Start time
END.TIME 37716 End time
SessionNumber.LogSetNumber.ItemName
Session Number : Whenever the user logs in, the initial initialisation process of the tEC environment
is performed. It loads the active profile from TEC.ACTIVE.ITEMS on to the memory and also reads the
F.LOCKING table with the id TEC.SESSION.NUMER. This record contains a sequence number,
which is incremented by one and written back into the F.LOCKING table. This incremented number is
the first part of the TEC.OUTPUT table. The field SESSION.MAX in the TEC.PROFILE table allows us
to set the maximum value that this session number can hold. In our case it is set to 50. Hence, once
the session number crosses 50, it will automatically be reset to 1.
LogSetNumber : Making the TEC.OUTPUT file store all the activities for ever could be very
expensive on storage space. Therefore, the TEC.OUPUT file has been built with a self-cleaning
mechanism. There are 2 fields that control this in the TEC.PROFILE table namely, LOG.SETS (the
number of log sets to maintain) and FLUSH.TIME (the number of seconds after which the data will be
flushed from the memory to the disk).
For the first time after the user signs on or when the COB is initiated, when activities gets recorded,
the log set number is set to 1 and therefore the records with the following ids will be formed:
SessionNumber.1.ItemName
Once the data gets flushed from the memory to the TEC.OUTPUT file, the log set number is
incremented (by one). Hence, the activities that get recorded after the first flush of data to the
TEC.OUTPUT table will have the following id:
SessionNumber.2.ItemName
Since we have set the LOG.SETS to 5 in the TEC.PROFILE, once the log set number crosses 5, it
would get reset 1. Once the log set number gets reset to 1 data in the TEC.OUTPUT file will start
getting overwritten. What this means to us is, if we set LOG.SETS to 5 and FLUSH.TIME to 60, we
would at any point in time have the activities performed by an user in the last 5 minutes.
Scenario
Monitor the execution time of the following subroutine
SUBROUTINE TEC.CUSTOM.ITEM.TIME.TRAINING
$INSERT I_COMMON
$INSERT I_EQUATE
MSLEEP(1000) ; * Sleep for 1000 milliseconds (ie) 5 seconds
RETURN
END
Step 1
Create an item in the TEC.ITEMS file so that it can be used to monitor your subroutine.
XX<THRESHOLD.TYPE
XX>THRESHOLD
Step 2
Create a new record in TEC.PROFILE and add this item to it. Alternatively, you could add the custom
item to any one of the existing records in the TEC.PROFILE table.
Step 3
In order to monitor the above-mentioned subroutine, the subroutine needs to call the
TEC.START.TIMER and the TEC.STOP.TIMER routines.
Change the above subroutine to include a call to TEC.START.TIMER and TEC.STOP.TIMER
MY.TYPE Used to identify the TEC.ITEMS that is being logged. Can be left blank if the
routine is to be used to calculate the execution time of a routine. If it is going
to be used to calculate the read/write time per transaction, then it needs to
hold the transaction reference.
MY.TIMER.KEY Used to identify the item such that the timer can subsequently be stopped
using the TEC.STOP.TIMER API.
MY.DETAILS Will hold the detail level information on the item that you are recording.
MY.KEY = THE.TXN.REFERENCE
MY.TYPE = WHATEVER.IM.MEASURING
SUBROUTINE TEC.CUSTOM.ITEM.TIME.TRAINING
$INSERT I_COMMON
$INSERT I_EQUATE
Y.RETURNED.DETAILS =
CALL TEC.START.TIMER(,TRAINING.TEST1)
MSLEEP(1000)
CALL TEC.STOP.TIMER(,TRAINING.TEST1,Y.RETURNED.DETAILS)
RETURN
END
Step 4
Now verify the TEC.PROFILE record, log in, execute the routine (remember to make an entry in the
PGM.FILE with PGM.TYPE set to M in order to execute the routine as a mainline routine).
Check the TEC.OUTPUT to view the recorded activity.
Scenario
In the following subroutine, the size of the selected list of ids needs to be monitored.
SUBROUTINE TEC.CUSTOM.ITEM.SIZE.TRAINING
$INSERT I_COMMON
$INSERT I_EQUATE
$INSERT I_F.CUSTOMER
FN.CUS = F.CUSTOMER
F.CUS =
SEL.LIST =
RET.CODE =
NO.OF.REC = 0
CALL OPF(FN.CUS,F.CUS)
SEL.CMD = SELECT :FN.CUS
CALL EB.READLIST (SEL.CMD,SEL.LIST,,NO.OF.REC,RET.CODE)
RETURN
END
Step 1
Create an item in the TEC.ITEMS file so that it can be used to monitor your subroutine.
Step 2
Create a new record in TEC.PROFILE and add this item to it. Alternatively, you could add the custom
item to any one of the existing records in the TEC.PROFILE table.
FLUSH.TIME 60
XX.ITEMS TRAINING.TEST2
XX.USERS INPUTTER
SESSION.MAX 50
REFRESH.TIME
Step 3
In order to calculate the size of the selected is the TEC.RECORD.ACTIVITY routine needs to be used.
Change the above subroutine to include a call to TEC.RECORD.ACTIVITY.
TEC.RECORD.ACTIVITY routine
This routine needs to be used when items of metric type SIZE need to be measured
TEC.RECORD.ACTIVITY(MY.TYPE,MY.KEY,MY.DETAILS,MY.VALUE)
Step 4
Now verify the TEC.PROFILE record, log in, execute the routine (remember to make an entry in the
PGM.FILE with PGM.TYPE set to M in order to execute the routine as a mainline routine).
Check the TEC.OUTPUT to view the recorded activity.
The tEC enquiries build data from the TEC.DISPLAY file that has a similar structure to the
TEC.OUTPUT file. As the data in the TEC.OUTPUT file is bound to change rapidly, the tEC enquiries
transfer the data from the TEC.OUTPUT file to the TEC.DISPLAY file. The TEC.DISPLAY file is
always cleared before data is placed into it.
The controlling factor of the tEC enquiries is the REFRESH.TIME field in the TEC.PROFILE. This field
specifies the time with in which, if a tEC enquiry is executed, the data in TEC.DISPLAY will not be
rebuilt. The default value of this field is 15 seconds.
The tEC enquiries display data that correspond to the THRESHOLDs that we specify in the
TEC.PROFILE. Let us understand this with a simple example:
XX<THRESHOLD.TYPE WARNING
XX>THRESHOLD 100 (Records with size 31 100)
XX<THRESHOLD.TYPE CRITICAL
XX>THRESHOLD (Records with size 101 and above)
Enquiry TEC.DETAIL
File on which the enquiry is based : TEC.DISPLAY
Build routine : TEC.PRODUCE.DISPLAY
Mandatory selection criteria : ITEM.TYPE
Details : Displays the activities of a particular type.
Information
Warning
Critical
Enquiry TEC.SUMMARY
File on which the enquiry is based : TEC.DISPLAY
Build routine : TEC.PRODUCE.DISPLAY
Mandatory selection criteria : METRIC TYPE
Details : Displays the consolidated position of the activities of
a particular metric type.
Enquiry TEC.OVERVIEW
Enquiry TEC.PANEL