Services in T24

Download as pdf or txt
Download as pdf or txt
You are on page 1of 27

8/11/2019 A_SER1[1].Services In T24-R10.01.

pdf

1. Welcome to the “Services In T24” learning unit. This learning unit will help you to
un erstan t e concept o serv ces n .

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
1/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

After completing this learning unit/course, you will be able to:

•Differentiate between Phantoms and Services in T24


•Understand how a service works

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
2/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Many software in the market, have processes that need to be run without user intervention.
e processes may vary rom s mp e o s o ac ng up stor ca ata to c ear ng o
temporary files or as important as interacting with interfaces to another system. These
processes may be required executed once a day or may be required to be executed
continuously for a period of time. T24 is no different and also has a number of these
background processes.

In the T24 releases prior to R05, these were called Phantoms.

They were subroutines created in jBASE BASIC using T24 APIs if required and could be
executed once or in an infinite loop until manually stopped.

This was handled via an application called EB.PHANTOM. This application was used to start
and stop the processes.

With the introduction of multi threaded programming in release R05, this application can not
be used if the background process is multi threaded.

This application is not obsolete and can still be used if required.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
3/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1.Services are also background processes in T24. But they are multi threaded.

2.They too can be executed just once or in an infinite loop until manually stopped.

3.Services are controlled using an application called TSA.SERVICE

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
4/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1 A service must be multi threaded, otherwise it must be run as a phantom. A multi threaded
rout ne cons sts o t e o owng components. rout ne to oa common var a es
used in the subroutine, a SELECT routine to select the Ids to be processed, a record routine
which contains the logic to process each id selected and finally an insert file defined for the
routine.

2 Each multi threaded routine in T24 must have a PGM.FILE entry with TYPE = B which
stands for BATCH.

3 Each B type routine has an entry in the BATCH application, and a service is no different. A
service could be made up of one multi threaded routine or multiple routines that must be run
in an order. You will use the BATCH record to define this order using the JOB field. The
BATCH record that you will create will NOT have a BATCH.STAGE defined as this record
must NOT be picked up during COB.

4 Finally, you must create a record in the application TSA.SERVICE. The ID of the record
must match the BATCH record Id. Why is this? – This is because when you start off a
service, T24 looks for a record in the BATCH application and then finds out which routine it
must execute in the background.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 5/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 6/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

TSA.SERVICE is the application where all services are defined and controlled by the end
user.

ID: The id of the service record must match a record in the BATCH application.

DESCRIPTION : This field holds the description of what the service is used for.
SERVER NAME : This field holds the IP address or the host name of the server where the
current service needs to be executed. This will be used on in a multi application server
architecture.
The whole idea behind a service is that you will have multiple copies of the process running
so that the load can be shared. How many such copies do you want running? That is defined
in the field WORK PROFILE. This field holds the ID of the record in
TSA.WORKLOAD.PROFILE application which defines the number of copies that will
actually execute.
USER : This field should hold a valid T24 user name, whose details are used to update the
audit fields of records that get created or updated by the service.

SERVICE
can be set CONTROL : This
in this field to stopfield
the can holdwhen
service threeitvalues – AUTO, START and STOP. STOP
is executing.
You will learn about the other fields in the next few slides.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
7/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1. With the advent of multi threading in T24, two new programs (they are not subroutines)
ave een co e to execute serv c es. ey are t an t .

2. tSM is stands for T24 Service Manager and tSA stands for T24 Service Agent

3. The tSA program is in charge of actually executing the service(s). Each copy of the
program executed, in turn executes one copy of the assigned service.

4. Since multiple copies of the tSA program can execute – only ONE tSM program executes
to take care of the entire situation.

You will now see how a service is executed so that this slide makes more sense.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 8/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

You must first turn the service on using the SERVICE.CONTROL field in TSA.SERVICE.
s c ange must e aut or se . ou must remem er t at t s act on oes not start o t e
service in the background. Its only a flag to say that the service will be picked up and
executed.

You must then


will cause start the
all service tSM program.
records This
with either can be
START or done
AUTOonly from
to be the jBASE
picked prompt.
up to be This
started.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 9/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Start the tSM by using START.TSM at the jBASE shell prompt. You have two options when
start ng t e t – to start t n mo e or to eave out t e opt on.

