IBM Support

How to trace Rational Application Developer for WebSphere Software

Question & Answer


Question

How do you enable tracing to capture more information about a product failure in IBM® Rational Application Developer for WebSphere Software?

Cause

Tracing within Rational Application Developer is done at a plug-in level when the -debug command line argument is specified and a '.options' file is created to instruct the product which plug-in tracing to enable.

Answer

This document describes how to enable this tracing framework so that the output can be easily captured and provided to the IBM® support team for diagnosis.
Rational Application Developer 9.1
Rational Application Developer 9.0
Rational Application Developer 8.5
Rational Application Developer 8.0
 
Rational Application Developer 9.1

Procedure:
 
  1. Ensure that the product is stopped.
     
  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM® support. Save this file into the product installation directory (i.e. <install>/SDP91/).
  3. Start the product using the following command from command line within the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx96m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=512M -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.3.0.v20120522-1813.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v91.ide > trace.txt 2>&1

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

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v91.ide -debug > trace.txt 2>&1
     
  4. The command in step (3) will start Rational Application Developer v9.1, allowing the problem to be reproduced. The plug-in tracing information is captured into the <install>/SDP91/trace.txt file which can be provided to IBM® support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 9.0

Procedure:
 
  1. Ensure that the product is stopped.
     
  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM® support. Save this file into the product installation directory (i.e. <install>/SDP90/).
  3. Start the product using the following command from command line within the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx96m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=512M -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.3.0.v20120522-1813.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v9.ide > trace.txt 2>&1

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

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v9.ide -debug > trace.txt 2>&1
     
  4. The command in step (3) will start Rational Application Developer v9.0, allowing the problem to be reproduced. The plug-in tracing information is captured into the <install>/SDP90/trace.txt file, which can be provided to IBM® support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 8.5

Procedure:
 
  1. Ensure that the product is stopped.
     
  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM® support. Save this file into the product installation directory (i.e. <install>/SDP85/).
  3. Start the product using the following command from command line within the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx48m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=128M -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Djava.util.Arrays.useLegacyMergeSort=true -Dosgi.requiredJavaVersion=1.5 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v85.ide > trace.txt 2>&1

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

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v85.ide -debug > trace.txt 2>&1
     
  4. The command in step (3) will start Rational Application Developer v8.5, allowing the problem to be reproduced. The plug-in tracing information is captured into the <install>/SDP85/trace.txt file, which can be provided to IBM® support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 8.0

Procedure:
 
  1. Ensure that the product is stopped.
     
  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM® support. Save this file into the product installation directory (i.e. <install>/SDP80/).
  3. Start the product using the following command from command line within the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx48m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=128M -Xverify:none -Declipse.p2.verifyPlan=false -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Dosgi.requiredJavaVersion=1.5 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v80.ide > trace.txt 2>&1

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

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v80.ide -debug > trace.txt 2>&1
     
  4. The command in step (3) will start Rational Application Developer v8.0, allowing the problem to be reproduced. The plug-in tracing information is captured into the <install>/SDP80/trace.txt file, which can be provided to IBM® support (via ESR or by FTP) to further diagnose the problem.

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"ARM Category":[{"code":"a8m0z000000bm08AAA","label":"Rational Application Developer"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Version(s)"}]

Document Information

Modified date:
08 October 2020

UID

swg21327307