CME MDP3 Adapter Sample

Sample Overview

This topic describes how to run the TIBCO StreamBase® for CME MDP3 Adapter sample application, which illustrates how to use the adapter to access CME MDP feeds. For more information on this adapter, see CME MDP3 Adapter.

This sample includes a CME MDP3 adapter, which by default connects to channel 311 of CME's NRCert testing environment and is assumed to already be running and accessible from your machine. Once launched, use the sample to access market data messages from that channel.

This Sample's Files

This sample contains the following files:

  • The sample EventFlow application, mdp3.sbapp.

  • subscriptions.csv, an optional file containing the IDs and names of instruments to which to subscribe upon connection.

Running This Sample in StreamBase Studio

The steps to run this sample in Studio are as follows:

  1. In order run, the adapter requires that the open-source Java Market Data Handler for CME Market Data (MDP 3.0) from EPAM Systems be installed on development and deployment machines that are expected to run StreamBase applications that call this adapter. You can obtain the Data Handler software from public.tibco.com.

    Once you download the above zip file, extract its contents to a temporary location and copy the following JAR files to your StreamBase installation:

    • Copy b2bits-jmdp3-2.0.2-mbp-with-mbo/b2bits-jmdp3-2.0.2.jar to <streambase-install>/lib/ext

    • Copy b2bits-jmdp3-2.0.2-mbp-with-mbo/lib/*.jar to <streambase-install>/lib/ext. If any files are already present it is safe to either leave them unchanged or overwrite them.

  2. You will also need to download config.xml and templates_FixBinary.xml (configuration files downloaded from CME's FTP site, see https://www.cmegroup.com/confluence/display/EPICSANDBOX/MDP+3.0+-+FTP+Site+Information) and place them in the project's top-level directory.

  3. In the Package Explorer, double-click to open the mdp3.sbapp application.

  4. Make sure the application is the currently active tab in the EventFlow editor, then click the Run button. This opens the SB Test/Debug perspective and starts the application.

  5. The adapter is expected to connect to the channel's various feeds and the data should start flowing.

  6. When done, press F9 or click the Stop Running Application button.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top-level menu, select FileLoad StreamBase Sample.

  • Type cme to narrow the list of options.

  • Select CME MDP3 from the Global category.

  • Click OK.

StreamBase Studio creates a project for the adapter in your current Studio workspace.

Sample Location

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.

Important

Load this sample in StreamBase Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.

Using the workspace copy of the sample avoids permission problems. The default workspace location for this sample is:

studio-workspace/sample_cme-mdp3

See Default Installation Directories for the location of studio-workspace on your system.