CUS7.Introduction To Enquiry
CUS7.Introduction To Enquiry
In this learning
unit you will learn about Enquiries in T24. You will also create simple enquiries that will
fetch data from T24.
CUS-Introduction to Enquiry 1
The conventions used in this learning unit are,
3. This learning unit is example based. First an example output will be shown then you
will be taught the steps to create the Enquiry. At the end of each section a workshop is
given to test your level of understanding.
CUS-Introduction to Enquiry 2
At the end of this learning unit you will be able to
CUS-Introduction to Enquiry 3
T24 is made up of different applications like CUSTOMER , ACCOUNT ,
FUNDS.TRANSFER etc. An application validates and stores the data that is input.
To view data from an application , you can do a LIST (L) of all the records. You can
also view a particular record, if you know the record ID using the SEE (S) function. The
LONG LIST (L L) function allows you to specify a selection criteria before the list of
records are displayed to you.
How do you create user defined reports that fetch and display data as you require?
You can use the ENQUIRY application.
T24 allows you to create your own reports, using the application ENQUIRY in T24. An
enquiry is a query that is executed to fetch data from the database and display the
results in a user defined format
In technical terms, an enquiry is a ‘SELECT’ executed in order to fetch data from T24
and the results displayed in a user defined format
CUS-Introduction to Enquiry 4
1.You can view data by specifying the LIST (L) function from the command line of the
browser.
2. The example shows CUSTOMER data when you use the LIST (L) function.
CUS-Introduction to Enquiry 5
This task teaches you to create a simple enquiry. The requirement for the task
is as follows,
Note: When discussing the use of fields in the ENQUIRY application, only
RELEVANT fields are discussed and displayed in the screenshots.
CUS-Introduction to Enquiry 6
To create an enquiry in T24, you must create a record in the ENQUIRY application.
The ID for your enquiry can be any meaningful alphanumeric text. The only special
character allowed is ‘.’. You will now learn how to use the fields involved in creating a
simple enquiry in T24.
Before designing an enquiry, you must decide on the page layout. Does your report
have a header? How many lines can be displayed per page of the report? The first
field PAGE.SIZE allows you to do this. You will specify the number of lines for the
header and number of lines for the body of the report separated by a comma. In this
example four lines are allocated for the header and nineteen lines are allocated for the
report.
The whole idea about creating an enquiry is to extract data from a particular
application in T24. The name of the application must be specified in the field
FILE.NAME. In the example you are creating an enquiry for the CUSTOMER
application.
Each column in the report is an extracted field from the application. Each column must
have a header that represents what data is being displayed. This header is mentioned
in the field FIELD.NAME. The OPEARATION field holds the actual field name from the
application that must be displayed.
Tip: If you specify the actual field name from the STANDARD.SELECTION in the field
FIELD.NAME, this value is defaulted in the OPERATION field too. This saves you
some time during enquiry creation.
CUS-Introduction to Enquiry 7
Now that you have specified the contents of the column, where do you want the field to
be displayed in the report ? You specify the order for the fields in the COLUMN field.
The first field @ID is displayed in column one. If left blank, the column will not be
displayed as part of the report.
Note: Columns must be specified in order to display the values. Columns must always
be specified in the correct order, meaning from left to right. The ENQUIRY application
cannot display the output correctly if the columns are all mixed up.
Tip: The values 1,2,3.. are sufficient for the ENQUIRY application to display values in
the browser. For the enquiry to work in the CUI mode as well, you must put the exact
spacing between the columns. For example, 5, 25, 45, 60 and so on.
CUS-Introduction to Enquiry 8
Also specify the field name and order for the last two fields NATIONALITY and
RESIDENCE.
Value for the LENGTH.MASK field is defaulted by T24. You can adjust the length and
justification of the field using the LENGTH.MASK field . Also the value in the field
SINGLE.MULTI is defaulted by T24 depending on the nature of the field. This field can
hold the value S or M.
CUS-Introduction to Enquiry 9
1. All enquiry records created must be authorised. Now how do you view the output of
an enquiry? You must execute the enquiry. To execute it use the command ENQ
followed by the enquiry (name) ID in the command prompt. ENQ is an abbreviation of
the application ENQUIRY.SELECT.
What do you think your enquiry will display? The 5 fields mentioned for all records in
the CUSTOMER application, page by page. That is, by default, any enquiry is T24
displays all records from the application the enquiry is based on. Now what if you don’t
want to see all records - consider a scenario where you want to view all customer
records with SECTOR as 1000. Now where will you specify this selection criteria?
2. When you execute the enquiry, a Dynamic Selection Criteria box appears. This
allows you to specify run time selection criteria based on all fields of the application the
enquiry is based on. You may specify one or more conditions in the selection criteria
box to filter out specific records from the database. The format of the criteria is
<Fieldname> <Logical Operand> <Value>. When you specify multiple conditions,
there is a logical AND between them. Then click on the Find button to execute your
enquiry. You will see that you can specify a selection criteria on any field of the
CUSTOMER application. The list of fields displayed here matches the list of fields in
the STANDARD.SELECTION record for the CUSTOMER application.
3.The enquiry result may consist of more than one page of results depending upon the
number of records selected and the page size of the enquiry. You can use the
Previous Page and the Next Page buttons to navigate between the pages.
CUS-Introduction to Enquiry 10
This is the workshop section of the learning unit.
CUS-Introduction to Enquiry 11
This task will teach you how to use the runtime selection criteria box when executing
the enquiry. The requirement for the task is as follows,
1.Create an Enquiry based on the CUSTOMER application in T24 which lists the
following fields - @ID (Customer ID), MNEMONIC, SECTOR, and NATIONALITY
2.Execute the Enquiry to generate the report of customers who belong to SECTOR
(One thousand and one) 1001.
CUS-Introduction to Enquiry 12
Using the details from the previous slide, the enquiry you will create will look like this.
CUS-Introduction to Enquiry 13
1.In the dynamic selection criteria box you can specify conditions for the various fields
and then “Find” the records that match the criteria.
2.Another way of doing this is to use the command line itself while executing the
enquiry itself.
ENQ TRG.ENQ.CUST.DETAILS SECTOR EQ 1001
Here the selection criteria is appended along with the execution request itself.
What will you do if you want to specify the same condition the next time when you
execute the enquiry?
You can use the following command to use the last specified condition,
The keyword word “LAST” instructs the system to use the last selection criteria used.
CUS-Introduction to Enquiry 14
Your enquiry report can have headers. The report shown in this slide displays headers
at the beginning of the output. This task aims at teaching you how to display headers
in an enquiry output. The requirement for the task is as follows,
1,2. Create a report based on the CUSTOMER application in T24 which lists the
following fields @ID (Customer ID), MNEMONIC, SECTOR, NATIONALITY and
RESIDENCE. The header for the first column displayed needs to be ‘Customer Code’.
The enquiry report will have two lines of headers displayed one below the other,
‘Temenos Training’ and ‘Customer Details’ are the two headers.
CUS-Introduction to Enquiry 15
Two header lines need to be displayed. You will see that by using the same FIELD.NAME
multi-value set, you can display header lines. One thing to remember here is that the
actual text displayed as header is specified in the OPERATION field. The value specified
in FIELD.NAME is not the one which is displayed.
Specify the first line of the header as “Temenos Training” . The text to be displayed as
header should be enclosed within quotes.
Value for LENGTH.MASK field is defaulted by T24, yet it can be modified for display
purpose.
SECTION - It is not sufficient just to specify the row and column details. You must also
use the field SECTION. Set this to ‘HEADER’ for the text to be displayed in the header of
the enquiry output.
CUS5 Introduction
CUS-Introduction to to Enquiry-R12.03
Enquiry 16
You also need to display “Customer Code” as the header for the @ID field. How do
you display the header for the @ID field ?
FIELD.LBL - Header for a field is specified in the field FIELD.LBL . Header for the @ID
field is specified in FIELD.LBL as ‘Customer Code’. If this field is left blank, value in
FIELD.NAME field will be defaulted.
Authorise your enquiry record and execute to view the results. Ensure that you specify
COLUMN value for all the fields.
CUS-Introduction to Enquiry 17
In R7, header is specified in a different manner. The header is specified in the field
called HEADER. As the HEADER is a Language specific field it allows you to display
headers in different languages. Multiple lines of headings should be specified as sub-
values of HEADER not multi-values. Multi-values are used for headings in a foreign
language. The syntax is @(Column, Line) Temenos Training. Temenos Training is the
header to be displayed.
CUS-Introduction to Enquiry 18
On execution of the enquiry, the two headers ‘Temenos Training’ and ‘Customer
Details’ are displayed .
CUS-Introduction to Enquiry 19
1. Amend workshop one to include the following heading Temenos Training and
Default Loan List
2. The column heading for the loan account number field needs to be ‘Loan Id’.
Refer : Enq-WS2_demo.cp
CUS-Introduction to Enquiry 20
This task teaches you to specify fixed selections and dynamic selection
criteria in enquiries. Consider a scenario where a bank decides to provide an
offer for the US customers who belong to a particular SECTOR .The SECTOR
is specified at run time. How will you create an enquiry for the given
requirement?
4. The Value for the field SECTOR need to be obtained from the user at
run time. Make this as a mandatory input.
CUS-Introduction to Enquiry 21
Your enquiry must only display customers whose NATIONALITY is US. This selection
criteria is fixed at design time using the FIXED.SELECTION field in the ENQUIRY
application. You can specify multiple fixed conditions if required. There is a logical
AND between them. This is the primary condition which will be invoked when you
execute the enquiry. This cannot be modified during execution.
SECTOR is the dynamic selection criteria that must be specified when executing the
enquiry. SECTOR will be part of the list of fields in the dynamic selection box. But we
cannot ensure that the user will enter a criteria before clicking the ‘Find’ button. But the
requirement is to make it mandatory at lunch time. Do you think you can set this up?
CUS-Introduction to Enquiry 22
To make a dynamic selection criteria mandatory, you must use a new set of fields in
the ENQUIRY application. You must specify SECTOR in the field SELECTION.FLDS.
If you want to change the label of the field that is displayed in the dynamic selection
criteria, you can use SEL.LABEL. This multi-value set also allows you to hard-code the
operand to be used in the dynamic selection criteria using the SEL.FLD.OPER
(Selection Field Operand) Multiple operands can be given ,delimited by space. EQ
stands for Equal to. You will get SECTOR field displayed in the Dynamic Selection
Criteria box but how do you make SECTOR as a mandatory selection criteria? When
the field REQUIRED.SEL is checked it makes the field mandatory at runtime. You will
not be allowed to execute the enquiry unless you specify a value for SECTOR.
When you first saw the dynamic selection criteria box, you noted that all fields of the
application were displayed. When you use this multi-value set in the ENQUIRY
application, only the fields defined here are displayed during run-time. If this multi-
value set is not used, the dynamic selection box lists all fields.
CUS-Introduction to Enquiry 23
1. When you execute the enquiry, the Dynamic Selection Criteria box is displayed. It
looks different from the ones you have seen before.
2. You can see customer records with NATIONALITY as US and SECTOR as three
thousand five hundred and five.
CUS-Introduction to Enquiry 24
1. Amend the enquiry created to list only those loan accounts that have an amount
greater than 10000.
2. Value for the field Currency should be obtained from the user at run time
CUS-Introduction to Enquiry 25
In the previous task you learned to specify a fixed selection condition in an enquiry.
Now you will learn to specify multiple fixed and dynamic selection conditions .You are
required to create an enquiry that will list the Customers whose NATIONALITY or
RESIDENCE is US. The enquiry should also only retrieve customer records that
belong to SECTOR one thousand (1000) or one thousand one(1001).
CUS-Introduction to Enquiry 26
You may often need to specify multiple conditions in the enquiry that you create. How
do you link these conditions together? The multiple conditions can be grouped using
the relational operators , ‘AND’ or ‘OR’. The given requirement states two dynamic
selections and two fixed selections .
The other task is to select customer records that has RESIDENCE or NATIONALITY
as US. These are the dynamic conditions of your enquiry.
How do you relate the two dynamic conditions? You need records that has either
NATIONALITY or RESIDENCE as US. Therefore relate the two conditions using the
‘OR’ operator. This is specified in the field called REL.NEXT.FIELD. The
REL.NEXT.FIELD provides two options namely AND , OR. Dynamic Selection Fields
form a multi value set. By default all the dynamic selection conditions work with the
AND operator. However you may also use the OR operand to group the dynamic
selection conditions.
Specify the other required fields and authorise the enquiry record.
CUS-Introduction to Enquiry 27
1. When you launch the enquiry, it pops up a Selection Criteria box. This Selection
Criteria box forces the user to enter values for RESIDENCE and NATIONALITY at
run time. Enter the values for these fields and execute the enquiry to view the
output.
2. You can see the sample output of your enquiry. The enquiry output displays
customers who either belong to SECTOR 1000 or 1001.
CUS-Introduction to Enquiry 28
In the previous task with multiple selection criteria, selection criteria input to both
residence and nationality was mandatory. This is because the mandatory selection
criteria fields were frozen at design time using the REQUIRED.SEL field. The field
NO.MANDATORY.SELECTION works in conjunction with SELECTION.FLDS and
allows the end user to pick the selection criteria fields for mandatory input at run time,
instead of design time.
CUS-Introduction to Enquiry 29
NO.MANDATORY.SELECTION - Enter the minimum count of selection fields for
which runtime input is mandatory, in this field. The fields
NO.MANDATORY.SELECTION and REQUIRED.SEL are mutually exclusive. Either
the specific mandatory selection fields can be frozen at design time using
REQUIRED.SEL field or the number of fields which require mandatory input at runtime
can be specified using NO.MANDATORY.SELECTION field. The
NO.MANDATORY.SELECTION field value must be at least one less than the total
SELECTION.FLDS count.
When the enquiry is launched, the selection criteria window displays the selection
fields and the expected number of mandatory selection criteria input. End user is
given the flexibility to choose the field / fields to input selection criteria at runtime.
Input is mandatory for the number of selection fields specified in
NO.MANDATORY.SELECTION field. Breaching the number of mandatory selection
fields specified in the field NO.MANDATORY.SELECTION will not fetch the records for
display.
CUS-Introduction to Enquiry 30
1. Amend the enquiry to ensure data that meets the following condition alone is
retrieved from the database.
2. Either the value for currency has to be supplied or the value for interest rate
has to be supplied And
CUS-Introduction to Enquiry 31
In this task you will learn to sort the records in an enquiry.
CUS-Introduction to Enquiry 32
You need to sort records in the descending order of their AMOUNT. To do so you will
use the field FIXED.SORT field in the ENQUIRY application
FIXED.SORT- This field is used to specify fixed sorts for enquiry. Specify the name of
the field that has to be sorted. By default the system sorts in ascending order. To sort
the records in descending order specify DSND along with the field name.
CUS-Introduction to Enquiry 33
This is a screen shot of the remaining fields to be displayed.
CUS-Introduction to Enquiry 34
On execution you will see the output with the field AMOUNT sorted in the descending
order.
CUS-Introduction to Enquiry 35
1. T24 provides built-in Enquiries. The naming convention for these Enquiries are
%Application name.
1.1 Some of the built-in Enquiries are %ACCOUNT,%CUSTOMER, and
%FUNDS.TRANSFER etc.
2. When you execute the LIST (L) function on the command line , internally the T24
system invokes the built-in Enquiry of T24.
CUS-Introduction to Enquiry 36
1. The application EB.SELECTION.FAVOURITES can be utilized by the user and
system administrators. This is to save specific enquiries based on selection criteria
as favourite enquiries.
2. Depending on the structure of the record ID these saved records can be system
wide (available to everyone) or for specific users.
CUS-Introduction to Enquiry 37
The following is a typical USER specific EB.SELECTION.FAVOURITES record with
the ID defined in the format ENQUIRY*USER.ID, where ENQUIRY is a valid T24
enquiry.
Specify the required selection criteria and the Name for your favourite in this record. In
the above illustration (CATEG 1001 USD) and (CATEG 5001 GBP) are the 2 named
favourites.
CUS-Introduction to Enquiry 38
When the user (Authoriser) logs into the system, these enquiry favourites are available
under the headings CATEG 1001 USD and CATEG 5001 GBP as shown.
CUS-Introduction to Enquiry 39
The user can also create favourites when an ENQUIRY is launched.
As an illustration, launch the default enquiry for customer security using the command
ENQ %CUSTOMER.SECURITY.
A prompt is displayed asking the user to key in a name for your favaourite. Eg.
Depositories in our case.
CUS-Introduction to Enquiry 40
Once you give the name for your favourite you can see it listed in Favorites for that
particular user.
CUS-Introduction to Enquiry 41
A system wide favourite can be created with Record ID with an valid T24 Enquiry
Name without attaching a USER id to it. Eg. ACCT.BAL.TODAY.
Now what is the difference between a User specific favaourite and a system wide
favourite ?
The system wide favourite is available for all T24 users who launch that specific
enquiry whereas a User specific favourite appears only for that specific user and not
for others.
CUS-Introduction to Enquiry 42
In the above screenshot AUTHORISER tries to launch the ACCT.BAL.TODAY
enquiry. As you can see both the system wide as well as the user specific favourite is
made available for that user.
A user specific favourite can be deleted by clicking on the favourite image shown with
a (-) sign. An important information that we need to understand here is that a system
wide favourite cannot be deleted by a normal user.
CUS-Introduction to Enquiry 43
1. False
2. True
3. False
4. True
5. False
CUS-Introduction to Enquiry 44
1. Enquiry is a query you ask T24 about the data it has stored.
4. Ensure that you specify COLUMN values for all the fields in your enquiry.
CUS-Introduction to Enquiry 45
You can now explain about Enquiries in T24. You can also create simple enquiries that
will fetch data from T24.
CUS-Introduction to Enquiry 46
ENQUIRY application in T24 displays data in various interesting formats. These
graphical representation gives a better interpretation of the of the data in T24.
CUS-Introduction to Enquiry 47
CUS-Introduction to Enquiry 48