Command Line Options

Syntax

Ribo [-l listen_port] [-s server_host] 
[-p server_port] [-c capture_file_prefix] 
[-t trans_file_prefix] [-x charset] 
[-gui] [-d] [-f filter_file] [-h]

Parameters

• -l listen_port – the port on which to listen. The default is 5005.
• -s server_host – the host name of the database server. The default is localhost.
• -p server_port – the port number of the database server. The default is 2638.
• -c capture_file_prefix – specify the prefix added to the generated file name of the captured data. This file is used by Technical Support personnel to troubleshoot problems.

  The default is capX.tds, where X is the generated file name.

• -t trans_file_prefix – translates captured data to the TDS protocol’s text representation and saves it to a file.

  Use this option to specify the prefix added to the generated file name of the translated data.

  The default is outX.tds, where X is the generated file name.

• -x charset – lets you specify the default character set conversion to use when dumping TDS files.
  • The character set you specify must match Sybase supported character set.
  • If Ribo finds character set information in the login record, this information overrides the charset you specify using -x.
  • If you do not specify a character set using -x, and the TDS file contains no character set information, no character set translation is performed; text is written using the server’s default character set.

  See the jConnect for JDBC Programmers Reference or the Adaptive Server Enterprise Installation Guide for more details about character sets and conversion.

• -gui – invokes the Ribo GUI to:
  • Specify command line parameters
  • Start and stop the capturing process
  • View translated data “on the fly” as it is being analyzed
• -d – displays translated data while the data is being captured. If you are using the Ribo GUI, the data appears in a separate window. If you are not using the GUI, the data appears on the screen.
• -f filter_file – specify a user-defined, previously saved filter.
• -h – displays help on Ribo usage.

Examples

• Example 1 – to use the listener port on local machine port 2638 and forward the data to another machine—rubicon, port 2525—enter:

  Ribo -l 2638 -s rubicon -p 2525

• Example 2 – to use the listener port on a local machine port 4000, display the data in the GUI as it is being captured, and filter the data using a script you have created named myscript.filter, enter:

  Ribo -gui -l 4000 -f myscript.filter -d