Application
Options
To access the Application Options
dialog, in the Display Builder select Tools>Options.
Options specified in StreamBase tabs can be saved in an initialization file (SBOPTIONS.ini). On
startup, the initialization file is read by the Display Builder, Display Viewer,
Display Server, Data Server and Historian to set initial values. If no
directory has been specified for your initialization files
and SBOPTIONS.ini is not found in the directory where you started the
application, then RTView will search under lib in your
installation directory. NOTE: When you start an RTView application
from the Windows Start menu, it runs from the demos directory.
NOTE: Options specified using
command line arguments will override values
set in initialization files. There are
four Options tabs: StreamBase Connections,
StreamBase Streams, StreamBase History Streams and StreamBase Administration.
StreamBase Connections
This tab allows you to add or remove connections
and set your default connection.
When you add a
StreamBase
connection to the list it will be highlighted in
yellow indicating that RTView has not connected to it. To attempt to
connect to a StreamBase
connection, click OK, Apply or Save.
If the background remains yellow, then RTView was unable make a
connection. Check that your StreamBase
connection was setup correctly and that the
StreamBase
message server is running. NOTE: Regardless of which tab you are currently
working from in the Application Options dialog, each time you click OK,
Apply or Save RTView will attempt to connect to all
unconnected connections.
Default Connection -
Name of connection used as the
default for data attachments. Select from drop down menu to change default
setting.
Add
Connection - Click to open the Add Connection
dialog. To edit, select a connection
from the list and double-click. Connections that are
updating objects in a current display cannot
be renamed.
Connection
Name - The name to use when
referencing this StreamBase
connection in your data attachments.
URIs - The complete URI of your StreamBase server.
Multiple URIs can be entered, one per line, to connect to a StreamBase
application running on multiple servers.
Dequeue Interceptor -
Enter the name of a Java class. This class name must be added to the
definition for the RTV_USERPATH environment variable. The Java class entered
should include the processResult() method, which will be called by the
StreamBase application in the course of dequeuing each tuple. Within the
processResult() method you can make decisions about the dequeue process.
For example, in an application where two servers are both dequeueing tuples
but only one is designated the leader, you may choose to suppress the tuples
from the non-leader server. For more information on StreamBase
High-Availability features, go to
http://streambase.com/developers/docs/latest/admin/highavail.html.
Remove Connection
- Select a connection from the list and click
Remove
Connection to delete. Connections that are updating objects in a current
display cannot be removed.
StreamBase Streams
This tab allows you to configure streams,
including any number of filtered logical
streams. When RTView connects to a StreamBase server, it retrieves
the list of available streams and then uses the Streams list you specify to
control which subscriptions to make. Filtered logical streams will be applied on the server to
each tuple before it is sent to the client and only tuples that pass through the filter
will be sent on those logical streams, thus reducing the amount of data sent to
the client.
|
 |
|
Streams |
Specify any
number of logical streams for a given stream. When a logical stream is added there is no
subscription to the physical stream, but rather to the logical stream with the
filter expressions as specified. If no
streams are specified, then RTView subscribes to all streams on each
specified connection (URI). NOTE: If it is
necessary to subscribe directly to the physical stream, then there are no
performance benefits gained by creating logical streams. To filter the data,
create one physical stream and use row filtering in the
Attach to StreamBase Data dialog. |
| Add Stream |
Click Add Stream and enter the name of a stream.
Press Enter to add to the Streams list. |
| Add
Logical Stream |
Select
a stream from the Streams list and click
Add Logical Stream. Enter a name for the
logical stream and press Enter to add to the Streams list. |
| Remove |
Select
a stream or logical stream from the list and click
Remove. |
| Filter
Expression |
Select a logical stream
from the list and enter filter expression.
Substitutions may be used in
filter expressions. NOTE: For a complete description of filter expression
syntax, refer to your StreamBase documentation. |
StreamBase History Streams
This tab allows you to configure history
stream and simulated stream options.
|
 |
|
History Streams |
| Enables the reading of
the CSV file for the specified stream. Select Write History
(on the StreamBase Administration tab) to create a CSV file. NOTE: In order for historical data to be
available, the DATA subdirectory (located in the directory from which you
launched RTView) must contain a CSV file for the stream. |
| Add |
Enter the name of the stream for which you want to read a CSV file and
click Add to include it in the History Streams list. |
| Remove |
Select
a stream from the list and click
Remove. |
|
Simulated Streams |
For each stream name specified, the DATA
subdirectory (located in the directory from which you launched RTView) must contain a CSV file named stream_name.csv.
RTView
will look for stream_name.csv on each update. If found, and the timestamp
on the file has changed since the last time it was read, RTView will
use the data in the file to simulate data for that stream. NOTE: The data in the CSV
file must match the stream format defined in your .sbapps file. |
| Add |
Enter the name of the stream that
you want to simulate data for and click Add to include it in the
Simulated Streams list. |
| Remove |
Select
a stream from the list and click
Remove. |
StreamBase Administration
This tab allows you to setup
administration options for the StreamBase data source.
Enable Monitor Metrics
- Select to enable event driven statistics. These
statistics will be polled every ten (10) seconds.
Default is enabled. NOTE: Setting this parameter to true will increase
traffic on your streams as the monitor information must be sent from StreamBase
to RTView.
Write History
- Select to enable the writing of a CSV file containing all the data for
all tuples received for the streams specified in History Streams. CSV files are
written to the DATA subdirectory, located in the directory from which you
launched RTView. History
Streams must be enabled for Write History to execute.
History
Depth -
The number of rows RTView keeps in the history table for each stream.
Default is 20,000.
|
