CAPITAL MARKET OPERATIONS

CIRCULAR

Circular No.: NSE/CMO/039/2008

Download No. NSE/CMTR/11183
Date: August 26, 2008

Dear Members,

Sub: Trading Access Point (TAP New Version 3.1 for IP connectivity)

The Exchange has released new version for TAP (Version 3.1 for IP connectivity). Members are
required to set up TAP Box using the TAP Version 3.1 by configuring the TAP Box ID allotted to
them. The integrated TAP Version 3.1 (Executable file “TAP_3.1_Setup.exe”) has been placed in NSE
EXTRANET (/common/TAP3.1) for setting up TAP server.

Members are advised to read the following User reference manual:

Annexure I: TAP User Manual Version 3.1

In case of technical queries, members are advised to contact helpdesk no: 022-26567500.

For any clarifications, members are advised to contact the following officials:
Mr.Sunil Gawde & Mr. Khushal Shah, on 26598156 / 26598153 / 26598157.

For and on behalf of

National Stock Exchange of India Ltd.

Suprabhat Lala
Assistant Vice President – CM Trade
 ANNEXURE I
TAP User Manual
Version 3.1

User’s
Guide
Copyright
Handle this document carefully for it contains material protected by
international copyright law. Any reproduction, full or in part, of this
material is prohibited, without the express written permission of the
company. Any reproduction of this document with permission shall be
marked with the year of copyright as follows.

All Rights Reserved. Copyright © 2007 by NSE

All other brand names appearing in this manual are the trademarks of
their respective holders.

Product Changes
NSEIL reserves the rights to change, update, or make obsolete the
name of the manual at any time without prior notice.

Please direct all queries regarding the products covered herein to the
company.

Trademarks
All brand and product names referred herein are for identification
purposes only and may be trademarks or registered trademarks that
are the sole property of their respective owners.

Disclaimer
This guide has been validated and reviewed for accuracy. The
instructions and descriptions it contains are accurate for TAP.
However, succeeding versions and guides are subject to change
without notice. NSE assumes no liability for damages incurred
directly or indirectly from errors, omissions or discrepancies
between the software and the guide.
Contents
About this Guide................................................................v
Purpose of This Guide.....................................................................v
Who Should Read This Guide..........................................................v
How to Get In Touch.......................................................................v
Getting Started.................................................................vi
What is TAP?...................................................................................7
TAP Installation / Uninstallation..........................................7
Configuring TAP.................................................................8
TAP Monitoring Service......................................................8
What is TAP Monitoring Service?.....................................................9
TAP Data Gathering Utility (TAP DGU).................................9
What is TAP DGU?.........................................................................10
Working of TAP DGU.....................................................................10
TAP Repository Management System (TAP RMS)................12
What is TAP RMS?.........................................................................13
Working of TAP RMS......................................................................13
TAP Statistics .................................................................14
What is TAP Statistics?..................................................................15
Working of TAP Statistics..............................................................15
About this Guide
PURPOSE OF THIS GUIDE
This guide will provide the information about TAP,
installation and configuration of TAP.

WHO SHOULD READ THIS GUIDE

This guide is useful for anyone who is going to install,
configure and use the TAP application.

HOW TO GET IN TOUCH

The following sections provide information on how to
obtain support for the documentation and the software.

Documentation Support
NSE welcomes your comments and suggestions on the
quality and usefulness of this document. For any questions,
comments, or suggestions on the documentation, you can
contact us at:
National Stock Exchange of India Limited,
Exchange Plaza,
Block G,
Bandra-Kurla Complex,
Bandra (East).
Mumbai - 400 051
Tel - 26598100

Customer Support
If you have any problems, questions, comments, or
suggestions regarding, TAP and its sub systems, contact us
at the address mentioned above. While contacting
customer support, have the following information ready:
Your name, E-mail address, phone number, and fax
number
1. The type of hardware, including the server configuration and network
hardware if available
2. The version of TAP.
3. The name and version of the operating system
4. The exact message that appeared when the problem occurred or any
other error messages that appeared on your screen
N S E T A P U S E R ’ S G U I D E

1
Chapter

5. A description of how you tried to solve the problem

Getting Started
In this chapter, you will learn:

6. What is TAP?

TAP STATISTICS VI
WORKING OF TAP STATISTICS
 2
Chapter

WHAT IS TAP?

TAP (Trading Access Point) is a real time system

which is introduced by The National Stock Exchange
of India to enhance the Trading System by changing
existing 2-tier system to 3-tier system. TAP is an
application which is placed between Front-End and
Host End so that all the communication between
front-end and host-end will be through this TAP
Application.

TAP Installation / Uninstallation

N S E T A P U S E R ’ S G U I D E

3
4
Chapter

7. Please refer the following document (TAP Setup Manual) for details
about TAP installation/un-installation.

TAP Setup Manual

TAP version 3.1

Setup Manual.doc

Configuring TAP

• TAP application can be configured using TAP configuring and Monitoring

System (TCMS). Please refer the following document (TCMS User Manual) for
details about configuring TAP. TCMS User Manual also provides details for using
additional features.

TCMS User Manual

TAP Monitoring Service

In this chapter, you will learn:

8. What is ‘TAP Monitoring Service’?

TAP STATISTICS 8
WORKING OF TAP STATISTICS
 5
Chapter

2
WHAT IS TAP MONITORING SERVICE?

After successful installation of the TAP the TAP

