Tervela Adapter Sample

This sample demonstrates the use of the TIBCO StreamBase® Adapter for Tervela.

Running This Sample in StreamBase Studio

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

  2. Select the Definitions tab and modify the schema of the PublishSchema named schema to match that of the messages you wish to publish.

  3. Select the Parameters tab and enter your site-values for username, password, and tmxaddress1, and, if appropriate, tmxaddress2.

  4. Select the TervelaInput adapter icon to open the Properties view for the input adapter.

  5. Enter in the Topic(s) property one or more topics, separated by spaces, you would like to subscribe to when the application starts. You can subscribe to additional topics after the application starts by enqueuing tuples to the Subscribe stream.

  6. Select the TervelaOutput adapter icon to open the Properties view for the output adapter.

  7. Enter the topic you want to publish to in the Default Topic property. Note that the default topic can be overridden in each publish tuple.

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

  9. In the Test/Debug Perspective, open the Application Output view. If the adapters are able to connect and log in to the TMX server(s), two Login status tuples with a Succeeded action appear, one from each Tervela adapter instance.

  10. In the Manual Input view, select the Publish input stream, enter values in more or more fields, and click Send Data. A tuple will appear in the Application Output view from the Data streams.

  11. 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 tervela.sbapp

  3. In window 2, type:

    sbc dequeue -v

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

  4. In window 3, enqueue a tuple to be published (adjusting the number of field to match your Publish schema):

    echo MyTopic,MyBlob,true,1.23,123,1234,MyString,2010-03-24,null | sbc enqueue Publish

  5. Observe in windows 2 the published tuple appears on the Data stream.

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

    sbadmin shutdown

Importing This Sample into StreamBase Studio

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

  • From the top menu, click FileLoad StreamBase Sample.

  • Select this sample from the Embedded Input Adapters list.

  • Click OK.

StreamBase Studio creates a project for this sample.

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 the permission problems that can occur when trying to work with the initially installed location of the sample. The default workspace location for this sample is:

studio-workspace/sample_adapter_embedded_tervela

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

In the default TIBCO StreamBase installation, this sample's files are initially installed in:

streambase-install-dir/sample/adapter/embedded/tervela

See Default Installation Directories for the location of streambase-install-dir on your system. This location may require administrator privileges for write access, depending on your platform.