TIBCO Rendezvous Adapter Sample

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

Note

Before running this sample, be sure to configure the TIBCO Rendezvous tibrvj.jar file and make the Rendezvous middleware libraries available to the system, as described in TIBCO Middleware Dependencies in the TIBCO Rendezvous Subscribing Input Adapter or TIBCO Rendezvous Publishing Output Adapter pages of the Adapters Guide.

Running This Sample in StreamBase Studio

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

  2. Select the PublishNYSE adapter icon to open the Properties view for the adapter.

Note: Skip the following step to use the Rendezvous daemon on the local computer listening on the default port.

  1. Select the Adapter Properties tab and enter your site's values for Service, Network, and Daemon.

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

  3. In the Test/Debug Perspective, open the Application Output view. If the adapter is able to connect to the Rendezvous daemon, three "Transport Created" status tuples appear, one from each TIBCO Rendezvous adapter instance.

  4. In the Manual Input view, click Send Data. Addition tuples will appear in the Application Output view from the NYSE and Alerts streams indicating:

    • The CSV file reader adapter read and published the simulated feed via the PublishNYSE TIBCO Rendezvous adapter.

    • The SubscribeToNYSE TIBCO Rendezvous adapter read the published NYSE feed.

    • The PennyStockAlert filter operator detected "penny stock" tuples and directed them to the Alerts output port and PublishAlerts TIBCO Rendezvous adapter.

  5. 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 PennyStockAlert.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, start the simulated NYSE feed:

    echo null | sbc enqueue StartFeed

  5. Observe in windows 2 that tuples appear from the NYSE and Alerts streams.

  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_tibrv

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/tibrv

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