PI30487: MISSING BIRT DEPLOYMENT DOCUMENTATION AND REFERENCE TO SCRIPTS ON TECHNOTE: 1566463 IS INCOMPLETE

Rational ClearQuest Fix Pack 9 (8.0.1.9) for 8.0.1
Rational ClearQuest Fix Pack 10 (8.0.1.10) for 8.0.1
Rational ClearQuest Fix Pack 11 (8.0.1.11) for 8.0.1
Rational ClearQuest Fix Pack 12 (8.0.1.12) for 8.0.1
Rational ClearQuest Fix Pack 13 (8.0.1.13) for 8.0.1
Rational ClearQuest Fix Pack 14 (8.0.1.14) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.1.15) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.1.16) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.1.17) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.1.18) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.1.19) for 8.0.1
Rational ClearQuest Fix Pack 20 (8.0.1.20) for 8.0.1
Rational ClearQuest Fix Pack 21 (8.0.1.21) for 8.0.1
Rational ClearQuest Fix Pack 22 (8.0.1.22) for 8.0.1
Rational ClearQuest Fix Pack 23 (8.0.1.23) for 8.0.1
Rational ClearQuest Fix Pack 24 (8.0.1.24) for 8.0.1
Rational ClearQuest Fix Pack 25 (8.0.1.25) for 8.0.1

APAR status

• Closed as program error.

Error description

• The following Technote is referring to scripts to deploy BIRT
  (Business Intelligence REporting Tool)
  runtime, but no link or description about these scripts:
  
  http://www.ibm.com/support/docview.wss?uid=swg21566463
  
  The above technote is missing reference to deployment script:
  ex.  deployBIRT.bat script which I found located under
  <CQ_HOME>\reports\launcher\birt
  There is no documentation available about using this script.
  
  In the technote, the Answer section...
  "Beginning with versions 8.0.0.9 and 8.0.1.2, ClearQuest
  includes scripts to assist with the deployment and configuration
  of the BIRT runtime."
  
  The script attached to TN: copyDriverPlugins.bat is used to
  configure the BIRT Server runtime with the IBM Rational
  ClearQuest (CQ) Reporting Driver prior to v. 8.0.0.9 and
  8.0.1.2;
  "copy the following required ClearQuest Reporting JAR files to
  the BIRT server runtime environment For ClearQuest versions
  prior to 8.0.0.9 and 8.0.1.2"
  
  Where is the script to deploy BIRT runtime For ClearQuest
  versions 8.0.0.9 or higher and 8.0.1.2 or higher?
  If you check on versions prior to 8.0.0.9 and 8.0.1.2, you will
  not find the deployBIRT.bat script,  it is only available with
  8.0.0.9 or higher and 8.0.1.2 or higher.
  

Local fix

• A technote with detailed updated directions has been published
  here:
  http://www.ibm.com/support/docview.wss?uid=swg21960057
  
  This APAR used to track the updating of the InformationCenter
  documentation.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ClearQuest Reporting                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The documentation explaining how to configure BIRT reporting *
  * with WAS in order to use the ClearQuest Report driver is     *
  * incomplete.  It needs a reference to the deployment script   *
  * with an explanation on how to use it.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• The documentation explaining how to configure BIRT reporting
  with WAS in order to use the ClearQuest Report driver has been
  corrected.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  CLEARQUEST WIN

• Fixed component ID

  5724G3600

Applicable component levels

• R801 PSY

     UP