IBM Support

Setting debug options in Rational Functional Tester ivory.properties file

Question & Answer


Question

How can you enable debugging in IBM Rational Functional Tester?

Cause

When you encounter a problem, debugging might be helpful to obtain extra information about the possible causes of the problem. The problem can be in playback as well as in recording.

Answer

You modify a text file in the Functional Tester installation directory. The debugger works the same way on Linux as it does on Microsoft Windows.

To enable debugging output, edit the ivory.properties file in your Rational Functional Tester installation directory. You can use any text editor to modify the file.


For Rational Functional Tester version 8.x:

Edit the ivory.properties file is in the following location:

C:\Program Files\IBM\SDP\FunctionalTester\bin (Default Location)



To enable debugging, change the original line:

    rational.test.ft.debug.enabled=false

to

    rational.test.ft.debug.enabled=true

You can change the verbosity of the output by altering this line:

    rational.test.ft.debug.filter=default,3;rational_ft,3;wsw.rftuiplugin,3;native,3


    Note:     The "default,3" option provides the most detailed debugging.


The output file location and name is specified on this line:

    rational.test.ft.debug.filename=c:/ivDebug.txt

Optionally you can change the file name and file location.


For Rational Functional Tester 8.2 and higher, you can collect the errors, warning, and information messages into a log file (rft_log.txt). The debug information is collected into the trace file (rft_trace.txt). You can specify the log file and the trace file directory. Similarly, you can collect debug information as trace data into a trace file (rft_trace.txt). To set the preferences for logging and tracing through an user interface,follow these steps:
  1. Click Window > Preferences.
  2. In the left pane, expand Functional Test and click Logging and Tracing.
  3. Perform the operation that caused the problem.
  4. You can send the generated rft_log.txt, and rft_trace.txt files to IBM Software
Note: You can identify the files by looking at the timestamp of the generated files.



For Rational Functional Tester version 7.x:

The ivory.properties file is in the following location:

    C:\Program Files\IBM\SDP70\FunctionalTester\bin (Default Location)

To enable debugging, edit the file in the same manner as in Rational Functional Tester 8.x.

[{"Product":{"code":"SSJMXE","label":"IBM Rational Functional Tester"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Problem analysis","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.0;7.0.0.1;7.0.0.2;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;8.0;8.0.0.1;8.0.0.2;8.0.0.3;8.1;8.1.0.1;8.1.0.2;8.1.0.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21224514

Page Feedback