IBM Support

Setting up tracing with the ClearCase and ClearQuest UCM integration on Windows

Question & Answer


Question

How do you configure tracing when an error occurs in the IBM Rational ClearCase and Rational ClearQuest UCM integration when using Microsoft Windows?

Answer

Enabling tracing of the ClearCase and ClearQuest UCM integration on Windows:

  1. End Task the CQINTSVR~2.exe from the Task Manager

  2. Access the Windows Registry using Start > Run... and entering Regedit 

  3. Add the following registry key:

    HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion
    \ClearCase Squid

  4. Add a string value to this key with the Name set to Trace and Value set to *
    Other valid Values for Trace:
    • <null> = no tracing
    • * = all options
    • f = Function entry/exit
    • d = DLL entry/exit
    • r = COM object ref count
    • c = CQ COM API errors
    • g = General debug traces

  5. Add a string value to this key with the NAME set to TraceFile and Value set to a file location to output the trace to a file.

  6. Close Regedit.

  7. Access dbwin32 tracing utility by selecting Start > Run and entering dbwin32

  8. Run the command that was producing the errors reported to capture the trace output from dbwin32.

  9. Save the output to a file by selecting File > Save as... in the dbwin32 utility.


The Unix environment variables will also work with Windows, it just means that the ClearCase application has to be started from a command window, rather than the Start menu.


For example: Entering the following into a command (cmd) window will cause the log to be written to c:\temp\squid.log.
    >set SQUID_TRACE="*"
    >set SQUID_TRACE_FILE="c:\temp\squid.log"
    >clearexplorer.exe

[{"Product":{"code":"SSSTXH","label":"Rational Integrations"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM ClearCase and ClearQuest","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;7.0;7.0.1;7.1;7.1.1;7.1.2","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: ClearQuest Integration","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Integrations: IBM","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21125294

Page Feedback