IBM Support

Setting up debug tracing for the ClearCase SCM Adapter using Rational tools

Question & Answer


Question

How can I setup debug tracing for the IBM Rational ClearCase SCM adapter using Rational tools?

Answer


Enabling IBM Rational Application Developer (RAD) and ClearCase SCM Adapter plug-in tracing:

  1. Create a text file named .options and store it in the installation directory of the Rational product using the SCM Adapter.

    For example: C:\Program Files\IBM\SDP
    2. Windows Example
    The .options file must be created at the command line as Windows Explorer does not allow you to create files with a preceding period (dot).



    INSTRUCTIONS:
    1. Open a command prompt (Start > Run type cmd).
    2. Navigate to the installation directory (by default) C:\Program Files\IBM\SDP

      C:\>cd C:\Program Files\IBM\SDP

    3. Using notepad, create the .options file

      C:\Program Files\IBM\SDP>notepad .options

      Note: The following window will appear - Click Yes:

  2. Copy the following text into the .options file and save.


    # -------------- Tracing Options File -----------------
    # All lines preceeded with a # sign are not evaluated.

    com.rational.clearcase/debug=true
    com.rational.clearcase/debug/traceLevel=2
    # --------------------------------------------------------------


  3. Start the product using the following command from command-line and in the product installation directory:

    Rational Application Developer 7.0:

    Windows:

    .\jdk\jre\bin\java.exe -Xquickstart -Xms40m -Xmx768m -Xgcpolicy:gencon -Xscmx96m -Xshareclasses:singleJVM,keep -XX:MaxPermSize=512M -cp startup.jar org.eclipse.core.launcher.Main -debug -product com.ibm.rational.rad.product.ide > trace.txt 2>&1


    Linux:

    ./jdk/jre/bin/java -Xquickstart -Xms40m -Xmx768m -Xgcpolicy:gencon -Xscmx96m -Xshareclasses:singleJVM,keep -XX:MaxPermSize=512M -cp startup.jar org.eclipse.core.launcher.Main -debug -product com.ibm.rational.rad.product.ide > trace.txt 2>&1


    Rational Application Developer 7.5

    Windows:

    eclipsec.exe -product com.ibm.rational.rad.product.v75.ide -debug     -consolelog > trace.txt 2>&1


    Linux:

    .\jdk\jre\bin\java -Xquickstart -Xms40m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx96m -XX:MaxPermSize=128M -Xnolinenumbers -cp plugins\org.eclipse.equinox.launcher_1.0.100.v20080509-1800.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v75.ide > trace.txt 2>&1


    Note:     The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) may change in various fix pack releases of the product. When launching this command please ensure that the latest plug-in version is added to the classpath argument.

  4. Reproduce the issue that is occurring and close the application after the issue has been reproduced.

    Note: The trace will be generated in a trace.txt file in the install directory (E.G C:\Program Files\IBM\SDP)

  5. Send in the trace.txt file to support for analysis.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Integrations: WebSphere\/RAD","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;7.0;7.0.1;7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Integration","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSJMXE","label":"IBM Rational Functional Tester"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Integration","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21266287

Page Feedback