--- title: "GL Trade" description: "" url: "https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html" --- ## Introduction The Geneos GL Trade plugin monitors the GL system and displays information for each dataview. This document includes the dataviews and plugin configuration for GL Router plugin. **Note**  Beginning Geneos 6.0.x, all the [GL Trade plugins](https://docs.itrsgroup.com/docs/geneos/7.11.0/archive/collection/gl-trade-archived/index.html), except for GL Router, are no longer supported. ## GL Router The GL Router plugin monitors Users and Server connections to the GL P3 router process. ### Users View This view shows a daily history of user connections, Local and Remote, Current and Expired. ![gl-router0](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image0_geneos_-_gl-router_plug-in.png) **Users Headline Legend** **Users Table Legend**
Name Description
Total SLE users today
Cumulative daily total of SLE User connections.
(Requires entry in names.ini file to translate server name SLE).
maxConcurrentUsers Maximum number of concurrent users
Current SLE users
The number of user currently logged on to the SLE server.
(Requires entry in names.ini file to translate server name SLE).
Current SLC users
The number of user currently logged on to the SLC server.
(Requires entry in names.ini file to translate server name SLC).
Name Description
Key Unique User:Node:Subnode identifier.
userName
The name of the User.
(or the GL UserID if no translation entry is defined in the names section or the file specified by the namesFile section).
ipAddress The user's workstation IP Address.
logonTime The time that the user logged on to GL system.
logoffTime
The time that the user logged off from GL system.
(Blank if still logged on).
userType GL API or GL Win.
localRouter The router to which the user is directly connected.
remoteRouter
The router that connects the user to the market..
Same as local router if stand alone configuration (i.e. not across GL Net).
serverName
The name of the server.
(or the GL ServerID if no translation entry is defined in the names section or the file specified by the namesFile section).
RtrStatus The current status of the router.
SrvrStatus The current status of the Server
userid Actual GL Trade system IDs.
localRouterId Actual GL Trade system IDs.
remoteRouteID Actual GL Trade system IDs.
serverId Actual GL Trade system IDs.
### Summary View This view shows the current API and GL Win Users on SLE and SLC. **Note** The SLE and SLC servers must be defined in the names.ini file for a user connection to be counted. ![gl-router1](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image1_geneos_-_gl-router_plug-in.jpg) **Summary Table Legend**
Name Description
SLE Number of users/servers on SLE
SLC Number of users/servers on SLC
### Servers View This view shows the Router connections to the SLE and SLC servers, a relay type router (i.e. local P3 connect to broker's P3) shows the remote server connections ![gl-router2](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image2_geneos_-_gl-router_plug-in.jpg) **Servers Table Legend**
Name Description
Key Unique User:Node:Subnode identifier.
routerName The name of the Router. (or the GL RouterID if no translation entry is defined in the names section or the file specified by the namesFile section).
serverName The name of the Server (SLE or SLC) or the GL ServerID if no translation entry in names.ini file. Entries that show P3 or are blank, refer to the actual P3 status.
Connection Indicates either "Direct" or via "GL Net".
Status Server/Router status either "Up" or "Down".
uptime The time the Server/Router came up.
downtime The time the Server/Router went down.
routerID Actual GL Trade system IDs.
serverId Actual GL Trade system IDs.
### Connections View This view is only shown if value [p3v5IniFilename](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#p3v5IniFilename) is defined in the plugin configuration. **Note** This plugin uses the netstat command which is part of the net-tools package. The net-tools package is not included in the minimal RHEL7 installation by default. As a result, the net-tools package must be installed separately on a minimal RHEL7 installation in order for the plugin to work. ![gl-router3](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image3_geneos_-_gl-router_plug-in.jpg) **Connections Table Legend**
Name Description
Column1 Description1
Column2 Description2
### Plugin configuration The following parameters can be configured for this plugin: #### p3LogDir Specifies the full path to the GL directory for the P3 log files Mandatory: Yes #### names This section associates textual names with the IDs of the GL routers, GL Server processes (e.g. SLE, SLC, Selector) and GL users. It contains a [gl-names > servers](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#gl-names-servers) section, one or more [gl-names > users](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#gl-names-users) sections and an optional [gl-names > api-names](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#gl-names-api-names) section. #### namesFile This section specifies the path to a file containing the associations between textual names and GL router IDs. The format of this file is described in [Names.ini configuration](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#Names.ini-configuration). If the [names](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/gl-trade/index.html#names) section has been defined, then the data in the names section will be saved in the file specified in this section in the format described. Mandatory: No Default: "names.ini" #### apiNamesUnique By default, GL API application names are used as the unique session identifier. This means that when an api client loggs on and off and on again it will be shown as a single row, even when its GL user id changes with every new logon. If the API names are not unique , the above algorithm will cause multiple api clients to be shown as one row. To show each API client on a separate line, set ApiNameUnique to False in the Sampler Descriptor. **Note** The drawback of this is that every time an API client connects and disconnects a new line will be shown. Disconnected users can be set to auto clear after an interval defined by RemoveLoggedoffUsersInterval setting. Mandatory: No Default: True #### allowDuplicateUsers [Explanation paragraph 1] [Explanation paragraph 2...and so on] Mandatory: [Yes/No] Default: [Value] #### removeLoggedoffUsersInterval Disconnected users and API connections can be set to auto clear after the number of seconds defined by RemoveLoggedoffUsersInterval . When set to -1, the logged off users and API connections are not removed Mandatory: No Default: 43200 (- 12 hours) Units: seconds #### previousFiles > fileCount This is used for exchanges which are up 20 hours and where logins can persist across days. This informs the plugin how far back in time to look to find existing logins. (This would be the period between P3 reconnects). Mandatory: No Default: 0 Units: days #### previousFiles > useStagedInitialisation If set to true then the plugin will read a maximum of one file per sample. This is used when reading multiple p3 files at initialisation and the p3 files are large. Mandatory: No Default: false #### p3v5IniFilename The full path (including filename) of the p3v5.ini file. The "Connections" view is only shown if this setting is configured. Mandatory: No Default: "" ### Gl-Names The GL names section can be shared between different samplers. If it is to be shared, then it is stored in the "Static Vars" section of the setup rather directly in the sampler. Below are the gl-names settings. These can be set in the sampler or in the "Static Vars" section. #### gl-names > servers This section defines a list router/server pairs. Each server entry in the servers section represents a router/server pair. #### gl-names > servers > server > id This is the GL of the server. It is the combination of the router node id and the server subnode separated by a period. Mandatory: Yes #### gl-names > servers > server > type This is the type of the server. Mandatory: No Default: "" #### gl-names > servers > server > name This is a freeform text description of the router/server pair Mandatory: No Default: "" #### gl-names > servers > server > ignore Set this to true if the specific router/server pair does not need to be monitored Mandatory: No Default: false #### gl-names > users This section defines a user/router community. In most cases there need only be one users section, containing all the users and all the routers. However where there is more than one user with the same ID connecting from different routers (for example on a broker site) they must be separated into different user sections. #### gl-names > users > router This specifies the numeric ID of a router and freeform name to describe the router. There can be more than one user entry per users section. Both the name and ID of the router are mandatory. Mandatory: No #### gl-names > users > user This specifies the numeric ID of a user and freeform name to describe the user. There can be more than one user entry per users section. Both the name and ID of the user are mandatory. Mandatory: No #### gl-names > api-names This section is used to describe GL API applications that do not use a fixed name. For example, where the name is PARSE\_345 when the application connects for the first time, and then PARSE\_366 the next time they connect and so on. In this case PARSE\_ should be defined in this section. Not using this to section to describe such connections will result in the application being treated as a user, and every time the application connects or disconnects then dummy users will be generated in the GL-ROUTER-USERS window. This specifies the textual ID of an application and freeform name to describe the application. There can be more than one user entry per users section. Both the name and ID of the application are mandatory. Mandatory: No ### Names.ini configuration This is an optional reference file that associates textual names with the IDs of the GL routers, GL Server processes (e.g. SLE, SLC, Selector) and GL users. This file can be used instead of defining the data in the names section of the plugin. The file should always contain one [SERVERS] section and one or more [USERS] section, and optionally an API\_NAMES section. For example: ``` [SERVERS] SERVER_ID = 18999.7800, SERVER_NAME = SLC, ROUTER_NAME = Liffe Fut, IGNORE SERVER_ID = 18999.7801, SERVER_NAME = SLE, ROUTER_NAME = LiffeF SERVER_ID = 18999.7804, SERVER_NAME = Selector, ROUTER_NAME = LiffeF [END] [API_NAMES] API_ID=RISK_, Risk Management App API_ID=PARSE_, Parser App [END] [USERS] ROUTER_ID=17000, Internal 1 ROUTER_ID=17003, Internal 2 USER_ID=232, Simone Jones USER_ID=231, Charles Stout [END] [USERS] ROUTER_ID=13000, Internal 3 USER_ID = 130, Nina Simmons USER_ID= 140, William Gower [END] ``` **SERVERS** section defines router/server pairs. If a particular router/server pair does not need to be monitored, then 'IGNORE' should be added to the line. **API\_NAMES** should be used where GL API applications do not use a fixed name. For example, where the name is PARSE\_345 when the application connects for the first time, and then PARSE\_366 the next time they connect and so on. In this case PARSE\_ should be defined in this section. Otherwise every time the application connects/disconnects it will be treated as a new user, possibly generating a lot of dummy users in the GL-ROUTER-USERS window. **USERS** is a section that defines user / router communities. **Note** The ROUTER\_ID that the users connect from must also be defined in this section in addition to the USER\_IDs. More than one router can be defined. In most cases it is only necessary to define one [Names] section with all known routers and users. However where there is more than one user with the same ID connecting from different routers (for example on a broker site) they must be separated into different router communities.