Capturing and Translating Data Using the GUI

Use the Ribo graphical user interface (GUI) to capture and translate data.

1. Invoke the Ribo GUI using the listener port on local machine port 2638:

   Ribo -gui -l 2638

   If you have specified the listener port, server host, and server port during Ribo start-up, these parameters are automatically filled in for you in the Ribo window.

2. Select File > Preferences.
3. In the Ribo Settings window, accept or change the values. These values correspond to the command line parameters.

   If you have specified a value for these parameters when you invoke Ribo at the command line, those values appear in the window.

   If you do not specify these parameters, the program displays the default values.

   Field	Description
   Capture File Prefix	Corresponds to the -c capture_file_prefix parameter. Specify the prefix added to the generated file name of the captured data.
   Translate File Prefix	Corresponds to the -t trans_file_prefix Specify the prefix added to the generated file name of the translated data.
   Translation Filter File	Corresponds to the -f filter_file parameter. Display the file name of the filter you specified when you invoke Ribo at the command line.
   Translate to a File	Corresponds to the -t trans_file_prefix Select this option to translate captured data to the TDS protocol's text representation and save it to a file with the prefix you specified.
   Display Translation in a Window	Corresponds to the -d parameter. Select this option to display translated data in the GUI while the data is being captured.

4. Click OK.
5. Click Start Capture.

   To stop the capture process, click Stop Capture. You must stop the capture process to change the host, ports, or preferences.

6. When done, click End.

   Note: Captured TDS protocol data saved to a file contains sensitive user authentication information and may contain confidential company or customer data. To protect this confidential data from unauthorized or accidental disclosure, the files containing captured data must be properly protected using file permissions or encryption.