--- title: "ORC" description: "" url: "https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/orc/index.html" --- ## 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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image2_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image3_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image4_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image5_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image6_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image7_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image8_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image9_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image10_geneos_-_orc_plug-in.png) **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](https://docscdn.itrsgroup.com/geneos/images/netprobe/trading-images/image11_geneos_-_orc_plug-in.png) **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: Mandatory: No Default: Auto-detect

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

### 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