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.
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
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.)
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.
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
- In any Eclipse perspective, select Help > Software Updates > Find and Install.
- 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.)
- In the Install window, click New Remote Site.
- In the New Update Site window, type a name for the update site you are creating, such as Rational ClearQuest.
- 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/
- Click OK to create the update site listing.
- 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.
- Select Rational ClearQuest as the feature you wish to install. Click Next.
- In the Search Results window, select the latest installable version, then click Next to continue.
- 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.
- 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.
- In the Feature Verification window, click Install to begin downloading the Rational ClearQuest Client for Eclipse files.
- 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.
- Download the CQEclipseClient_6_15_0.zip file
- Extract the zip file to a directory on a single user machine or on a network accessible file share for access by multiple users.
- In any Eclipse perspective, click Help > Software Updates > Find and Install.
- In the Install/Update window, select Search for new features to install. Click Next.
- In the Install window, click New Local Site.
- 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.
- 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.
- Select Rational ClearQuest as the feature you wish to install. Click Next.
- In the Search Results window, select the latest installable version, then click Next to continue.
- 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.
- 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.
- In the Feature Verification window, click Install to begin downloading the Rational ClearQuest Client for Eclipse files.
- 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.
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
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.
Creating or modifying dynamic choice lists is not supported.
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.
Charts and reports are not fully supported. The following list provides details on supported items:
- Creating charts is not supported.
- Editing existing charts is not supported.
- Running charts or reports with dynamic filters is not supported.
- Creating copies of reports and charts is supported, but not report formats.
- Copying and pasting a folder containing report formats is supported, but saving the pasted report formats is not supported.
- Running an unsaved report is not supported.
- Multiple startup charts and reports are not supported. Only one startup chart and one startup report may be executed during a login.
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.
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.
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.
- Report and chart execution are disabled on Linux.
- Printing is not supported on Linux.
- Use of the product on SuSE Enterprise Linux 9 while logged in as the root account is unsupported. Doing this will result in a product crash.
Once a query is converted to a SQL query, clicking the columns titles does not sort the results.
Printing is currently not supported for form values listed in a radio button control.
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).
Email Rule caching is disabled in the ClearQuest Client for Eclipse.
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.
Drag and drop of queries or workspace objects between different Rational ClearQuest connections in the Query Navigator view is not supported.
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.
- The open attachment function allows you to read an attachment within Eclipse. To modify an attachment, you must save the attachment to your local file system, delete it from the record, modify it locally, and then add it back to the record.
- Do not open an attachment file that is not compatible with your current operating system. For example, some files with a Linux extension cannot be opened in Microsoft Windows. If you attempt to open an incompatible file, you will see an error message such as "Problems opening editor" and/or "The file does not exist."
- If a record is set to read-only, modifications are not allowed, including adding an attachment. In the Query Results view, however, Add Attachment is still shown as a valid action. You should not try to add an attachment to a read-only record.
- Deleting two or more record attachments at once from the Query Results view will not auto refresh the attachment tree node in Results view even though they are successfully deleted.
- If you open an attachment more than once, the add attachment and delete attachment buttons sometimes become disabled. If this occurs, select a different record and then re-select the original record.
- If you currently have a file attachment open in an editing application, do not try to add the file as an attachment. This may cause Eclipse, or your editing application, to crash. Save and close the file before attaching it to a record.
- When modifying a record in details view and attempting to save an attachment, then canceling that save, will prevent a record in Modify state from being committed. The modify action should be discarded and the record re-modified, if this occurs.
- Record attachments should not use a name identical to that of any file in the Eclipse root folder (for instance, notice.html). If such a filename is used, the user will not be able to save or open that attachment.
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.
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.
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.
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.
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.
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.
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.
- The default Linux font sizes can render the labels in ClearQuest dialogs too large, which results in the labels being truncated. The workaround is to decrease the Linux desktop application font size.
- Dialogs containing group boxes with labels sometimes exhibit incorrect positioning of controls, which results in truncated form controls. The workaround is to update the ClearQuest schema and remove the label on the group box.
- When running on Red Hat Enterprise Linux 3.0, items displayed in the Query Results view cannot be expanded or collapsed by clicking on the plus sign icon. The workaround is to right-click and then use the context sensitive menu to select Expand Selected, or use the Collapse All toolbar button.
- Using the creator tool item menu option during the execution of multiple large queries is not recommended.
- E-mail options are not saved on Linux.
- When using the combo box control on Linux, user-entered values that do not match the values already present in the choice list are discarded when the user tabs out of the control.
Use the Window > Reset perspective menu option to eliminate this error message.
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.
If a multiline field is included in the Query Result view, user cannot sort that field by clicking the column title.
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.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.
Certain reports may cause the workbench to hang (become non-responsive).
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.
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.
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:
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."
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 LicensingFor 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 CorporationThe 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 CorporationSuch 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.
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.