TBF Input Adapter Sample

Contents

Importing This Sample into StreamBase Studio
Sample Location
Running This Sample in StreamBase Studio
Running This Sample in Terminal Windows

This sample demonstrates the use of the StreamBase TBF input adapter.

Importing This Sample into StreamBase Studio

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

  • From the top menu, click File → Load StreamBase Sample.

  • Select this sample from the Embedded Input Adapters list.

  • Click OK.

StreamBase Studio creates a project for this sample.

Sample Location

By default, the sample files are installed in:

On Windows

C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\adapter\embedded\tbf\

On UNIX

/opt/streambase/sample/adapter/embedded/tbf/

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_tbf
Windows XP:
   C:\Documents and Settings\username\My Documents\
      StreamBase Studio n.m Workspace\sample_embedded_tbf
Windows 7 and Windows Vista:
   C:\Users\username\Documents\StreamBase Studio n.m Workspace\
      sample_embeddedtbf

Running This Sample in StreamBase Studio

  1. In the Package Explorer, double-click tbf.sbapp.

  2. Select the TBFInput adapter icon to open the Properties view for the input adapter.

  3. In the Output Ports tab, ensure at least one of the two optional output feed ports is enabled.

  4. Select the Definitions tab and modify EquityFeedSchema and/or ReconciliationFeedSchema to include the fields of interest from the coresponding feed.

  5. Open the adapter configuration file, FeedAdapter.cfg, and modify it to match your site's environment. The configuration file shipped with the sample includes four sessions: two each (primary and recovery) for an equity and reconciliation feed. You may delete unused sessions if you are using the adapter to read either an equity or reconciliation feed, but not both.

  6. Click the Run button. This opens the SB Test/Debug perspective and starts the application.

  7. In the Test/Debug Perspective, open the Application Output view. Observe a session status tuple for each session created. Observe connection status tuples indicating whether the adapter is able to connect to ports supplying the the feeds. Observe equity and/or reconciliation tuples on the data port(s).

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

Running This Sample in Terminal Windows

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.

  1. Open three terminal windows on UNIX, or three StreamBase Command Prompts on Windows. In each window, navigate to your workspace copy of the sample, as described above.

  2. In window 1, type:

    sbd tbf.sbapp

  3. In window 2, type:

    sbc dequeue -v

    This window will display the tuples dequeued from the application's output ports.

  4. Observe in window 2 session, connection, and data tuples.

  5. In window 3, type the following command to terminate the server and dequeuer:

    sbadmin shutdown