The DEBUG option allows you to manually start tSA’s to execute your service. In the screen
shot above, OFS.MESSAGE.SERVICE has one tSA assigned to it, but SW IFT.OUT has

two. How is this possible?

When defining a service in TSA.SERVICE, the field WORK.PROFILE links to an application


TSA.WORKLOAD.PROFILE where you can define how many tSA’s are required. Each tSA
represents one copy of your multi threaded service being executed.

Now in the screen shot above, you must understand that the services have not been started
as yet.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 10/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

TSA.WORKLOAD.PROFILE is the application which defines the number of tSAs required.


.

The number of agents in TSA.WORKLOAD.PROFILE can be set based on time if required.


TIME and AGENTS.REQUIRED : These fields are associated multi value set which holds
the specific time and the number of agents required at that point in time.

The number of agents that can run on server is directly proportional to the number of
processors available. Just because T24 supports multi threaded services doesn’t mean you
can start a 100 tSA’s in the background. It will kill the server. The thumb rule to be followed
is a maximum or 2 tSA’s per processor available.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
11/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

After the agents are assigned jobs, in DEBUG mode, type tSA <agent number> at the
s e prompt to actua y start t e agents to t e serv ce. ter t e o s n s e
successfully, a message ‘Agent Stopped’ will be displayed and the cursor will go back to
 jBASE shell prompt.
When a service stops, the field SERVICE.CONTROL is set to STOP automatically.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
12/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Services can be configured as a periodic activity using the FREQUENCY field. This field
o s a va ue n t e o rmat
Date Time Frequency- where,
Date is the system date which is entered in T24 date format
Time is entered in the format HH:MM(T24 hour format)
Frequency is entered in the format 1D,2D etc.,
EXAMPLE : 20100215 14:00 1D

TSM would normally build the service profile only for the services which are set to START or
AUTO. But when the frequency is specified for the service and SERVICE.CONTROL is set
as ‘STOP’, the TSM would check whether the specified frequency has been reached taking
into account the time as well as frequency and would start the service. When the service is
stopped, the frequency would be cycled to the next date. This field is not allowed for an
AUTO service. The service control cannot be changed if the frequency is present. This is
mostly using for archiving.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 13/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1. To configure services as a periodic activity, input a date, time and frequency when the
serv ce as to e starte n t e correspon ng . recor . ote t at t e serv ce
control for the service PW.MAPPING is set to stop. The frequency configured for
PW.MAPPING service is 20100216 11:35. The TSM has been started in interactive mode.
The time when the TSM is started is 11:32 on 16th Feb.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
14/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

TSM builds the service profile for all services with service control set to ‘STOP’ and which
ave a ‘ set. nce t e t me as spec e n t e requency e o t e serv ce
has been reached, TSM automatically sets the service control for the service to ‘START’ and
prompts the user to launch the required agents for the service(in DEBUG mode). Once the
service has stopped, the service control for the service is set back to ‘STOP’ and the
FREQUENCY gets cycled.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
15/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

After the agents actually start performing the service, if you wish you have a look at the
status o t e agents, an app cat on . can e use . you st t s app cat on, a
the services that are to be executed by the agents will be displayed. The ID of the record in
this will be the agent number.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
16/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

You know tSM launches and controls the tSAs. How does an end user know what is
appen ng w t t e t s se t e enqu ry .

Agent ID is the allocated Agent Number for the service

T24.SESSION.NO is updated with a unique number that identifies every session in T24. A
number between 1 -99999 is allocated when a session is started in a port to uniquely identify
that particular session in T24(both for online and COB).
Note: This random number is generated using a routine called
EB.ALLOCATE.SESSION.NUMBER and is stored in a common variable called
C$T24.SESSION.NO. This helps in improving the monitoring capabilities of T24.
A live file called T24.SESSION gets updated with record key being the T24.SESSION.NO
and contains information regarding the agent to which this session number was assigned. A
record in this application gets deleted, when the corresponding process terminates(session
expires).

Server Name is the name of the server where the agent is running. Note that details of tSAs
and tSMs across application servers will be updated here

COB1.Close Of Business - Introduction-R10.01


http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 17/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Slide 17

