Introduction
The ORC system comprises of a number of processes that interact across a distributed UNIX architecture. This architecture works as follows:
- ORC internal or gateway process to various electronic exchanges.
- Traders may connect to various different processes within this architecture to trade on different markets.
- Exchange manager monitors the user connections and the status of the different processes.
The GENEOS ORC plug-in module monitors ORC users and services, and should be configured for each process running on each box.
The following types of ORC user processes are currently supported:
- STORAGE
- CDS
- API
- SWX
- SWX5
- SSL
- GAMD (MCW)
- EUREX
- LIFFE
ORC services are controlled via two processes, the Port Mapper Daemon (PMD) and the Exchange Mapper Daemon (EMD). All ORC services register themselves with one or both of these processes at start-up.
These processes know about ORC services across a distributed system, and act in a similar way to routers.
All ORC messages travel via an EMD or PMD, and when a message is received it is interpreted and forwarded on to the appropriate service by these two daemons.
The following types of ORC service processes are currently supported:
- PMD
- EMD
Information retrieved from different types of process varies slightly. See the views section below for a complete set of example views and a legend detailing what each view displays.
User Views
The views produced by this plug-in are slightly different depending on which type of process is being monitored. Examples are shown below:
STORAGE View
STORAGE Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
STORAGE Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginType | The login type. May be Asynch, Synch or API-Synch. Each user connects as both Synch and Asynch. |
| loginStatus | User is Logged-In or Logged-Out. Otherwise an appropriate message will be displayed if the connection crashes or times out. |
| timeStamp | Time of the last event for that user. |
| clientName | Name of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
CDS View
CDS Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
CDS Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginType | The name of the user account connected. |
| loginStatus | The login type. May be Asynch, Synch or API-Synch. Each user connects as both Synch and Asynch. |
| timeStamp | Time of the last event for that user. |
| clientName | Name of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
API View
API Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
API Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginStatus | User is Logged-In, Logged-Out or Disconnected. |
| timeStamp | Time of the last event for that user. |
| clientName | Name of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
SWX/SWX5 View
SWX/SWX5 Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
SWX/SWX5 Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginStatus | User is Logged-In, Logged-Out or Failed Log-In. |
| timeStamp | Time of the last event for that user. |
| clientName | Name of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
SSL View
SSL Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
SSL Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginStatus | User is Logged-In or Logged-Out. Otherwise an appropriate message will be displayed if the connection crashes or times out. |
| timeStamp | Time of the last event for that user. |
| clientName | Name of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
GAMD View
GAMD Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
GAMD Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginStatus | User is Logged-In, Logged-Out or Session Terminated. |
| timeStamp | Time of the last event for that user. |
| clientAddress | IP address of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
EUREX View
EUREX Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
EUREX Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| trader_id | Trader ID the user registered with Eurex. |
| loginStatus | User is Logged-In or Logged-Out. |
| timeStamp | Time of the last event for that user. |
| clientName | Name or IP address of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
LIFFE View
LIFFE Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
| orcserver | ORC release. |
| version | ORC version. |
| protocol | Protocol version. |
| api | API version. |
LIFFE Table Legend
| Name | Description |
|---|---|
| userName | The name of the user account connected. |
| loginStatus | User is Logged-In or Logged-Out. |
| timeStamp | Time of the last event for that user. |
| clientName | Name or IP address of the machine from which the connection was made. |
| loginDuration | During out-of-hours periods, the total number of seconds each user was logged on for is displayed in this column to allow this to be logged to the database. The column will appear empty during the working day - 06:00:00 to 23:00:00 hours by default. |
Service Views
PMD View
PMD Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
PMD Table Legend
| Name | Description |
|---|---|
| monitoredDaemon | Name of the ORC daemon process being monitored. |
| timeStamp | Time of the last event for that daemon. |
| hostPort | Port number on which the process is listening for messages. |
| callbackPort | The port on which the PMD is listening on. |
| currentStatus | The current status of this port mapping. |
EMD View
EMD Headline Legend
| Name | Description |
|---|---|
| totalConnections | The current number of connections. |
EMD Table Legend
| Name | Description |
|---|---|
| monitoredDaemon | Name of the ORC daemon process being monitored. |
| type | Type number of the ORC demon being monitored. |
| hostName | Name of the server on which the process is running. |
| hostPort | Port number on which the process is listening for messages. |
| timeStamp | Time of the last event for this process |
| currentStatus | The current status of this port mapping. |
| description | Brief description of what this process does. |
Plug-in Configuration
The following parameters can be configured for this plug-in:
logType
ORC will attempt to detect the log type automatically. If this is being detected incorrectly, it is possible to configure ORC to use a specific log type using this parameter. This is necessary for the new style Eurex log files (eurexv).
Possible values:
| Setting | Description |
|---|---|
| storage | Storage daemon process |
| api | API process |
| swx | Swx exchange process |
| swx5 | Swx exchange process |
| ssl | SSL process |
| gamd | GAMD process |
| eurex | Eurex exchange process |
| eurexv | Eurexv exchange process |
| liffe | LIFFE exchange process |
| pmd | Port Mapper Daemon |
| emd | Exchange Mapper Daemon |