NAME¶
bssrecv - Bundle Streaming Service reception test program
SYNOPSIS¶
bssrecv
DESCRIPTION¶
bssrecv uses BSS to acquire streaming data from
bssStreamingApp.
bssrecv is a menu-driven interactive test program, run from the operating
system shell prompt. The program enables the user to begin and end a session
of BSS data acquisition from
bssStreamingApp, displaying the data as it
arrives in real time; to replay data acquired during the current session; and
to replay data acquired during a prior session.
The user must provide values for three parameters in order to initiate the
acquisition or replay of data from
bssStreamingApp:
- BSS database name
- All data acquired by the BSS session thread will be written
to a BSS "database" comprising three files: table, list, and
data. The name of the database is the root name that is common to the
three files, e.g., db3.tbl, db3.lst, db3.dat would be
the three files making up the db3 BSS database.
- path name
- All three files of the selected BSS database must reside in
the same directory of the file system; the path name of that directory is
required.
- endpoint ID
- In order to acquire streaming data issued by
bssStreamingApp, the bssrecv session thread must open the BP
endpoint to which that data is directed. For this purpose, the ID of that
endpoint is needed.
bssrecv offers the following menu options:
- 1. Open BSS Receiver in playback mode
- bssrecv prompts the user for the three parameter
values noted above, then opens the indicated BSS database for replay of
the data in that database.
- 2. Start BSS receiving thread
- bssrecv prompts the user for the three parameter
values noted above, then starts a background session thread to acquire
data into the indicated database. Each bundle that is acquired is passed
to a display function that prints a single line consisting of N
consecutive '*' characters, where N is computed as the data number at the
start of the bundle's payload data, modulo 150. Note that the database is
not open for replay at this time.
- 3. Run BSS receiver thread
- bssrecv prompts the user for the three parameter
values noted above, then starts a background session thread to acquire
data into the indicated database (displaying the data as described for
option 2 above) and also opens the database for replay.
- 4. Close current playback session
- bssrecv closes the indicated BSS database,
terminating replay access.
- 5. Stop BSS receiving thread
- bssrecv terminates the current background session
thread. Replay access to the BSS database, if currently open, is
not terminated.
- 6. Stop BSS Receiver
- bssrecv terminates the current background session
thread. Replay access to the BSS database, if currently open, is also
terminated.
- 7. Replay session
- bssrecv prompts the user for the start and end times
bounding the reception interval that is to be replayed, then displays all
data within that interval in both forward and reverse time order. The
display function performed for this purpose is the same one that is
exercised during real-time acquisition of streaming data.
- 8. Exit
- bssrecv terminates.
EXIT STATUS¶
- 0
- bssrecv has terminated.
FILES¶
No configuration files are needed.
ENVIRONMENT¶
No environment variables apply.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO¶
bssStreamingApp(1),
bss(3)