Rational ClearQuest Client for Eclipse, Version 6.15.0, Release Notes

First Edition (August 2005) This edition applies to Rational ClearQuest Client for Eclipse, Version 6.15.0 and to all subsequent releases and modifications until otherwise indicated in new editions.

Copyright International Business Machines Corporation 1997, 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

1.0 About this release
   1.1 Product compatibility 
2.0 Installation, upgrade, and configuration information
   2.1 Hardware and software requirements
   2.2 Installation and update notes
3.0 Known limitations, problems, and workarounds
   3.1 Limitations
      3.1.1 Creating or modifying dynamic choice lists is not supported.
      3.1.2 Submit record defaults created in the Native client is not compatible with the CQEC Record Template feature
      3.1.3 Charts and reports are not fully supported on Windows.
      3.1.4 Batch record update with mixed record types is not supported.
      3.1.5 ActiveX and Picture form controls are not available.
      3.1.6 MultiSite is not fully supported.
      3.1.7 Linux-specific limitations
      3.1.8 Column sorting is disabled for SQL queries
      3.1.9 Radio button controls and grouped fields are not printed
      3.1.10 Query default display fields and filters are not shared with the Native client
      3.1.11 Email notification rules are not cached
      3.1.12 Login fails with license error on Solaris 9
   3.2 Known problems and workarounds
      3.2.1 Drag and drop of queries between connections is not supported.
      3.2.2 A failed record script action results in an exception if the scripting language is Perl.
      3.2.3 Working with attachments
      3.2.4 Installation and uninstallation
      3.2.5 Setting remotely mastered personal workspace objects to run at startup causes an error.
      3.2.6 SQL Queries with the same column names display incorrect data.
      3.2.7 ClearQuest preferences can not be edited because the necessary capability is disabled
      3.2.8 The OK button on the record form is not enabled when completing required fields
      3.2.9 Linux-specific issues
      3.2.10 "Can not restore workbench layout" error message is shown when starting Eclipse.
      3.2.11 Performing actions during startup object execution may cause unexpected behavior
      3.2.12 Multiline sorting is not supported
      3.2.13 Using "New Window" to launch a second workbench may cause some problems            
      3.2.14 Chart set to run at startup may result in a workbench crash while logging into a database 
      3.2.15 Running some reports may result in a workbench hang
      3.2.16 Email notifications for the first and second submitted records are not sent
      3.2.17 Performing batch update of records may fail if the records contain different values for certain fields
     3.2.18 Cannot perform Save As... action on modified queries
     3.2.19 Email notification errors may occur when submitting or modifying records on Linux
4.0 Contacting customer support

1.0 About This Release

The Rational ClearQuest Client for Eclipse provides seamless integration between ClearQuest and Eclipse, using native Eclipse interface techniques. Eclipse views exist for ClearQuest workspace navigation, query results, record details and charting. Several standard Eclipse views are leveraged, such as Properties and Console.

Many common IBM(R) Rational(R)ClearQuest(R) tasks are streamlined within Eclipse. Change requests can be submitted from various integration points, such as the main tool bar, the Task or Problems view, or editor markers and resources from navigation-style views. Using the query wizard, or previously defined personal and shared team queries, change requests are identified and listed. The previously defined queries can be enabled to run at login. For example, a query that finds all defects assigned to you runs when you login, automatically creating your ToDo list. From the query results, you can then update or change the state of change requests as needed.

These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file as well as translated versions of this file are available in the IBM Publications Center at http://www.ibm.com/shop/publications/order. Search for "ClearQuest + Eclipse" to find the latest version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to http://www.ibm.com/ and enter "IBM Publications Center" in the Search field.)

 

1.1 Product Compatibility

IBM Rational ClearQuest is a customizable defect and change tracking system that organizes and automates the processes involved in submitting, assigning, tracking, testing and releasing change requests. In order to use the Rational ClearQuest Client for Eclipse, you must install and configure the basic Rational ClearQuest application (version 2003.06.15). Contact your local Rational ClearQuest administrator to find out how to install and configure your Rational ClearQuest client application and establish a connection to a database.

2.0 Installation, upgrade, and configuration information

Before installing the Rational ClearQuest Client for Eclipse, the Rational ClearQuest basic application must be installed and configured properly. If necessary, consult ClearQuest product documentation for installation and configuration details. You must have a current Rational ClearQuest license to configure and run the basic application.

In order to install the Rational ClearQuest Client, you must have a compatible Eclipse installation (Eclipse 3.0.2 or greater, or a Rational Software Development Platform product). If you are not using a Rational Software Development Platform product, the Eclipse Modeling Framework (EMF) installed. You can install EMF using the following steps:

