rbnbUDPCaster is a Java application which fetches data from a DataTurbine channel and writes the data out as UDP packets to one or more specified recipient addresses.
UDPCaster is part of the OSDT Installation.
The File pull-down menu provides selections for opening and closing the DataTurbine connection and for exiting the application.
|Open||The following actions are performed:
|Close||The following actions are performed:
|Exit||Close the DataTurbine connection and exit program.|
Specify the host and port of the DataTurbine to which to connect. For example, enter “localhost:3333” (without the quotes) to specify to connect the DataTurbine running on the local machine at port 3333.
Specify the DataTurbine channel to which to subscribe – that is, which channel to fetch data from. As a convenience, the Select Chan… button may be used to help select the appropriate channel.
A convenient method of selecting a DataTurbine channel is provided with the Select Chan… button. Pressing this button pops up a dialog similar to the one shown below. The pull-down list is populated with channels available from the DataTurbine specified in the RBNB address field. Selecting a channel and clicking the OK button copies the desired channel name to the RBNB channel field on the user interface.
Recipients (comma-delim list)
A comma-delimited list of hosts and ports where to send the UDP packets. For example, enter “localhost:5555” (without the quotes) to specify to send UDP packets to the local machine’s socket port 5555. As another example, enter “bighost:5555,localhost:4444” (without the quotes) to specify to send UDP packets to both bighost:5555 and localhost:4444.
Stream RBNB data
Specify the starting point for fetching data from the DataTurbine channel. There are two options: From oldest andFrom newest. Selecting From oldestbegins fetching at the oldest available data in the DataTurbine channel. Selecting From newest will start fetching data with the next frame put into the specified channel.
Number of RBNB frames fetched
Displays the number of data fetches that have been completed since the user opened the DataTurbine connection.
Timestamp of last RBNB frame
Displays the timestamp of the last frame fetched from the DataTurbine.
Command Line Arguments
rbnbUDPCaster can be run with the following optional command-line arguments, for example:
|Address||-a||<DataTurbine host>:<port>||Specifies DataTurbine to which to connect; defaults to “localhost:3333”.|
|Channel||-c||<DataTurbine channel>||Specifies the DataTurbine channel to which to subscribe; no default value.|
|Help||-h||Print a help message displaying the command-line options.|
|Oldest||-o||Stream from oldest.|
|Recipients||-r||<host:port list>||Comma-delimited list of host:port recipients (specifies where to send the UDP packets); defaults to “localhost:5555”.|
|Socket||-s||<local socket port>||Specifies the local socket port to use to send out UDP packets; defaults to 3456. In most cases, it is best to allow the system to automatically select the local socket port. If a local port is specified on the command line, the system will attempt to use that port. However, if that port is already in use, the system will automatically select a different port.|
|Auto-Start||-x||Auto-start on launch (make RBNB connection and establish subscription).|