ORC Plug-in - Technical Reference

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

orc2

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

orc3

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

orc4

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

orc5

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

orc6

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

orc7

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

orc8

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

orc9

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

orc10

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

orc11

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:

logFile

The path to the ORC service or process log file.

Mandatory: Yes

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

Mandatory: No
Default: Auto-detect

startupTime

The time the trading system will start up in the morning. This should be left to the default in the majority of cases.

Mandatory: No
Default: 06:00:00

shutdownTime

The time the trading system will shutdown overnight - for database recording purposes. This should be left to the default in the majority of cases.

Mandatory: No
Default: 23:00:00