IBM Rational ClearQuest

Release Notes

Version 7.0 (BETA)
Windows and UNIX
GI11-6725-00

Before using this information, be sure to read the general information under Appendix. Notices.

October 2005

This edition applies to IBM Rational ClearQuest Version 7.0 (BETA).

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

Contents

Tables
About this release of Rational ClearQuest
Status of the beta test software
Installing this release
Crystal Reports
Perl TK
Use of databases
ClearQuest Test Manager functional and platform support limitations
Documentation
New features
Platform-independent client
Enhancements to existing clients
ClearQuest Test Manager
RequisitePro Integration
Record ID limitation improvement
SSL support for LDAP authentication
ClearQuest Web request manager recycling
DB2 server connection
Database integrity validation tool
Announcements
Perl software in this release
Status of the feature level
Support announcements
Restrictions and guidelines for using Rational ClearQuest
Rational ClearQuest documentation updates
Status of change requests for ClearQuest
RATLC00472698; RFT project created using non-UNC path does not function
RATLC00473235; Cannot cancel a TMConfiguredTestCase
RATLC00473973; Unregistered file locations persist in database
RATLC00474107; Use of multiple user databases is unsupported
RATLC00474565; TPTP editor not initialized
RATLC00474566; Test script caching problem
RATLC00474569; Non-UNC path causes execution failure
RATLC00474570; Project folder share must have write access
RATLC00755535; Nonfunctioning "pin to iteration"
RATLC00755555; Problem with multiple-parent test plans
RATLC00756109; Display problem with configured test cases
RATLC00756258; Problems with removed values
RATLC00756807; Test script execution limitation
RATLC00757322; Invalid iterations not disallowed
RATLC00757566; File locations for TPTP projects are unsupported
RATLC00757622; Cannot change location of test script
RATLC00757738; Multiple configuration references result in error
RATLC00757755, RATLC00757761; Problem with multiple-parent test cases
RATLC00757874; TestLog file remains view-private
RATLC00758284; Opening trace file causes error
RATLC00757940; External file list supports only a single file reference
RATLC00758415; Associating scripts with Rational Manual Tester is unsupported
RATLC00758983; Must specify record type for CQTM_Defect and CQTM_Motivator packages
RATLC01099793; Data cached in views can cause problems
Appendix. Notices

Tables

  1. Modifications to Perl 5.8.6 distribution

About this release of Rational ClearQuest

This chapter describes new features and other changes introduced in IBM(R) Rational(R) ClearQuest(R) Version 7.0 (BETA).

Status of the beta test software

This section describes limitations that are specific to the beta test software.

Installing this release

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 Reports

Crystal Embedded Edition for Rational Version XI is not available in beta test software.

Perl TK

Perl TK is not available in beta test software.

Use of databases

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.

ClearQuest Test Manager functional and platform support limitations

Following are limitations on ClearQuest Test Manager beta test software:

Documentation

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.

New features

This section describes new features in this release.

Platform-independent client

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.

Enhancements to existing clients

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

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.

RequisitePro Integration

The RequisitePro integration with ClearQuest has been enhanced as follows:

For more information, see the Help.

Record ID limitation improvement

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.

SSL support for LDAP authentication

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.

ClearQuest Web request manager recycling

The ClearQuest Web request manager recycling feature "recycles" the request manager process without interrupting user sessions.

DB2 server connection

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.

Database integrity validation tool

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:

Announcements

Perl software in this release

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.

Table 1. Modifications to Perl 5.8.6 distribution
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.

Status of the feature level

There has been no ClearQuest feature level (that is, metaschema) change since version 2002.05.00.

Support announcements

Database drivers

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

Client support

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.

Crystal Reports

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.

Restrictions and guidelines for using Rational ClearQuest

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.

Rational ClearQuest documentation updates

This section contains documentation updates that are specific to Version 7.0 beta test software.

Status of change requests for ClearQuest

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.

RATLC00472698; RFT project created using non-UNC path does not function

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.

RATLC00473235; Cannot cancel a TMConfiguredTestCase

Execution of a TMConfiguredTestCase cannot be cancelled. When Cancel is selected, playback continues execution nevertheless.

RATLC00473973; Unregistered file locations persist in database

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.

RATLC00474107; Use of multiple user databases is unsupported

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.

RATLC00474565; TPTP editor not initialized

In order to view Test Scripts and Test Logs from ClearQuest Test Manager, the TPTP editor must have already been invoked for the session.

RATLC00474566; Test script caching problem

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.

RATLC00474569; Non-UNC path causes execution failure

Test Manager execution fails on Windows XP if the project being test is connected to the workspace through a non-UNC path.

RATLC00474570; Project folder share must have write access

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.

RATLC00755535; Nonfunctioning "pin to iteration"

The Test Manager "Pin to iteration" capability for ClearCase views does not work.

RATLC00755555; Problem with multiple-parent test plans

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.

RATLC00756109; Display problem with configured test cases

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.

RATLC00756258; Problems with removed values

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.

RATLC00756807; Test script execution limitation

The beta for ClearQuest Test Manager supports only test script execution using TPTP test tools (JUnit, URL Test, and Manual Test).

RATLC00757322; Invalid iterations not disallowed

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.

RATLC00757566; File locations for TPTP projects are unsupported

In Test Manager, File Locations for TPTP Projects under ClearCase dynamic views are not supported.

RATLC00757622; Cannot change location of test script

Changing the File Location of a Test Script on a TMConfiguredTestCase results in execution failures.

RATLC00757738; Multiple configuration references result in error

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.

RATLC00757755, RATLC00757761; Problem with multiple-parent test cases

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

RATLC00757874; TestLog file remains view-private

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.

RATLC00758284; Opening trace file causes error

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.

RATLC00757940; External file list supports only a single file reference

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.

RATLC00758415; Associating scripts with Rational Manual Tester is unsupported

The Rational ClearQuest Client does not support any script association or execution for Rational Manual Tester (RMT).

RATLC00758983; Must specify record type for CQTM_Defect and CQTM_Motivator packages

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.

RATLC01099793; Data cached in views can cause problems

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.

Appendix. Notices

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.