- Start Eclipse
- Select Help-> SoftwareUpdates...->Find and Install
- Select Search for new features to install, then click Next
- Expand the Eclipse.org update site, and select EMF SDK 2.0.0 (EMF + SDO + XSD), then click Next
- Select the feature Eclipse Modeling Framework (EMF) version 2.0.0, then click Next
- Accept license terms, and click Next
- Click Finish to install

For more information, refer to the EMF portion of Eclipse.org (http://www.eclipse.org/emf/).

You can install the integrated Rational ClearQuest Client in two different ways: by connecting to a publicly available IBM Rational Update Manager Web site or from a locally installed Eclipse Update Manager site.

Installing Rational ClearQuest Client for Eclipse from a publicly available IBM Rational Eclipse Update Manager Web site

  1. In any Eclipse perspective, select Help > Software Updates > Find and Install.
  2. In the Install/Update window, select Search for new features to install. Click Next. (Rational Software Development Platform products will have the necessary update site already listed, and may proceed to step 5.)
  3. In the Install window, click New Remote Site.
  4. In the New Update Site window, type a name for the update site you are creating, such as Rational ClearQuest.
    1. In the URL field, type the Web address that provides access to the Rational ClearQuest Client for Eclipse code: http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/clearquest/60/update/
    2. Click OK to create the update site listing.
  1. Select the check box next to the site name (such as Rational ClearQuest). If there is more than one installable feature available at the update site, click the plus sign next to the site name to list all the features.
  2. Select Rational ClearQuest as the feature you wish to install. Click Next.
  3. In the Search Results window, select the latest installable version, then click Next to continue.
  4. When the Feature License window is displayed, read the licensing information, then select I accept the terms in the license agreements. Click Next to continue.
  5. In the Install Location window, click Add site, then select a location where the Rational ClearQuest Client for Eclipse application will be installed. Click Finish to continue.
  6. In the Feature Verification window, click Install to begin downloading the Rational ClearQuest Client for Eclipse files.
  7. After the installation is complete, Eclipse displays the following message: You will need to restart Eclipse for the changes to take effect. Would you like to restart now? If you are adding or updating other features, click No and install or update the next feature. If you have completed all feature installs, click Yes.

Installing Rational ClearQuest Client for Eclipse from a locally installed Eclipse Update Manager site

The integrated Rational ClearQuest Client for Eclipse is available for download from either the IBM Rational Software Support home page or from Rational developerWorks. To download the client, visit the following URL, click the ClearQuest Plug-ins link and then click the Rational ClearQuest Client for Eclipse link: http://www.ibm.com/developerworks/rational/library/1376.html. You can also go to the Rational Software Support home page (http://www.ibm.com/software/rational/support/) and search for "ClearQuest Client for Eclipse" to find the Eclipse client download. Click on the Downloads option below the search box to limit the number of search results returned. On the download Web page, a copy of the Eclipse Update Manager site is available as a zip file. This can be used to host a standalone Eclipse Update Manager site.

  1. Download the CQEclipseClient_6_15_0.zip file
  2. Extract the zip file to a directory on a single user machine or on a network accessible file share for access by multiple users.
  3. In any Eclipse perspective, click Help > Software Updates > Find and Install.
  4. In the Install/Update window, select Search for new features to install. Click Next.
  5. In the Install window, click New Local Site.
  6. Browse to the location where you extracted the CQEclipseClient_6_15_0.zip file and select the directory containing the site.xml file. Click OK.
  7. Select the check box next to the site name just added. If there is more than one installable feature available at the update site, click the plus sign next to the site name to list all the features.
  8. Select Rational ClearQuest as the feature you wish to install. Click Next.
  9. In the Search Results window, select the latest installable version, then click Next to continue.
  10. When the Feature License window is displayed, read the licensing information, then select I accept the terms in the license agreements. Click Next to continue.
  11. In the Install Location window, click Add site, then select a location where the Rational ClearQuest Client for Eclipse application will be installed. Click Finish to continue.
  12. In the Feature Verification window, click Install to begin downloading the Rational ClearQuest Client for Eclipse files.
  13. After the installation is complete, Eclipse displays the following message: You will need to restart Eclipse for the changes to take effect. Would you like to restart now? If you are adding or updating other features, click No and install or update the next feature. If you have completed all feature installs, click Yes.

2.1 Hardware and software requirements

Hardware

-  Disk space: Installed product requires 500 MB

-  Memory: 256 MB

-  CPU: 500 MHz

Software

-  Operating systems:
- Windows 2000 Professional (SP 4)
- Windows XP Professional (SP1 or SP2)
- Windows 2003 Server
- RedHat Enterprise Linux(R) 3.0 Workstation - using the GTK version of Eclipse
- SUSE(R)Linux Enterprise Server 9 (SLES) - using the GTK version of Eclipse

-  Eclipse application:
- Eclipse development platform 3.0.2 or greater
- Rational Software Development Platform

 

2.2 Installation and update notes

In order to improve responsiveness of the Eclipse application, increase the amount of memory allocated to Eclipse. For example, to enable Eclipse to use a maximum of 256 MB of RAM, simply add this parameter to eclipse.exe: -vmargs -Xmx256m.

To use the Rational ClearQuest Client for Eclipse on a Linux system, run the Rational ClearQuest setup shell prior to starting Eclipse. When starting Eclipse, if you see the message IBM Rational ClearQuest is either not installed or not configured properly, check to make sure the ClearQuest setup shell is active. By default, the setup shell is located in /opt/rational/clearquest/cq_setup.sh. When using the IBM JRE version 1.4.2 with this product, specify the arguments -vmargs -Xj9 when starting Eclipse. Refer to the readme file that accompanies the IBM JRE for more information.

3.0 Known limitations, problems, and workaround

3.1 Limitations

3.1.1 Creating or modifying dynamic choice lists is not supported

Creating or modifying dynamic choice lists is not supported.

3.1.2 Submit record defaults created in the Native client is not compatible with the Clear Quest Client for Eclipse record template feature

ClearQuest Client for Eclipse uses a different set of default options for the Submit record action than the Native client. When you change the default submit record options in either client, they will not be saved in the other one.

3.1.3 Charts and reports are not fully supported on Windows

Charts and reports are not fully supported. The following list provides details on supported items:

3.1.4 Batch record update with mixed record types is not supported

Performing a batch update of records that includes mixed record types is not supported. The workaround is to select only one type of record when performing a batch update.

3.1.5 ActiveX and Picture form controls are not available

ActiveX and Picture form controls are not supported. This limits certain capabilities such as custom ActiveX controls and integrations with other Rational products like ClearCase UCM change set control.

3.1.6 MultiSite is not fully supported

Full MultiSite function is not supported. You cannot change the mastership of a workspace object such as a folder, query, chart, report or report format.

3.1.7 Linux-specific limitations

3.1.8 Column sorting is disabled for SQL queries

Once a query is converted to a SQL query, clicking the columns titles does not sort the results.

3.1.9 Radio button controls and grouped fields are not printed

Printing is currently not supported for form values listed in a radio button control.

3.1.10 Query default display fields and filters are not shared with the Native client

Query default display fields and filters set in the ClearQuest Client for Eclipse are not used by the Native client.  However, the default display fields and filters are shared with ClearQuest Web Java (CQWJ).

3.1.11 Email notification rules are not cached.

Email Rule caching is disabled in the ClearQuest Client for Eclipse.

3.1.12 Login fails with license error on Solaris 9 

    On Solaris 9, there is an issue with cqjni which results in a login failure. The failure results in a Flexlm error.
To workaround this problem, run the following command before starting Eclipse: limit -h descriptors 1024.

3.2 Known problems and workarounds

3.2.1 Drag and drop of queries between connections is not supported.

Drag and drop of queries or workspace objects between different Rational ClearQuest connections in the Query Navigator view is not supported.

3.2.2 A failed record script action results in an exception if the scripting language is Perl.

If a record script alias is executed and fails, and the scripting language is Perl, an exception results. Record scripts written in Visual Basic do not have this problem.

3.2.3 Working with attachments

3.2.4 Installing and uninstalling

Errors are displayed when restarting Eclipse after uninstalling ClearQuest Client.

Errors may occur during uninstall which prevent a proper removal of the ClearQuest Client. To avoid these errors, close the ClearQuest perspective and disable the ClearQuest feature prior to uninstalling the ClearQuest feature.

Eclipse does not restart after installing ClearQuest Client.

There is a known bug in Eclipse 3.0.2 which sometimes prevents Eclipse from automatically restarting after installing the ClearQuest Client. The workaround is to restart Eclipse manually, either by double-clicking eclipse.exe in the directory where Eclipse is installed, or using the Eclipse desktop shortcut, if you created one.

Uninstalling the Rational ClearQuest Client for Eclipse results in an error message.

When you uninstall the Rational ClearQuest Client for Eclipse, a dialog may be displayed with the following error message: The current configuration contains errors and this operation can have unpredictable results. Do you want to continue?. You can ignore this error and click OK to continue uninstalling.

3.2.5 Setting remotely mastered personal workspace objects to run at startup causes an error.

When using MultiSite, if you set a remotely mastered personal workspace object (such as a query or chart) to run at startup, an error occurs. The workaround is to set the object to run at startup again. The operation should be successful when re-executed.

3.2.6 SQL Queries with the same column names display incorrect data.

If a SQL query has column titles of the same name, then the data shown in the columns will have the same values. The workaround is to execute a parameterized version of the query.

3.2.7 ClearQuest preferences can not be edited because the necessary capability is disabled

When editing Eclipse preferences, if the Team node does not appear, then Team capability needs to be enabled. To do this, in the Preferences dialog, go to Workbench > Capabilities and enable ClearQuest Defect and Change Tracking capability, which will also enable Team activity.

3.2.8 The OK button on the record form is not enabled when completing required fields

If the OK button is not enabled even though all required data is entered, move the input focus to another field. This only occurs when the final field in which data was entered was a required field, as validation is checked after a user leaves that field.

3.2.9 Linux-specific issues

3.2.10 "Can not restore workbench layout" message is shown when starting Eclipse.

Use the Window > Reset perspective menu option to eliminate this error message.

3.2.11 Performing actions during startup object execution may cause unexpected behavior

Performing ClearQuest actions during startup object execution may cause exceptions to occur. To avoid these exceptions, wait for the startup object execution to finish before performing ClearQuest actions.

3.2.12 Multiline sorting is not supported

If a multiline field is included in the Query Result view, user cannot sort that field by clicking the column title.

3.2.13 Using "New Window" to launch a Second workbench may cause problems

Launching a second workbench while another workbench is already running is not recommended. It may cause some of the following problems:

- One of the workbenches will have its navigator view disabled.
- Running a query in one will display the result in the other workbench's view.
- On Linux, closing the second workbench will cause the first workbench to be closed as well.

3.2.14 Chart set to run at startup may result in workbench crash while logging into a database

In some cases, a particular startup chart may cause the workbench to crash during login. If this occurs, modify the chart to not run during startup.

3.2.15 Running some reports may result in a workbench hang

Certain reports may cause the workbench to hang (become non-responsive).

3.2.16 Email notifications for the first and second submitted records are not sent

Email notification may not occur on first and sometimes second submitted records. All subsequent submitted records will send notifications.

Please note that ClearQuest has shipped a new Email package (7.0) with this release. The above scenario is based on having applied the new Email package to the ClearQuest schema. Please refer to the ClearQuest Release Notes under the section "Updated ClearQuest Packages" for more information.

3.2.17 Performing batch update of records may fail if the records contain different values for certain fields

Performing batch update of records may fail if the records contain different values for certain fields. The work around is to update each record individually, or to perform a batch update using the Native client.

3.2.18 Cannot perform Save As... action on modified queries

The Eclipse client does not support the same Save As... function as the Native client. In the ClearQuest Client for Eclipse, perform the following steps to achieve the same result:

  1. Copy the query and paste it into the desired folder.
  2. Modify the query as desired.
  3. Rename and then save the query.

3.2.19 Email notification errors may occur when submitting or modifying records on Linux

Forms containing checkboxes associated with an INT field type may not correctly set values in the submitted or modified records. As a result, the record may contain an empty value where an integer value is expected. This is a known issue with UCM_Project and Email_Rule record types. As a result, these records should be created or modified using the native or web client.

Due to this issue, if Email_Rules are created with the ClearQuest Client for Eclipse, it may result in email notification errors when submitting or modifying records on Linux. The error message is "Execution of a hook failed during the action Submit. It was the ACTION_NOTIFICATION hook attached to the record "recordid". The reason for the failure was: The String "" cannot be interpreted as an integer. Cannot convert an empty string to an integer value at /opt/rational/clearquest/rhat_x86/shlib/CQPerlExt.pm line 1334."

4.0 Contacting customer support

If you have questions about installing, using, or maintaining this product, contact IBM Customer Support as follows:
The IBM software support Internet site provides you with self-help resources and electronic problem submission.
The IBM Software Support Home page for Rational products can be found at http://www.ibm.com/software/rational/support/.
Voice Support is available to all current contract holders by dialing a telephone number in your country (where available).
For specific country phone numbers, go to http://www.ibm.com/planetwide/.
Note: When you contact IBM Customer Support, please be prepared to supply the following information: Your name, company name, ICN number, telephone number, and e-mail address, your operating system, version number, and any service packs or patches you have applied v Product name and release number v Your PMR number (if you are following up on a previously reported problem).

Notices and trademarks

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS ORIMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (I) the exchange of information between independently created programs and other programs (including this one) and (II) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
Department BCFB
20 Maguire Road
Lexington, MA 02421
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.


Trademarks

IBM, Rational and ClearQuest are trademarks of International Business Machines Corporation in the United States, other countries, or both.

Microsoft, Windows, ActiveX and Visual Basic are either registered trademarks or trademarks of Microsoft Corporation in the United States, other countries, or both.

Red Hat is a trademark of Red Hat Incorporated in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

SUSE is a registered trademark of SUSE LINUX AG, a Novell company, in the United States, other countries, or both.