IBM Support

How to trace the UCM integration with ClearQuest on UNIX or Linux

Question & Answer


Question

How do you set trace flags to debug the IBM Rational ClearCase UCM integration with IBM Rational ClearQuest to troubleshoot the integration on UNIX and Linux?

Answer

To trace the ClearCase UCM integration with ClearQuest, the following environment variables need to be set:



    CQ_DIAG_TRACE

    CQ_DIAG_REPORT

    CQ_DIAG_OUTPUT

    SQUID_TRACE

    SQUID_TRACE_FILE





Example (c shell on UNIX or Linux):


    setenv CQ_DIAG_TRACE "DB_CONNECT=3;THROW;SQL=3;CQINTSVR"

    setenv CQ_DIAG_REPORT "MESSAGE_INFO=0X1309"

    setenv CQ_DIAG_OUTPUT "/tmp/CQ_SQUID.log"

    setenv SQUID_TRACE "*"

    setenv SQUID_TRACE_FILE "/tmp/CQ_SQUID.log"



Example (k shell on UNIX or Linux):


    export CQ_DIAG_TRACE="DB_CONNECT=3;THROW;SQL=3;CQINTSVR"

    export CQ_DIAG_REPORT="MESSAGE_INFO=0X1309"

    export CQ_DIAG_OUTPUT="/tmp/CQ_SQUID.log"

    export SQUID_TRACE="*"

    export SQUID_TRACE_FILE="/tmp/CQ_SQUID.log"


Note: These variables will enable the ClearQuest and SQUID tracing. Make sure that the values for CQ_DIAG_OUTPUT and SQUID_TRACE_FILE are the same location. You can use any valid CQ Diagnostic flags for the CQ_DIAG_* parameters.



Once the variables are set, run the command again that had failed. If you need to use the GUI such as xclearcase or clearquest, launch the GUI from the same shell that you used to set the Env variables.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: ClearQuest Integration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"7.0;7.0.1;7.1;7.1.1","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":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
01 August 2018

UID

swg21127287