Copying the Java runtime files for the ClearQuest Reporting Driver

To provide Crystal Reports with ClearQuest authenticated access to ClearQuest data sources, copy the required ClearQuest Reporting Driver plug-ins installed with any ClearQuest feature to a directory accessible to the Crystal Reports application.

Before you begin

The ClearQuest Reporting Driver is packaged as an Eclipse plug-in archive named:
com.ibm.rational.clearquest.jdbc_<version>.<timestamp>.jar
This plug-in archive is installed automatically with any ClearQuest component. If you have not installed any ClearQuest features on the system you are configuring, use the Rational Installation Manager to install one.

About this task

These variables are used in path names in this topic:
CQReportDriver-dir
Directory where the ClearQuest Reporting Driver runtime files are installed.
timestamp
Time stamp associated with the build of the archive file
%RATIONAL_COMMON%
Directory where Rational common files are installed
%CLEARQUEST_HOME%
Directory where Rational ClearQuest is installed
Attention: You must have at least one ClearQuest feature installed on your system to complete the tasks in this topic.

Procedure

To obtain the required files for the ClearQuest Reporting Driver:

  1. Open a command prompt window.
  2. Create a directory in which to store the ClearQuest Reporting Driver runtime files:
    mkdir CQReportDriver-dir
  3. Navigate to the new directory:
    cd CQReportDriver-dir
  4. Run these statements to copy the required ClearQuest Reporting Driver runtime files into the new directory.
    copy "%CLEARQUEST_HOME%\reports\driver\plugins\com.ibm.rational.clearquest.jdbc_version.jar" cqjdbc.jar
    copy "%CLEARQUEST_HOME%\cqjni.jar"
    copy "%RATIONAL_COMMON%\stp*.jar"
    When you run these commands, you will see output similar to these statements:
    C:\CQReportDriver-dir>copy "C:\Program Files\ibm\RationalSDLC\ClearQuest\reports\driver\plugins\com.ibm.rational.clearquest.jdbc_version.jar" cqjdbc.jar 
    
    C:\CQReportDriver-dir>copy "c:\Program Files\ibm\RationalSDLC\ClearQuest\cqjni.jar"
    
    1 file(s) copied.
    
    C:\CQReportDriver-dir>copy "c:\Program Files\ibm\RationalSDLC\common\stp*.jar"
    C:\Program Files\ibm\RationalSDLC\common\stpclientws.jar
    C:\Program Files\ibm\RationalSDLC\common\stpcmmn.jar
    C:\Program Files\ibm\RationalSDLC\common\stpcq.jar
    C:\Program Files\ibm\RationalSDLC\common\stpwvcm.jar
    4 file(s) copied.
    
    C:\CQReportDriver-dir> 

What to do next

Update the Crystal Reports configuration file with path information for the ClearQuest Reporting Driver files..

Feedback