Service icon is created on the desktop. This service is
used to monitor the TAP application continuously and
keep the TAP application in running state.
When TAP is started by double clicking ‘TAP Service’
icon on the desktop, OR by starting TAP service in
the ‘Services’ panel, TAP monitoring service is
invoked internally. This monitoring service then
invokes TAP application. The service then keeps on
monitoring TAP application continuously.

TAP monitoring service can be terminated manually

by stopping ‘TAP’ service through the ‘Services’
panel. When TAP monitoring service is stopped, it
also terminates all the instances of the TAP
application.

TAP Data Gathering Utility (TAP DGU)

In this chapter, you will learn how
to:

9. What is TAP DGU?

10. Working of TAP DGU
WHAT IS TAP DGU?
DGU stands for Data Gathering Utility. This tool is
used to collect all the information related to TAP
application. This information will be stored together in
a zipped file, placed on the desktop where the TAP
application resides. The NSE Help Desk might ask the
member to run this tool and mail the file, in case of
any TAP related problems.

WORKING OF TAP DGU

As mentioned above, this tool will be used to collect all the
information related to TAP application. The tool should be
executed by the member only when he wants to send the
logs of TAP application to the NSE Help Desk in case of any
TAP related problem. This information will be useful for the
NSE Help Desk to find out the exact nature of the problem
and consequently help the broker to solve it.
The tool will collect the following information:-
11. Log files of the TAP application and all other
associated tools for the current day.
12. Registry information about TAP application
and TCP Parameters.
13. System information.
14. Event logs of the system.
15. Network statistics.

The member can execute this tool by clicking

Start->Programs->TAP->Troubleshoot

A zip file will be created on the desktop, its name being

in the following format:

TAP_ANALYSIS_<YYYYMMDD_HR24MINSEC>.zip

The member has to just mail this zip file to the NSE Help
Desk.
TAP STATISTICS 11
WORKING OF TAP STATISTICS
 6
Chapter

2
TAP Repository Management System (TAP RMS)
In this chapter, you will learn how to:

16. What is TAP RMS?

17. Working of TAP RMS

ATISTICS 12
G OF TAP STATISTICS
 WHAT IS TAP RMS?
RMS stands for Repository Management System. This system is
used to manage the logs of TAP.

WORKING OF TAP RMS

As mentioned above this system will automatically run everyday at 4 A.M.
for the purpose of managing the logs of the TAP application. If the
machine on which TAP application is running is shut down, the Repository
Management System detects date change for the following day and
manages the logs accordingly.
If log files are present in the LOGS folder, it creates a separate directory in
REPOSITORY directory. The name of the directory is derived from the date
of logs. It then moves the log files to the newly created directory and
compresses them.
For each day when logs are created, RMS creates a new directory in
REPOSITORY directory. When number of date-wise directories in
REPOSITORY directory reaches above ‘Repository Management(in
days)’ value, RMS deletes the least recent folders from REPOSITORY
directory so that total number of folders in REPOSITORY directory is
always maintained up to Repository Management(in days)’ value.
E.g. if we want to keep previous 25 log directories max in REPOSITORY
folder, then change the value of Repository Management(in days)’ to
25. So that it will keep previous 25 logs directories in the REPOSITORY
folder.

ATISTICS 13
G OF TAP STATISTICS
 7
Chapter

TAP Statistics
In this chapter, you will learn how to:

18. What is TAP Statistics?

19. Working of TAP Statistics

ATISTICS 14
G OF TAP STATISTICS
 WHAT IS TAP STATISTICS?
TAP Statistics is used to generate real time and offline statistical
data of TAP. The real time statistics include system parameters.
TCMS UI shows real time system parameters for individual TAP executable of
the market segment. It also shows the common system parameters in the common tab
of the TCMS UI.

WORKING OF TAP STATISTICS

TAP statistics module runs automatically after every 30 seconds and it
fetches real time data for every market segment. It fetches the following
data:
1. Tap CPU utilization.
2. TAP Virtual memory.
3. TAP working set size.

It also fetches system cpu usage, which is a common parameter for all
market segments. It is updated every 30 seconds in system_cpu file.
All the real time data is generated and stored in files under
<TAP_ROOT_DIR>\TAP_statistics\Online\Current Folder.
The latest data is displayed on TCMS UI on respective tabs as Parameter
name, value and Unit. Every time TAP is restarted all the files under.
<TAP_ROOT_DIR>\ TAP_statistics\Online\Current Folder are moved to
<TAP_ROOT_DIR>\ TAP_statistics\Online\Repository Folder

TAP STATISTICS module generates the end-of-day or offline market wise

statistics after market hours, every day at 5.P.M.
The end-of-day or offline statistics include
1. Packing efficiency.
2. Order rate per second.
Packing efficiency is calculated for the messages sent to trading system
and the responses received from trading system. It is calculated at
following points
1. Messages sent to Trading system.
The file format for the output is

ATISTICS 15
G OF TAP STATISTICS
 th_network_handler_thread_outgoing_<market>.<date>.<ti
me>.csv
2. Messages received from Trading system.
The file format for the output is
th_network_handler_thread_incomng_<market>.<date>.<ti
me>.csv

At all the points the system calculates Order rate (message rate). The
data is collected in two files, one containing all the messages with the
time stamp and the other containing the summary of the first one. The
summary includes the average order rate per second, average packet
rate, total packet count, total message count and packing efficiency. All
this data is stored in files under
<TAP_ROOT_DIR>\TAP_statistics\Offline\Current folder.

ATISTICS 16
G OF TAP STATISTICS