V2003.06.13, September 2004
This file last updated: August 9, 2004
Material ID/Part Number: GI11-5901-03
(C) Copyright IBM Corp. 1995, 2004. All Rights Reserved.
Any reproduction or distribution of this work is expressly prohibited without the prior written consent of IBM Corporation.
The complete listing of IBM Rational Legal Notices is automatically installed with IBM Rational Suite products in <Install Path>\Rational\doc\legal_information.html. Optionally, the Legal Notices can be found on the "IBM Rational Solutions for Windows CD-ROM" at \doc\legal_information.html.
These release notes provide information critical to installing and using IBM(R) Rational(R) RequisitePro(R), including hardware and software requirements, compatibility, and known issues with this release.
Product changes described in this document and contained within this service release apply to:
These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications Center at http://www.ibm.com/shop/publications/order. Search for "GI11-5901-03" 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.)
Go to IBM Rational RequisitePro Service Release 2003.06.13 Release Notes if you are upgrading from:
The Service Release Notes include:
Project administrators can now use the RequisitePro Baseline Manager to create RequisitePro baselines of requirements contained in documents, Attribute Matrix views, packages, or an entire RequisitePro project. In addition, they can compare RequisitePro baselines and generate comparison reports. Note: Baseline Manager users must be members of the administrators group for the RequisitePro project that contains the baseline artifacts.
The Baseline Manager capability allows you to perform the following tasks:
Because this capability is part of RequisitePro project administration, it is only available from RequisitePro and not from RequisiteWeb.
The integration between RequisitePro and IBM Rational ClearCase UCM, which allows project administrators to create UCM baselines of RequisitePro projects, is still available in this release. However, the RequisitePro Baseline Manager cannot be used to compare UCM baselines.
RequisitePro now offers support for RequisitePro projects in IBM DB2 Universal Database. A new setup document "Configuring DB2 for IBM Rational RequisitePro" and the associated scripts provide configuration instructions and tools for DB2 database administrators and RequisitePro administrators.
Rational RequisitePro provides e-mail notification for requirement changes to users who subscribe to those requirements. Users can subscribe to a requirement in the Requirement Properties dialog box or in an Attribute Matrix. RequisitePro monitors a list of projects for revisions at specified times or time intervals and notifies users. When RequisitePro detects new revision entries that have occurred since the last notification, the service sends an e-mail message with change information to users who are subscribed to the changed requirements. For more information, see the RequisitePro Help index: changes > notification; also see the Help topic "Requirement change notification overview."
Internal program access to Microsoft Word capabilities has been enhanced through the use of Word COM interfaces. These revisions significantly improve Word behavior and performance in the following areas: Word version management, bookmark (and requirement) handling, menu command methods, window management, document opening, and document identification. This new use of the Word COM interfaces resolves numerous RequisitePro defects and promotes more robust, efficient Word performance.
RequisiteWeb now offers access to all requirement properties through a set of tabbed pages that correspond to the Requirement Properties dialog box in the RequisitePro Windows client. This centralizes requirement creation and editing in a concise user interface. The tabbed pages include the following:
You can now create a new requirement in Requisite Web from within an Attribute Matrix. The Create Requirement button appears at the bottom of each Attribute Matrix page, and provides access to the tabbed Requirement Properties pages. The new requirement defaults to the requirement type of the Attribute Matrix; it is displayed in the matrix after you save it. For more information, see the topic "Creating and modifying requirements" in the RequisiteWeb online Help.
You can now modify requirement attribute values directly in an Attribute Matrix. When you edit in an Attribute Matrix, each value you change is recorded as a separate revision history record. For more information, see the topic "Creating and modifying requirements" in the RequisiteWeb online Help.
The Traceability Matrix provides an additional way to manage traceability, complementing the Attribute Matrix and Traceability Tree views that are already available in RequisiteWeb. The Traceability Matrix view presents the relationships between requirements of the same or different types. Use this matrix to view indirect relationships and suspect relationships. You can filter and sort the requirements that are displayed.
You can now work directly within a Traceability Matrix to add, remove, and modify a traceability relationship between two requirements. You can also add or remove suspect conditions for the traceability relationship. For more information, see the topic "Viewing and modifying traceability" in the RequisiteWeb online Help.
Configuring your Web server for RequisiteWeb is quick and easy, requiring just five steps: Install the application, specify your username, configure SSL (optional), reboot the machine, and add your projects to the project list.
You can customize the RequisiteWeb Login Page and footer to accommodate your company's needs.
In RequisiteWeb, you can now create, modify, and delete documents. When you create a document, RequisiteWeb references the new document in the project database. You can take a document offline and modify its content in Microsoft Word, just as you can with RequisitePro.
Your organization's customers, contractors, and remote team members can now access RequisiteWeb using the Internet. Internet access to live requirements data using RequisiteWeb provides timely, invaluable feedback between your development team and other requirements stakeholders. The revised documentation, Installing and Configuring IBM Rational RequisiteWeb, includes guidance on configuring a firewall and proxy server to enable secure access to RequisiteWeb through the Internet.
The Rational RequisitePro-XDE Integration lets you combine the use-case modeling and application design capabilities of XDE with requirements management capabilities in RequisitePro.
You can define your use cases by integrating Unified Modeling Language (UML) diagrams in XDE and Microsoft Word documents in RequisitePro. You can assign attributes and traceability to your use cases in order to manage your use cases in the context of the requirements. In addition, you can trace your requirements in RequisitePro to your design in XDE in order to better understand the impact of requirement change on your design.
The use-case modeling capabilities of this integration are similar to those of Integrated Use Case Management, which integrates RequisitePro and Rational Rose. You can migrate use-case associations in a Rose model when you upgrade the model to an XDE model.
To use this integration, you must install both RequisitePro and XDE on your system.
For more information, see the Rational RequisitePro-XDE Integration Help topic "Configuring XDE Models for the Integration."Configuring the integration between RequisitePro and ClearQuest has never been easier. A wizard guides you through the setup enabling you to complete your configuration in minutes. You can also use the wizard to test and repair existing integrations. The integration lets you associate enhancement requests, defects, and other ClearQuest records with RequisitePro requirements.
The wizard replaces the ASCQISetup.bat and ASCQISetup.exe files used to configure the integration in earlier versions of Rational Software. If you have an existing integration, you can continue to use ASCQISetup.bat and ASCQISetup.exe to modify the integration, or you can use the RequisitePro-ClearQuest Integration Wizard to make changes.
The online Help for the RequisitePro-ClearQuest Integration has been enhanced to include extensive concepts and tasks. This is based on material in the Getting Started with Rational Suite AnalystStudio guide, which is available on the Rational Solutions for Windows Online Documentation CD-ROM and at the IBM Publications Center (http://www.ibm.com/shop/publications/order).
The project templates available in RequisitePro contain updated structure and requirement attributes to help you be more productive in a shorter amount of time.
The sample projects included with RequisitePro have been revised, and the examples included with the projects help you learn an approach to writing use cases.
An extensibility interface called RqCallback.dll was added in v2003.06.00 to encapsulate the CallBack object. This object is used in conjunction with the RqGuiApp type library to access the RequisitePro user interface. A new Help topic “Accessing the RqCallback Library” has been added to the RequisitePro Extensibility Interface Help overview in this service release to assist in the use of this interface.
When you install RequisitePro, the following files are automatically installed
in the help directory
<install drive>\Rational\RequisitePro\help:
When you start RequisitePro, the Open Project dialog box appears, which enables you to select a project to work with or to create a new project. Click the Existing tab to select a project from your project list, or click the New tab to create a project.
When you start RequisiteWeb, the Login Page appears, which enables you to select a project to work with. Select a project from the Project drop-down list to open a project from your project list.
The Explorer is the primary navigation window for RequisitePro and RequisiteWeb. In this window, project artifacts (documents, requirements, views, and packages) are displayed hierarchically in a tree browser. Project information is organized in packages, which are units of related artifacts. The project’s root package is displayed as the project node, and the contents of each root package are displayed beneath it. When you select an artifact, a description of it appears in the window below the Explorer. You can use the Explorer to access, view, and edit your project artifacts. For example, you can double-click or right-click a view or a document to open it; you can select requirements and edit them; and you can drag and drop artifacts between packages. The Explorer reflects saved changes made to an open document, view, or requirement.
This release of RequisitePro provides new project template structure intended to accelerate your organization's requirements management strategy. The Use-Case, Traditional, and Composite templates provide new organizational structure, queries, and documents in accordance with the principles of the Rational Unified Process. Each template contains a Glossary document and a Requirements Management Plan document, which save project managers time by providing base content common to most requirements management needs, including descriptions of project artifacts, common terms, and roles. These templates are intended to be modified, manipulated, customized, and enhanced as the project evolves.
Quick Tour is a quick introduction to RequisitePro. It walks you through the basic tasks that you perform in a requirements project, such as how to create projects, documents, and requirements and how to set requirement attributes and establish traceability. You can open Quick Tour from the Let's Go RequisitePro help screen or from the Help menu.
The Rational RequisitePro Extensibility Interface contains new classes, methods, and properties. For more information, see the RequisitePro Extensibility Interface online reference topic "About this Release".
RequisitePro setup creates a Start menu program group for RequisitePro with the following items: Let's Go RequisitePro, Online Help, Release Notes, Rational Extensibility Interface Help, Technical Support, and configuration reference documents for RequisiteWeb, DB2, Oracle, and SQL Server databases. To start RequisitePro, click Start > Programs > Rational Software > Rational RequisitePro.
Let's Go RequisitePro opens when RequisitePro is first launched. Use Let's Go RequisitePro to access the RequisitePro Tutorial, Quick Tour, these release notes, Help, project administration tips, the Rational Unified Process, IBM developerWorks Rational, and other Web resources. Let's Go RequisitePro can also be opened from the RequisitePro Help menu.
In addition to RequisitePro Help, see the manual Rational RequisitePro User's Guide, which is available on the Rational Solutions for Windows Online Documentation CD and at the IBM Publications Center (http://www.ibm.com/shop/publications/order). (To search for the IBM Publications Center, go to http://www.ibm.com and enter "IBM Publications Center" in the Search field.)
This section provides basic information on the platforms supported and the hardware and software requirements for running RequisitePro.
Processor: 500 MHz or higher.
Memory: 256 MB or higher.
Note: Additional memory is particularly helpful for RequisitePro project administrators
who use Unified Change Management (UCM) to create baselines of RequisitePro
projects.
Disk Space: 200 MB.
Monitor:
Mouse/pointing device: Microsoft Mouse or compatible pointing device.
Operating Systems:
Recommendations for Using Microsoft Office with the Above Operating Systems:
Word Processor:
Requirement Metrics Reporting:
Microsoft Project Integration:
LAN Support: Microsoft networks. (Novell networks are not supported.)
Database Client Support for:
Automated License Key Requests: Network connection required for automated license requests.
Other Rational Products:
To verify which product versions you have installed on your system, click Start > Programs > Rational Software > Rational Software Installed Product Information.
For information about RequisiteWeb, including system requirements, installation and configuration, and known issues, see Installing and Configuring IBM Rational RequisiteWeb (RequisiteWebInstall.html).
For full installation instructions, see the manual IBM Rational Software Desktop Products Installation Guide. For information about upgrading Rational Suite or integrations with other Rational products, see the manual IBM Rational Suite Upgrade Guide and the IBM Rational Suite Release Notes. Both guides are available at the IBM Publications Center (http://www.ibm.com/shop/publications/order).
Under certain circumstances, file system corruption can result from installing Rational Version 2003 products on Windows 2000 to an NTFS partition that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000.
Before you install any Rational Version 2003 product on a computer that is running Windows 2000:
Note: The production release of Windows XP SP2 was not available for final testing at the time this document was finalized. To obtain the latest information about Windows XP SP2 support, go to IBM Rational Support at http://www.ibm.com/software/rational/support/ and search for “Rational products and Windows XP SP2.” The following information is based on testing done with Windows XP SP2 Release Candidate 2, released June 14, 2004.
Firewall issues
Windows XP SP2 enables a firewall that might make it difficult for the RequisitePro to operate. You might receive warnings about network connections when using the following applications with RequisitePro:
Allowing network traffic when using Windows XP SP2
While making outgoing requests, a warning dialog might open to inform you that an outgoing request is being made. If the firewall blocks network traffic, then client/server applications will not operate. To ensure that IBM Rational products operate with Windows XP SP2, you must allow network traffic by doing one of the following:
If your team accesses a shared RequisitePro project or enterprise database from multiple RequisitePro clients and RequisiteWeb, you must upgrade all your RequisitePro and RequisiteWeb installations to one of these compatible versions: 2002.05.20, 2003.06.00, 2003.06.12, and 2003.06.13. There are limitations when using RequisitePro version 2002.05.00 and 2002.05.10 with later versions.
When you install this version of RequisitePro, incorrect sample projects may appear in your project list. Remove the old projects titled Learning Project, Learning-Business, and the QuarterByte Savings Bank Example Project. Make sure the new sample projects, Learning Project - Use Cases and Learning Project - Traditional are added to your project list.
If you use the Rational ClearQuest integration with RequisitePro, see the Rational Suite Upgrade Guide for additional steps you must perform before you uninstall earlier versions of Rational Software. (RATLC00058077)
If a project is in a version of RequisitePro earlier than version 4.0, you
must first upgrade the project to RequisitePro 4.0 before using the Database
Upgrade Wizard. Contact Customer Support for information.
Microsoft Access 2000 is the default database format for RequisitePro version 2000.02.10 and later. If you have a project that was created in an earlier release of RequisitePro, the project database is in Microsoft Access 97 format. If you want to view a RequisitePro project from a previous release in Microsoft Access 2000 or 2002, you must upgrade the project database to Microsoft Access 2000.
Rational has provided a utility to convert Microsoft Access-based RequisitePro projects from Access 97 format to Access 2000 format. The utility "RqAcc2KConv.exe" can be invoked by either dragging and dropping the RequisitePro project file (.rqs) onto the executable, or running the utility from the command line and specifying the entire path to the RequisitePro project file (.rqs) file. The default location for this utility is C:\Program Files\Rational\RequisitePro\bin. As part of the conversion process, the utility creates a backup copy of your database with the .tac extension instead of the .mdb extension. The backup copy can be removed when you are satisfied that the conversion was successful. The utility also repairs and compacts the database.
ClearCase
ClearCaseLT
ClearQuest
Rational Administrator
XDE
Rose
Rational E-Mail Reader (mailreader.exe)
To improve performance, consider the recommendations below when you create a UCM baseline of a RequisitePro project with ClearCase LT.
For information about upgrading Rational Suite or the RequisitePro-ClearQuest integration, see the manual IBM Rational Suite Installation Guide and the IBM Rational Suite Release Notes. For information about configuring the integration, see the manual Rational Suite Administrator's Guide. Both guides are available at the IBM Publications Center (http://www.ibm.com/shop/publications/order).
In certain configurations, such as Windows NT 4.0 SP6A with Security Patches, the following error may occur when associating a RequisitePro project using the IBM Rational Administrator.
Error Number: 339
Error Description: Component mscomctl.ocx or one of it's dependencies not correctly registered: a file missing or invalid
To correct this, you should manually register the file using the command prompt
as follows:
C:\WINNT\system32>regsvr32 mscomctl.ocx
A success message should be displayed indicating the file was properly registered.
(RATLC00703134)
Supported platforms for RequisitePro may not be the same as supported platforms for XDE. See the Rational XDE release notes for supported platforms for Rational XDE. (RATLC00057826)
If you are using a version of XDE that is older than 2003, the Rational RequisitePro-XDE Integration does not work with RequisitePro version 2003.06.00 or later.
You can use the Options dialog box (click Tools > Options) to select the Rational XDE edition on your system that you want to open when you use the XDE integration commands in RequisitePro. You can use more than one edition of XDE with the integration, but only one can be designated to open automatically from RequisitePro when no edition of XDE is open on your system. Only users with operating system-level administrator rights can change the Start Preference for the change to take effect. (RATLC00058758)
You may receive an ODBC error when creating traceability from an element in XDE to Rational RequisitePro. The error appears after clicking OK on the Requirements Properties dialog box. After you accept the ODBC error message, the RequisitePro Explorer is unavailable and does not respond. You must close RequisitePro using the Windows Task Manager. The association for the XDE model element is not created. This happens only during the first association of an element. (RATLC00058433)
The navigation capabilities of the Rational RequisitePro-XDE Integration Help system require that your browser support Java applets. If the left hand pane is blank or displays an error message, your Microsoft virtual machine may be damaged (Microsoft Knowledge Base Article - 305674), you may be trying to run a Java applet across a firewall, or you may have another compatibility problem. Contact the designated support site for your browser to resolve these kinds of issues.
If you are using the Rational RequisitePro-XDE Integration, the XDE Redo command does not apply to disassociation and cut actions. The XDE Undo commands and ClearCase Undo Check Out commands do apply to association and paste actions. (RATLC00056556)
If you use RequisitePro version 2002.05.00 to change the name of a requirement and then take the document containing that requirement offline, changes made to the requirement name in the database using RequisitePro version 2002.05.00 while the document was offline are discarded when you bring it back online using RequisitePro version 2003.06.00 or later. To avoid this situation, take one of the following measures:
(RATLC00056189)
Save all XDE for Visual Studio .NET models before you associate model elements with RequisitePro. (RATLC00058453)
You cannot use Rational Administrator to integrate XDE models with RequisitePro projects. After you convert your Rose models to XDE models and migrate their RequisitePro associations to the new XDE models, any references to those Rose models in a Rational Administrator project become obsolete. We recommend that you remove any references to Rose models in Rational Administrator projects if the Rose models have been migrated to XDE models. (RATLC00017161)
You cannot migrate an existing integration with a RequisitePro project from Rose to XDE by using the File > Import command in XDE. This command converts the Rose model to an XDE model but does not migrate any associations to RequisitePro. To migrate associations, follow the instructions in the topic "Migrating RequisitePro associations from a Rose model to XDE model" in the Rational RequisitePro-XDE Integration Help, which can be accessed by clicking Tools > Rational RequisitePro in Rose or XDE. (RATLC00016923)
In XDE or Rose, if a use case contains an association to a RequisitePro use case requirement and you move the use case to a different package in XDE or Rose, the association is lost. In this case, you must reestablish the association. Right-click on the use case and select RequisitePro > Associate Requirement. (RATLC0017836)
After installing Crystal Reports version 8.0, users who are not local administrators may receive the following error message when starting RequisitePro:
"Unable to load the RequisitePro GeneralServices.Files Component.
Class not registered (HRESULT REGDB_E_CLASSNOTREG)"
After this message is displayed, RequisitePro immediately closes. This error is caused by a change to the default security permissions on several registry keys by Crystal Reports. For more information, see Microsoft Article Q266621 in the Microsoft online Knowledge Base. To resolve this problem, reset the registry key permissions that are changed when you install Crystal Reports. A utility that resets the registry key permissions is available from Crystal Decisions:
http://support.crystaldecisions.net/communityCS/FilesAndUpdates/scr8_webregfix.exe.asp
This third-party contact information is subject to change without notice. (RATLC00017845)
Certain Adobe Acrobat 6.0 installations conflict with the RequisitePro use of Microsoft Word. When opening RequisitePro, you may encounter a communication error -5 with a message indicating: "Unable to communicate with Microsoft Word," or "the ReqPro10.dot file is corrupted or missing," or "Microsoft Word has encountered a problem and needs to close." You can continue to open RequisitePro; however, the RequisitePro-enabled version of Word is not available. (Note, this does not occur with installations of the Acrobat Reader.) To fix this problem, remove the Adobe pdfmaker.dot file from the Microsoft Office Startup directory in Program Files. Removing this template does not prevent the creation of Adobe PDF files. (RATLC00375054)
Avoid creating requirements inside text boxes. RequisitePro cannot access them properly.
Do not create requirements from text that contains the Wingdings font or other special characters at the beginning of the text string. (RATLC00016311)
Do not use a password when protecting RequisitePro Word documents with the Microsoft Word Tools > Protect Document command. (RATLC00016802)
RequisitePro contains a Refresh Requirements command (available when you click RequisitePro > Document) that lets you reset the style and color of all requirement text in a document in case you inadvertently change it. However, if you change the color of any requirement text using Word 2000 or 2002, the color cannot be reset using the Refresh Requirements command. To refresh requirement text color, save the document and then select the Refresh Requirements command. (RMBU5359)
You cannot edit the requirement text outside the document (even when the extended editing feature is enabled) if you include the following in the text of a requirement located in a document:
If characters in RequisitePro are replaced with a vertical bar, Windows NT users should change the Windows default font to something other than MS Sans Serif (Tahoma is recommended). (RATLC00057929)
RequisitePro does not support a digit-grouping symbol of any kind (for example, a thousand separator, such as the comma in 2,350). You cannot enter attributes with this symbol. RequisitePro does not display numbers with this character. (RMBU6858)
If a saved view includes a query with a user-defined date field parameter, the date is stored with the saved view in the date format that is set in your Control Panel/Regional Settings/Short Date Style. If you attempt to open a saved view on a PC that uses a different date format (such as dd/mm/yyyy), a run-time error occurs. (RATLC00014609)
The Parent Change filter cannot always detect when a requirement is changed from a root requirement to a child requirement, and vice versa. (RMBU8472)
The following is a list of known issues in this release of RequisitePro. For information about issues related to Rational Suite or integrations with other Rational Products, see the IBM Rational Suite Release Notes.
You cannot create a baseline of a RequisitePro project that contains traceability to external projects that are unavailable (whether relocated or removed), even if you clear the option to include external project traceability. You must remove traceability to unavailable projects before creating the baseline. (RATLC00058747)
Avoid using periods in RequisitePro project names. (RATLC00018417)
When adding an existing RequisitePro project to your project list or when associating projects with artifacts from other Rational tools, such as XDE or Rose, you may encounter an error if you browse to the project using the Windows My Network Places icon. In some cases, the error message may be hidden behind another window, such as XDE. If this occurs be sure to close the error message box (from the taskbar, if necessary), rather than terminating the error using the Task Manager. To prevent this problem, enter the mapped drive and path for the project rather than using My Network Places. (RATLC00245133)
When renumbering requirements in a RequisitePro project, if the first requirement is located in a document and if you choose to start the renumbering by an order of magnitude less than the current numbering (for example, 60 rather than 6000), the first requirement does not get renumbered. To fix this condition, renumber the requirements again using a new starting number, cut and paste the starting requirement from the document into the database and then back into the document, or manually edit the requirement tag in the document. (RATLC00017529)
The first time you open a document in a sample project, an error message appears stating that the document has been modified. This is the result of an incorrect date and time record for the document. The content for the document is current. Click Yes to continue. (RATLC00059092, RATLC00058991)
If you open Let's Go RequisitePro from the Start menu, the link to the RequisitePro release notes fails. However, Let's Go appears when RequisitePro opens, and it is also available from the RequisitePro Help menu. In both these contexts, the link to the release notes is successful. (RATLC00058281)
The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support homepage can be found at www.ibm.com/software/support.
Voice Support is available to all current contract holders via a telephone number in your country (where available). For specific country phone numbers, please refer to the IBM Software Support Handbook, Appendix B: Contact Information, found at www.ibm.com/software/support.