esp_rmdsomm

Synopsis

esp_rmdsomm -f mapFile -p host:port/workspace/project [ OPTION ...]

Description

The esp_rmdsomm command can start an adapter as either a data source or sink to or from the Event Stream Processor to or from Reuters Market Data System (RMDS). To both subscribe from and publish data to RMDS, you must run two separate RMDS OMM adapter instances.

The metadata describing the connection has several parts, including a map file, configuration file, and possibly a configuration stream resident on a running instance of the Event Stream Processor.

Reuters OMM has several domains. Currently, only MARKET_PRICE, MARKET_BY_PRICE, and MARKET_ BY_ORDER are fully supported. MARKET_MAKER is supported only for inbound streams. See the Reuters documentation for more information, including what FIDs to expect on the message domains.

The process runs as a daemon, getting its configuration from a map file. It handles SIGHUP; so you can enter kill -s SIGHUP pid on Linux or kill -s HUP pid on Solaris (where pid is the process ID of the esp_rmdsomm daemon, which you can obtain using the ps command) to gracefully shut dow the adapter. Using the KILL signal rather than the HUP signal may prevent a complete clean up of system resources.

There are three directories underneath the directory where the adapter is installed containing additional information: doc, examples, and config. The doc directory contains Reuters README files that describe various configuration options. The examples directory contains several example map files that demonstrate many features. The config directory contains example RMDS configuration files. Minimally, you must modify the RMDS config file with your site's specific information. Typically, you must also modify the map file to match the Event Stream Processor.

Required Arguments

• -f mapFile – specify the map file containing the metadata required to map the market data to/from RMDS.
• -p hostname:port/workspace/project – specify the URI to connect to the server (cluster manager). For example, -p localhost:19011/default/prj1 specifies a project called prj1 in the default workspace of an ESP cluster server using port 19011 on your localhost.

Options

• -a in|out|interactive – specifies whether the RMDS OMM adapter instance is passing data in to the Event Stream Processor or receiving data passed out from it. Valid values are in, out and interactive. Since the default value is in, this option is typically omitted when subscribing to market data.

  For backward compatibility, "subscribe" (in) and "publish" (out) are still allowed, but the options have been deprecated.

• -c user[:password] – if you are using an authentication method that requires credentials (such as Kerberos or RSA), this option passes those authentication credentials to Event Stream Processor. If Event Stream Processor successfully authenticates with these credentials, the connection is maintained, otherwise Event Stream Processor immediately closes the connection.
• -d debugLevel – sets the debug level. The valid range is 0–7, with 0 being minimal and 7 being verbose. By default it is set to 4.
• -e – negotiates encrypted OpenSSL sockets for all communication with the Event Stream Processor, which must be started in encrypted mode when using this option.
• -F configFile – specifies the RMDS Configuration file, overriding the configuration file specified in the map file.
• -g gatewayHost – explicitly specifies the Event Stream Processor gateway host.
• -h – print a short help message describing the syntax of this command.
• -k privateRsaKeyFile – perform authentication using the RSA private key file mechanism instead of password authentication. The privateRSAKeyFile must specify the absolute path file name of the private RSA key file. With this option enabled, the user name must be specified with the -c option, but the password is not required. In addition, Event Stream Processor must be started with the -k option.
• -l 0|1|2|3 – specify the location to which log messages get sent. Use 0 for no log messages, 1 to send to stderr only (the default), 2 to send to syslog only, and 3 to send to both stderr and syslog.
• -r resubscribeInterval – specify how many seconds to wait (default is 300) between attempts to resubscribe to a RIC. (If a subscription to a RIC is marked CLOSED or CLOSEDRECOVER, you must resubscribe to that RIC for data to flow.) To disable resubscription attempts, specify 0 as the value. Periodically resubscribing can compensate for a temporary condition where the source is not ready for subscribers. Each unsuccessful resubscribe attempt generates a failure event which may result in a status update marking the item stale.
• -s streamName – specify the stream to be used when running in discovery mode. This option is used by the connector start mechanism and specifies the single stream for which mapped columns have been discovered.
• -v – print the version of the RMDS OMM adapter and exit.
• -w retrySeconds – specify the number of seconds to wait between retries when connecting to the Event Stream Processor. The default is 5. Specify 0 to try only once.
• -x optName – specify various extra settings; use -x help to see a list of possible values.
• -z publishCount – specify the number of (2x) values to pass to the Event Stream Processor before terminating. By default this is 0, which means never terminate.
• -Z subscribeCount – Specify the number of (2x) values to pass to RMDS before terminating. By default this is 0, which means never terminate.

Examples

esp_rmdsomm -c user:passwd -f myMap.xml -p localhost:1099/work02/proj1 -d 7 &> omm.in.log &

esp_rmdsomm -a out -c user:passwd -f myMap.xml -p loki:2010/work01/proj3 -d 7 &> omm.out.log &