Contents
This sample demonstrates the use of the StreamBase Alpha Trading System EMAPI Order Entry Adapter. See Alpha Trading Systems EMAPI Order Entry Adapter for details on the use and structure of this two-part adapter.
In StreamBase Studio, import this sample with the following steps:
-
From the top menu, click → .
-
Select this sample from the Embedded Input Adapters list.
-
Click OK.
StreamBase Studio creates a project for this sample.
By default, the sample files are installed in:
- On Windows
-
C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\adapter\embedded\alpha-emapi-oe\ - On UNIX
-
/opt/streambase/sample/adapter/embedded/alpha-emapi-oe/
When you load the sample into StreamBase Studio, Studio copies the sample project's
files to your Studio workspace. StreamBase Systems recommends that you use the
workspace copy of the sample, especially on UNIX, where you may not have write access
to /opt/streambase. In the default installation, the
path to this sample in your Studio workspace is:
UNIX: ~/streambase-studio-n.m-workspace/ sample_adapter_embedded_alpha-emapi-oe Windows XP: C:\Documents and Settings\username\My Documents\ StreamBase Studion.mWorkspace\sample_adapter_embedded_alpha-emapi-oe Windows 7 and Windows Vista: C:\Users\username\Documents\StreamBase Studion.mWorkspace\ sample_adapter_embedded_alpha-emapi-oe
-
Double click to open the Feed Simulation named
simple-order.sbfs. Select Custom Fields and edit theuserfield constant value to match your Alpha Trading System User ID. -
Double-click to open the sample application,
AlphaEMAPIOESample.sbapp. -
Select the Alpha OE Input adapter and select the Adapter Properties tab. Fill in the required information with your user ID, Server address, and so on. You can leave the Alpha OE pair ID unchanged as a parameter.
-
Click the
Run button. This opens the
Test/Debug perspective and starts the application.
-
In the Test/Debug Perspective, open the Application Output view. Look for three tuples on the
StatusOutoutput stream, the INITIALIZING, CONNECTED, and SUBSCRIBED actions. Other actions, such as UNAVAILABLE mean the adapter is unable to connect to the Alpha Trading system and you must diagnose the connection problem. -
Once the adapter has connected, open the Feed Simulations view. Select and run the feed simulation named
simple-order.sbfs. This sends four order requests to the Alpha test venue. -
In the Application Output view, look for at least PrivateOrderBookFlow and OrderResponseOut for each of the four orders. If the orders are traded, you also see one or more PrivateTradeFlow messages.
-
When done, press F9 or click the
Stop Running Application button.
This section describes how to run the sample in UNIX terminal windows or Windows command prompt windows. On Windows, be sure to use the StreamBase Command Prompt from the Start menu as described in the Test/Debug Guide, not the default command prompt.
-
Use StreamBase Studio to set up the adapter properties, and the feed simulation's
userfield. -
Open three terminal windows on UNIX, or three StreamBase Command Prompt s on Windows. In each window, navigate to your workspace copy of the sample, as described above.
-
In window 1, type:
sbd AlphaEMAPIOESample.sbapp -
In window 2, type:
sbc dequeue -vThis window now displays the tuples dequeued from the adapter's output ports.
-
In window 3, type the following command to terminate the server and dequeuer:
sbfeedsim simple-orders.sbfsLook for the OrderResponseOut, PrivateOrderBookFlow, and one or more PrivateTradeFlow messages from the dequeuers in window 2.
-
In window 3, type the following command to terminate the server and dequeuer:
sbadmin shutdown