Before using this information, be sure to read the general information under Appendix. Notices.
This edition applies to IBM Rational ClearQuest Version 7.0 (BETA).
This chapter describes new features and other changes introduced in IBM(R) Rational(R) ClearQuest(R) Version 7.0 (BETA).
This section describes limitations that are specific to the beta test software.
For information about supported platforms and instructions for installing and configuring ClearQuest, see the IBM Rational ClearQuest and ClearQuest MultiSite Installation Guide. This manual is available at the beta test download site. Note that in the beta test version of the software
Crystal Embedded Edition for Rational Version XI is not available in beta test software.
Perl TK is not available in beta test software.
You can use the beta test software with databases that were created with older releases, but do not use beta test software against any production database.
Following are limitations on ClearQuest Test Manager beta test software:
Online documentation is limited to Help for ClearQuest Test Manager and the ClearQuest integration with Requisite Pro. The IBM Rational ClearQuest and ClearQuest MultiSite Installation Guide and these release notes are available at the beta test download site. For all other purposes, refer to Version 6.x documentation.
This section describes new features in this release.
This release introduces the Rational ClearQuest Client, which is the Eclipse Rich Client Platform (RCP) client for ClearQuest. This client does not require you to install an Eclipse Integrated Development Environment (IDE) and provides a consistent user interface on Windows, Linux, Solaris, HP-UX, and AIX. It provides the same capabilities as those provided by the existing Rational ClearQuest Client for Eclipse (Eclipse plug-in), including the enhancements to the latter client that are introduced in this release.
The Rational ClearQuest Client for Eclipse (Eclipse plug-in) includes the following enhancements:
The Rational ClearQuest Web client has been enhanced to include the following features:
ClearQuest Test Manager supports test management capabilities in ClearQuest as follows:
In addition, the ClearQuest packages for CQTM_Defect, CQTM_Motivator, and the RequisitePro integration Version 1.8 can be used to provide lifecycle traceability for the following relationships: Requirement to Test Plan and Test Case, Motivator to Test Plan and Test Case, Defect to Configured Test Case, and Test Case to test script.
To enable an existing ClearQuest database with ClearQuest Test Manager, apply the CQTM package using ClearQuest Designer. For information on setting up ClearQuest Test Manager, see the installation guide. For information on using it, see the Help.
The RequisitePro integration with ClearQuest has been enhanced as follows:
For more information, see the Help.
In previous releases, the limit on the number of database record IDs was approximately 16 million. For stateless records, the new upper limit is approximately 2.1 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 determine the record ID allocator limit for a specified user database (or for all user databases), use the installutil getrecordlimits command, as follows:
installutil getrecordlimits -dbset dbset_name user_id password { user_db | all }
No special privileges are required to use this command.
To increase the record ID limit for one or all user databases, use the installutil sethighrecordlimit command, as follows:
installutil sethighrecordlimit -dbset dbset_name user_id password { user_db | all }
The specified user ID must have administrative privileges. No metaschema upgrade is required to support an increase in the record ID limit.
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 ClearQuest clients or the ClearQuest Web Request Manager and LDAP servers. You can use SSL to ensure that communication between ClearQuest clients and the LDAP directory server is secure and private.
The ClearQuest Web request manager recycling feature "recycles" the request manager process without interrupting user sessions.
At this release, ClearQuest connects directly to the DB2 server, which eliminates the need for installing the DB2 client on ClearQuest clients. However, there is no need to de-install the DB2 client if it is present, since other applications may be using it and since ClearQuest ignores any DB2 client that is installed on a computer where a ClearQuest client or the ClearQuest Web server request manager process is running.
The new database integrity validation tool validates the integrity of the database schema repository or the synchronization of the schema repository and the user database. Logs are generated that document the analysis and they include a summary of the execution results. The tool supports validation of the following database platforms:
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 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. |
There has been no ClearQuest feature level (that is, metaschema) change since version 2002.05.00.
At this release, DataDirect drivers are supported for Oracle, SQL Server, and DB2 databases. Database drivers for SQL Anywhere, Oracle version 8, and Oracle LOB_TYPE=LONG are not supported
The following clients are supported at this release:
At this release, the ASP Web client and the client for UNIX (including cqtool) are no longer supported.
This release supports Crystal Reports Versions 10 and XI on the Rational ClearQuest for Windows client and the Rational ClearQuest Web client. To define report formats, you must obtain Crystal Reports with Crystal Reports Designer (contact http://www.businessobjects.com/ for more information). The Crystal Reports Designer tool is supported on the Rational ClearQuest for Windows client only and the report format definitions are stored in the ClearQuest database.
ClearQuest includes runtime support for Crystal Reports Version XI, which enables you to generate reports from report formats that have been defined using either Version 10 or Version XI.
This section lists restrictions and guidelines that are specific to Version 7.0 beta test software. Items in this section are not considered defects because the behavior reported is not necessarily expected to change in a future release of the product.
This section contains documentation updates that are specific to Version 7.0 beta test software.
This section lists the status of change requests that are specific to Version 7.0 beta test software. The following are known problems with ClearQuest Test Manager.
When creating an RFT project on a UNC share, you must specify the path to the project as the UNC path (not a drive letter qualified path.) When you create the project using a drive letter qualified path, the "Open Script" action on Test Cases and Configured Test Cases do not function properly.
Execution of a TMConfiguredTestCase cannot be cancelled. When Cancel is selected, playback continues execution nevertheless.
When you unregister a file location, the file location appears to have been unregistered, but in fact it persists in the database. There is no work-around: avoid unregistering file locations.
Working with multiple ClearQuest user databases is not supported in beta 1 software. Using multiple user databases may result in unpredictable File Association, Execution and Results processing.
In order to view Test Scripts and Test Logs from ClearQuest Test Manager, the TPTP editor must have already been invoked for the session.
When the Test Script for a Test Manager Configured Test Case is changed to a different File Location, the previously cached test script may not be cleared, resulting in the previously assigned Test Script being executed.
Test Manager execution fails on Windows XP if the project being test is connected to the workspace through a non-UNC path.
When creating a File Location for Test Scripts on Windows XP, you must set the project folder share rights to "full access." Otherwise, execution fails because there is no write access to the project.
The Test Manager "Pin to iteration" capability for ClearCase views does not work.
The Parent Test Plan reference on the TMTestCase form is a single reference. Selecting multiple Parent Test Plans causes an error. If multiple parent Test Plans are selected, remove all but one from the list using the Remove button.
When multiple Configured Test Cases are added to a TMTestSuite using the Configure action, only one is displayed in the TMTestSuite form due to a display problem. However, all Configured Test Cases are executed when the Test Suite is executed.
When a value is removed from the Values list in the TMConfigurationAttribute form, the associated TMConfigurationValue record is not deleted. This causes an error if you try to create a new value with the same name as the removed value. Removed values continue to be displayed among the ConfigurationValues in the TMConfiguration form.
The beta for ClearQuest Test Manager supports only test script execution using TPTP test tools (JUnit, URL Test, and Manual Test).
On the TMTestPlan form, the Add button allows selection of TMIterations that do not belong to the TMTestPlan's associated asset registry. Selecting such iterations results in an error message, with the Iterations field being colored red and the OK button being disabled. Although you must remove any invalid iterations, doing so is difficult because the Asset Registry is not displayed either in the Iterations reference list or in the Search results. As a workaround, create a query on TMIterations with a dynamic filter on Asset Registry. When you click the Add button on Iterations, click the Browse button (not the Search button) and select the new Iterations query, specifying the appropriate Asset Registry when prompted. This query will display only those iterations associated with the asset registry of interest.
In Test Manager, File Locations for TPTP Projects under ClearCase dynamic views are not supported.
Changing the File Location of a Test Script on a TMConfiguredTestCase results in execution failures.
The Configuration reference on the TMConfiguredTestCase and TMTestSuite forms is a single reference and a selection of multiple Configurations results in an error. If multiple Configurations are selected, use the Remove button to remove all but one from the list.
The Parent Test Case reference on the TMConfiguredTestCase form is a single reference. Selecting multiple Parent Test Cases causes an error. If multiple parent Test Cases are selected, remove all but one from the list using the Remove button
When you execute a TMConfiguredTestCase with a Test Script that is under ClearCase source control, the resulting TestLog file is not added to SourceControl even if the Log Location is under ClearCase.
In the TMTestLog form, double-clicking on a Trace File results in an error. To open the file from the Rational ClearQuest client, right click on a TMTestLog record from the Query Results view and select the Open Log Files option.
The External File list in the TMTestPlan form and the External Motivator tab on the TMTestCase form support only a single file reference. When you invoke the "Associate External File" action, any existing file reference will be replaced.
The Rational ClearQuest Client does not support any script association or execution for Rational Manual Tester (RMT).
When applying the CQTM_Defect or CQTM_Motivator packages, you must select a record type to which the packages are to be applied. If you fail to do so, you will encounter errors when working with the TMTestLog, TMTestPlan and TMTestCase forms.
The caching of data in the Test Management views causes problems if you log out of ClearQuest while the views are open. As a work-around, whenever you log out of ClearQuest, exit Eclipse and restart it before resuming the use Test management functionality.
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.