esp_ommsample

Synopsis

esp_ommsample -u username [ OPTION ...]

Description

The esp_ommsample utility operates as a data sink from RMDS for OMM messages. It enables you to see which fields are delivered and their values without setting up a Reuters OMM adapter and model.

esp_ommsample prints data to stdout, getting its configuration from the command line. You can run it for a specified period of time or stop it using Ctrl+C.

Required Arguments

• -u username – specify the user name with which to connect to RMDS [ENTER_VALID_USERNAME].

Options

• -a FID_dictionary – specify a dictionary to use instead of the default dictionary (./config/RDMFieldDictionary).
• -A applicationId – specify an ApplicationId to override the default (256).
• -c Reuters config file – specify the path and file name of the Reuters configuration file. Since this file is usually shared with the Reuters OMM adapter, this is, by default, set to ./config/rmdsomm.cfg.
• -e enum_defs – specify a file name to override the default (./config/enumtype.def).
• -f format – specify the format ( 0, 1, 2, or 3) for update messages. The default, 0, is a multiline format with each value on a separate line. Specify 1 to get all of the values on one line, for example:

  207 TRIN.O|TRDPRC_1=1.14|BID=1.13|ASK=1.17|ACVOL_1=1000|ASK_TIME=10:26:2|

  The RIC (TRIN.O) is prefaced by a millisecond timestamp and followed by FID=value pairs, delimited by "|". Specify 2 to have the FID numbers included along with the field names: field[FID]=value. Specify 3 for the tersest format: FID=value.

  You can use separator characters for environment variables. ESP_OMMSAMPLE_PAIR_SEPARATOR defaults to '='. ESP_OMMSAMPLE_FIELD_SEPARATOR defaults to '|'. ESP_OMMSAMPLE_TIMESTAMP_SEPARATOR defaults to ' '.

• -h – print this help message and exit.
• -I instanceId – specify an InstanceId to override the default (1).
• -m type – specify the message type (MMT) to use, where type is one of:

    1 = MarketPrice
    m = MarketMaker
    o = MarketByOrder
  [ p = MarketByPrice ]
    s = SymbolList

• -p period – specify the length of time (in seconds) to listen to updates before terminating. The default is 120.
• -P position – Specify a position to override the default (yourIP/net).
• -r service – specify the RMDS service: one that is a valid service name for your site. This value defaults to DF_EAP_LAB1, which is a service available on Reuters test lab.
• -s symbol [symbol ...] – specify one or more symbols (RICs) to which to subscribe. A space-separated list likely needs quotes to protect it from the shell.
• -S file – specify a file containing symbols (RICs) to which to subscribe. These are added to any RICs that have been specified via the -s option.
• -v – Show the version number and exit.

Examples

cd $ESP_RMDSOMM_HOME/bin
./esp_ommsample -u myUsername -r MY_SERVICE -m 1 -s GOOG.O >& esp_ommsample.out &