s1 The AGENT.STATUS enquiry output has been split into three screen shots as it elapses the screen. Some
of the fields are explained in this slide and the remaining are explained in the next slide.
salamelu, 2010/02/23

http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 18/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Agent Status is the status of the agent. It can hold either of the three values.
RUNNING – Agent performing the job
STOPPED – Agent has stopped properly.
DEAD – Agent did not report within the time given and hence the tSM has marked the

agent as DEAD

Process Id is the Operating system level process ID for the agent process that is running

Current Service is the service the agent is performing at the moment. Note agent 1 is
performing the service TSM and the others are performing the service COB

Next Service is the service the agent is supposed to perform next. W hile COB is running, if
you wish to stop COB, set the field SERVICE.CONTROL to STOP for the record COB in the
TSA.SERVICE file. Then, check the NEXT.SERVICE value for the agents running COB, it
will be set to STOP denoting that the agents needs to stop once they complete the current
transaction

Job Progress is the status of the jobs being performed. Details of the status is not in the
scope of this learning unit.

COB1.Close Of Business - Introduction-R10.01


http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
19/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Slide 18

s2 This slide is hidden in the slide show, it is present only for the notes page information
salamelu, 2010/02/23

http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 20/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

Last Message is the message displayed by the agents as they are performing the jobs. The
agent runn ng t w not sp ay any message as t s ust mon tor ng agents.

Como Name is the name of the log record ID that holds the log information of the agent.
These log records are stored in a directory called &COMO&. The contents of these records
cannot be viewed from browser. You will have to open these records at the jBASE prompt.
The log file name is in the format ‘tSA_<agent number>_<date>_<time>’
LAST.MESSAGE is the message displayed by the agents as they are performing the jobs.
The agent running tSM will not display any message as it is just monitoring agents.
COMO.NAME holds the name of the log file that has the log information of the particular
agent.
JOB.PROGRESS holds the status of the jobs being performed.

COB1.Close Of Business - Introduction-R10.01


http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 21/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

COMO.NAME in AGENT.STATUS holds the name of the log file. Log files are stored under
. ‘ ’.
command ‘JED &COMO& <Log file name>’ to view the contents of the log file.
If an agent is restarted, there will be two log files for that agent as the log file ID is based on
date and time. Log files do not get cleared automatically from the &COMO&.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
22/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

When multiple application servers are part on the T24 architecture, all processors can be
ma e use o w en execut ng serv ces. ne t must e starte on eac server an t e
tSA’s started appropriately.

You must remember that data resides centrally – so in the TSA.SERVICE record, you will

need to specifymulti-value
corresponding a workloadfields.
profile for each server and also mention the server names in the

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
23/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1. An activation file is a file in the backend that contains all the ID’s to be processed by the
serv ce. nce an s processe rom t e act vat on e, t s remove rom t ere

2. Since we have populated the file with the ids that the service needs to process, there is
no need for a SELECT routine separately

3. For a service to use an activation file, it should be mentioned in the PGM.FILE entry for
the job that is running as a service. The field Activation File should be set to “YES” or
the name of the activation file. If you choose the option as yes, then the name of the
activation file will be F.<SERVICE.NAME>.LIST
For eg: BNK/SWIFT.OUT, runs DE.OUTWARD job as a service. Now, as you can see
in the screenshot, the field ACTIVATION.FILE has been set to yes.

Q. Based on what you learnt just now, what would be the name of the activation file?
A. F.SWIFT.OUT.LIST (the BNK part is not included)

NOTE: When you start a service by setting the SERVICE.CONTROL field to “START” in
the TSA.SERVICE record of that service, you would expect the service to run once and
then stop. This is not the case for services having activation files. When a particular
service has an activation file, it keeps running even if the SERVICE.CONTROL field is
set to “START”.

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
24/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

1. FALSE – Single Threaded mode


2. FALSE – Each server should have one tSM running
3. TRUE
4. FALSE – TSA.STATUS
5. TRUE
6. FALSE – TSA.STATUS

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
25/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

You will now be able to:

•Differentiate between Phantoms and Services


•Explain the working of Services in T24

SER1.Services In T24-R10.01
http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf
 
26/27
8/11/2019 A_SER1[1].Services In T24-R10.01.pdf

http://slidepdf.com/reader/full/aser11services-in-t24-r1001pdf 27/27

You might also like