Before using this information, be sure to read the general information under Appendix. Notices.
This edition applies to IBM Rational ClearQuest Version 7.0.1.
This chapter describes new features and other changes introduced in IBM(R) Rational(R) ClearQuest(R) versions 7.0 through 7.0.1.
Before installing this release, obtain the latest version of the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide from the IBM Publications Center.
You can download the most current edition of this document from the IBM Publications Center, as follows:
The version of the release notes available from the IBM Publications Center contains the following additional chapters:
This section describes new features in this release.
Rational ClearQuest introduces feature level 6. This release supports both feature level 6 and feature level 5, so administrators can choose whether to upgrade to feature level 6. The feature level defines the set of features available for use with Rational ClearQuest applications.
Feature level 6 enables several new features by default:
However, clients and administrative tools from version 7.0 and earlier cannot access schema repositories and user databases that are raised to feature level 6; those clients must be upgraded to version 7.0.1 before moving to feature level 6. Raising the feature level is a process that requires careful deployment; you should perform this task only when adequate time and resources are available.
Note that the record ID limitation improvement was released in version 7.0. To increase the record ID limit for a feature level 5 user database, use the installutil sethighrecordlimit subcommand or simply upgrade to feature level 6.
If you raise the feature level of a user database from 5 to 6, run the timechange.pl script after performing the upgrade.
For instructions on raising the feature level and enabling these features, see the Administering Rational ClearQuest Help and the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.
IBM Rational ClearQuest provides a role-based access control (RBAC) model to enable permissions for workspace folders .
Workspace folder permissions allow administrators to control which folders users can see and modify in the workspace. Folder permissions apply only to folders, not to the individual queries or reports residing within a folder. These permissions do not apply to the Personal Queries folder or its contents.
In previous releases, all users could view everything in the Public Queries folder and its subfolders; the Public Folder Administrator privilege provided the ability to add, modify, and delete queries in that folder and all its subfolders. Because the Public Queries folder can contain subfolders for a variety of projects, many users needed the Public Folder Administrator privilege in a large Rational ClearQuest environment. These privileged users were able to make changes to queries or reports outside their project area.
In Version 7.0.1, the workspace folder permissions allows administrators to associate specific permissions for user groups with individual folders in the workspace. If no permissions are defined, all users can see and modify all public queries.
The Rational ClearQuest Client and Rational ClearQuest Client for Eclipse include the following enhancements:
This release includes the following new features in Rational ClearQuest Test Manager:
Rational ClearQuest stores multiline text fields in Oracle databases by using the Character Large Object (CLOB) data type. By default, queries on multiline text fields can only be case-sensitive.
In this release, administrators who run Rational ClearQuest on Oracle databases can now control whether users can create case-sensitive or case-insensitive multiline text queries. You enable this feature by running two SQL scripts, setup_cq_ora_user_clob.sql and setup_cq_clob_index.sql, and following additional procedures.
For more information, see http://www.ibm.com/developerworks/rational/library/07/0531_clearquest/.
Rational ClearQuest now stores history time stamps in Coordinated Universal Time (UTC), which allows you to compare times accurately across time zones. In previous releases, the time stamps that recorded the creation and modification of records always used the local time of the database server.
UTC is the default when you create or upgrade databases to feature level 6. Feature level 5 databases store history time stamps in the local time of the database server. Rational ClearQuest provides a tool for converting feature level 5 history time stamps into UTC history time stamps. For more information, see the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.
This release adds the following features to Rational ClearQuest Web:
Global scripts are intended to be used as a collection of subroutines that can be called from other hooks (such as access control hooks, initialization hooks, and validation hooks). To allow this, all global script code is included as part of the Perl code used for every hook execution. However, global script code can include statements that are outside of subroutine scope (at file scope).
Beginning in version 7.0.1, a new Perl hook enhancement that clones global scripts is available. When this enhancement is enabled, a Perl hook environment is created; all global script code is compiled and then cloned to create new hook environments. The cloning process avoids recompiling code and allows hook environments to share a parse tree. Cloning scripts saves time and memory for each Perl hook environment, which provides better performance (with significant improvements for Rational ClearQuest Web).
All product documentation is now available from an information center based on IBM Eclipse Help System (IEHS) technology and located at http://publib.boulder.ibm.com/infocenter/cqhelp/v7r0m1/index.jsp. The information center contains a search utility that can search the entire information center or only selected topics. You can also print individual topics or a hierarchy of topics. The information center contains some updated content that is not in the media version of the product. In previous releases, updated content was published in the Documentation updates chapter of the IBM Rational ClearQuest and ClearQuest MultiSite Release Notes.
This release introduces the Rational ClearQuest Client, which is the Eclipse Rich Client Platform (RCP) client. This client does not require you to install an Eclipse Integrated Development Environment (IDE) and provides a consistent user interface on Windows(R), Linux(R), Solaris, and AIX(R). It provides the same capabilities as those available with the existing Rational ClearQuest Client for Eclipse (the Eclipse plug-in client), including the enhancements introduced in this release.
The Rational ClearQuest Client for Eclipse includes the following enhancements:
The Rational ClearQuest Web client has been enhanced to include the following features:
Rational Web Platform (RWP) is now based on the Embedded version of WebSphere(R) Application Server Express. In addition, you can perform Web server load balancing by using the plugin-cfg method.
Rational ClearQuest Test Manager supports test management with Rational ClearQuest, as follows:
In addition, you can use the RequisitePro(R) Version 1.8 package to provide lifecycle traceability for the requirement to test plan, test case, configured test case and test suite relationships. Rational ClearQuest Test Manager also includes a tutorial.
This release includes a Deployment tracking feature, which enables you to use Rational ClearCase(R) and Rational ClearQuest to track software assets in your specific software testing environments throughout the deployment lifecycle. Highlights of deployment tracking:
Three new packages enable deployment tracking:
In previous releases, the maximum number of database record IDs was approximately 16 million. For stateless records, the new limit is approximately 2 billion; for stateful records, it is approximately 100 million. For databases that use site-ID values of 2 or greater (these are old databases), the upper limits are smaller.
To increase the record ID limit for a user database, use the new installutil sethighrecordlimit subcommand. For instructions about increasing the record ID limit, see IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.
For information about the implications of this feature for replicated databases, see the sections of this document about Rational ClearQuest MultiSite.
This release adds support for using Secure Socket Layers (SSL) protocol with Lightweight Directory Access Protocol (LDAP) user authentication. SSL encrypts data sent between clients and servers, such as Rational ClearQuest clients or the Rational ClearQuest Web Request Manager and LDAP servers. You can use SSL to ensure that communication between Rational ClearQuest clients and the LDAP directory server is secure and private. For more information, see the Administering Rational ClearQuest online help.
The Rational ClearQuest Web request manager recycling feature shuts down and restarts the request manager process without interrupting user sessions.
In this release, Rational ClearQuest connects directly to the DB2(R) server, which eliminates the need to install the DB2 client on Rational ClearQuest clients. However, there is no need to uninstall the DB2 client if it is installed; other applications might be using it, and Rational ClearQuest ignores any DB2 client that is installed on a computer where a Rational ClearQuest client or the Rational ClearQuest Web server request manager process is running.
The Rational ClearQuest Diagnostics utility examines your schema repository and user databases and identifies conditions that might cause integrity or performance problems. The purpose of the utility is to help you quickly diagnose the source of database integrity problems so that you can repair your schema repository and user database. The utility generates log and results files that document the analysis and include a summary of the execution results. For more information about using the utility see the Administering Rational ClearQuest online help.
The tool supports validation of the following database platforms:
Rational ClearQuest has extended its character set (code page) support as follows:
The documentation has been substantially revised and reorganized:
A new Rational ClearCase and Rational ClearQuest Performance page is now available on the IBM developerWorks(R) web site at http://www-128.ibm.com/developerworks/rational/performance/. This page contains white papers, technical notes and performance benchmarks for current Rational ClearCase and Rational ClearQuest releases. This information helps you evaluate your existing Rational ClearCase and ClearQuest installations as well as the existing hardware and network infrastructure.
Perl 5.8.6 and related Perl modules are distributed with this release and are available at www.cpan.org. In conformance with the Artistic License Agreement under the terms of which Perl is distributed, the following table describes the modifications that were made to Perl version 5.8.6. The same modified version of Perl 5.8.6 is distributed with multiple IBM Rational products; the table describes all modifications, not just those made in support of Rational ClearQuest.
| Source files modified | Reason for modification |
|---|---|
| C code changes | |
| perl.c | Fixed environment handling in a multithreaded environment. Fixed bug on Linux MVFS where $^X ends up pointing to the view storage container of Perl. |
| util.c | Fixed environment handling in a multithreaded environment. |
| win32/win32.c | Changed the lookup of the lib folders to match the UNIX names and directory structure. |
| utf8.c | Fixed compile problem. |
| encGlue.c | Fixed crash on Solaris (from April 8, 2005 posting on comp.lang.perl.tk) |
| Changes to support building and packaging with Rational ClearCase software | |
| lib/ExtUtils/MM_Unix.pm, lib/ExtUtils/MM_Win32.pm, lib/ExtUtils/MakeMaker.pm, ext/SDBM_File/Makefile.PL | Support building with clearmake and omake. |
| Configure, Makefile.SH, win32/Makefile, installperl, win32/bin/pl2bat.pl, win32/config.bc, win32/config.gc, win32/config.vc | Updated to change the name of perl to ratlperl and libperl.so to libratlperl.so. Changed to support linking with the C++ compiler. |
| Miscellaneous changes | |
| ext/DynaLoader/hints/aix.pl | Enabled use of native dlopen on AIX 4.3.3 or later. |
| hints/aix.sh | Support for fix of environment handling in a multithreaded environment. |
| win32/buildext.pl | Added -I../lib when calling pl2bat.pl. |
In previous releases on UNIX, you could use either of two commands to display product version information: clearquest -version or clearquest version. Beginning with this release, you must use only clearquest -version.
Beginning in release 7.0.0.1, the following Rational ClearQuest clients and administration tools support Windows Vista Business, Windows Vista Enterprise, and Windows Vista Ultimate:
The product includes DataDirect drivers for connectivity to Oracle, SQL Server, and DB2 databases.
The following clients are supported:
The following client functionality is no longer provided:
The Rational Web Platform (RWP) is supported only on server platforms; it is not supported on Windows XP.
The MAPI messaging protocol is no longer supported by the Rational ClearQuest MailReader. MAPI is supported for e-mail notification only in matching code page deployments.
This release supplies Business Objects Crystal Reports XI components for executing reports. Crystal Reports designer V10 and XI are supported for authoring reports. To define report formats, you must obtain Crystal Reports with Crystal Reports Designer (For more information, see http://www.businessobjects.com/). The Crystal Reports Designer tool is supported on the Rational ClearQuest for Windows client only, and the report format definitions are stored in the Rational ClearQuest database.
Rational ClearQuest includes runtime support for Crystal Reports Version XI, which you can use to generate reports from report formats that have been defined using either Version 10 or Version XI.
Documentation delivered in PDF format with this release is also available in HTML format from the IBM Publications Center.
This chapter describes new features and other changes introduced in IBM Rational ClearQuest MultiSite version 7.0. The 7.0.1 release contains no new ClearQuest MultiSite features.
New features in this release include the following:
Multiutil: Error: The renamesite command has not been enabled.For more information on this command, see the IBM Rational ClearQuest MultiSite Administrator's Guide.
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/.
The IBM Support Assistant (ISA) is a locally installed serviceability workbench that makes it both easier and simpler to resolve software product problems. ISA is a free, stand-alone application that you download from IBM and install on any number of machines. It runs on AIX, (RedHat Enterprise Linux AS), HP-UX, Solaris, and Windows platforms.
ISA includes these features:
For more information about ISA, including instructions for downloading and installing ISA and product plug-ins, go to the ISA Software Support page.
IBM Support Assistant: http://www.ibm.com/software/support/isa/
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 grant 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, 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 OR IMPLIED, 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 Web sites. 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 document 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.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
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.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(c) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (c) Copyright IBM Corp. _enter the year or years_. All rights reserved.
Additional legal notices are described in the legal_information.html file that is included in your Rational software installation.
Trademarks
AIX, ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearGuide, ClearQuest, DB2, DB2 Universal Database, DDTS, Domino, IBM, Lotus Notes, MVS, Notes, OS/390, Passport Advantage, ProjectConsole Purify, Rational, Rational Rose, Rational Suite, Rational Unified Process, RequisitePro, RUP, S/390, SoDA, SP1, SP2, Team Unifying Platform, WebSphere, XDE, and z/OS are trademarks of International Business Machines Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names may be trademarks or service marks of others.