Rational ClearQuest Client for Eclipse, Version 6.14.0, Release Notes

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

Copyright International Business Machines Corporation 1997, 2004. 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 
   1.2 New in this release
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.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 A reference field with a large number of values causes Eclipse to hang.
      3.2.11 "Can not restore workbench layout" error message is shown when starting Eclipse.
      3.2.12 Manipulating reports prevents the release of database connections and licenses
      3.2.13 Performing actions during startup object execution may cause unexpected behavior
      3.2.14 Multiline sorting is not supported
      3.2.15 Records are not marked "Deleted" if the first column is not the unique key
      3.2.16 Eclipse Integration
      3.2.17 Using "New Window" to launch a second workbench may cause some problems            
      3.2.18 Chart set to run at startup may result in a workbench crash while logging into a database               
      3.2.19 Running some reports may result in a workbench hang                          
      3.2.20 Email notification of submitted records requires a prior query to be run
      3.2.21 Submitting an email rule may result in a crash
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.14). 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.

1.2 New Features in this Release

Query Results View Pagination

Query Results View pagination allows the user to determine the number of records displayed per page in the Query Results view. The user may navigate from page to page by using the controls at the bottom of that view.

 

The number of records displayed per page is initially set to 100 records per page. It may be changed by the user using Window->Preferences->Team->ClearQuest->Advanced. The new preference is used when you rerun the query or execute a new query, but is not used by existing Query Result views. Setting the number of records to more than 500 records per page is not recommended and may result in slower performance.

Recently Submitted Record Query

Recently submitted record queries return records of the type that have been submitted during the current session. These queries are created automatically as records are submitted, and are listed in the ClearQuest Navigator view in the Recently Submitted folder. Only one query exists for each record type per session. Any changes to this query (filters or display fields) are persisted until the session ends.

Recently Submitted record queries are stored in a read-only folder named "Recently Submitted". No workspace objects can be created, copied/pasted, or dragged/dropped. However, queries inside this folder may be copied/pasted into a user's private folder for later use.

Record Templates

The Record Templates feature in the ClearQuest Client for Eclipse allows the user to create a set of templates per database connection and record type. Each database connection can have multiple templates for each record type creator. Record templates in the ClearQuest Client for Eclipse are analogous to field value defaults in the ClearQuest Native Client. However, record templates save the values for all the fields for the entity as is for the present state, not just the ones that have been modified. When a template is loaded, all the values from the saved template are loaded, discarding values previously entered. Record templates are not interoperable with ClearQuest Native Client defaults.

The Record Templates control is located at the bottom of any Submit dialog. The dropdown list box provides a list of previously created templates that apply to the current database and record type. The multifunction control next to this list offers the ability to load data from a template, add, delete, or rename a template, or set a template as default.

Import and Export of templates are allowed to transfer the entire set of templates to another ClearQuest Eclipse client. The Import/Export functionality is available under ClearQuest > Miscellaneous.

Report Creation and Execution

The ClearQuest Client for Eclipse supports creation and execution of reports. The process of creating a new report is similar to that of creating a new query. Select the context menu item New Report within the ClearQuest Navigator view. Follow the steps within the New Report Wizard. You will be prompted to select a record type, query, and report format to apply to the report. Once created, the report is saved within the user's workspace for later use.

Please refer to Section 3.1.3 of this document for details on how reporting in the ClearQuest Client for Eclipse differs from the ClearQuest native client.

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 or greater, or a Rational Software Development Platform product). If you are not using a Rational Software Development Platform product, you must also install the Eclipse Modeling Framework (EMF) installed. You can install EMF using the following steps:

- Start Eclipse
- Click on Help->Software Updates...->Find and Install
- Select "Search for new features to install", and click Next
- Expand the Eclipse.org update site, and select "EMF SDK 2.0.0 (EMF + SDO + XSD)", and click Next
- Select the feature "Eclipse Modeling Framework (EMF)" version 2.0.0, and 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, click 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_14_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_14_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 or greater (Eclipse 3.0.1 recommended)

- 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 CQEC Record Template feature

The ClearQuest Client for Eclipse uses a different set of defaults for the Submit record action. Changes to the defaults in the ClearQuest Client for Eclipse are not to the defaults in the ClearQuest native client, and vice-versa.

3.1.3 Charts and reports are not fully supported on Windows.

Reports and Charts are not fully supported:

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. Data fields which are grouped together are not being printed.

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.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 Installation and uninstallation

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 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 A reference field with a large number of values causes Eclipse to hang

Due to a known problem with Rational ClearQuest and a known limitation of Eclipse, when a large number of records are retrieved for a reference field query filter or control, Eclipse ceases to operate properly (hangs).

3.2.11 "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.12 Manipulating reports prevents the release of database connections and licenses

The database connection and license locked for a ClearQuest database are not released upon logout if reports are manipulated. To release the database connection and license, restart the Eclipse workbench.

3.2.13 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.14 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.15 Records are not marked "Deleted" if the first column is not the unique key

If the 1st column of the query result view is not the unique key of the record(for example, id for defects), then deleting a record from the query result list will not mark that record "deleted" and all the actions are not disabled for that record. Refresh the list will remove the deleted record.

3.2.16 Eclipse integration

Users should not create a record using Eclipse client integration without first connecting to a database. The user may do this either by logging in as normal, or by choosing the ClearQuest > New ClearQuest record... context menu option. Attempting to submit a record using the context menu option New <record type> using <database>... without being connected to any database will result in an error. If this occurs, the workbench should be restarted.

3.2.17 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.18 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.19 Running some reports may result in a workbench hang

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

3.2.20 Email notification of submitted records requires a prior query to be run

Email notification may not occur on submitted records if a query has not yet been run on the current database. If this occurs, run any query on the database before submitting a record.

3.2.21 Submitting an email rule may result in a crash

Email rules cannot be submitted on Linux using the Rational ClearQuest Client for Eclipse. They can be submitted on Windows; however, the Filter Query option within an email rule cannot be used. If problems occur, use a different ClearQuest client to submit an email rule.

4.0 Contacting customer support

To provide feedback on the Rational ClearQuest Client for Eclipse beta, or to submit a problem or issue, use the Feedback link on the beta Web page.

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.