Version 7.0.0.1
Release Date: January 2007
Last Updated: 02/09/2007
Material ID: GI11-6720-00
© Copyright IBM Corporation. 2000, 2007. All Rights Reserved.
This documentation (the "Work") is protected under the copyright laws of the United States and/or other jurisdictions, as well as various international treaties. Any reproduction or distribution of the Work is expressly prohibited without the prior written consent of IBM Corporation.
Before using this information, be sure to read the general information in Appendix. Notices
The complete listing of IBM Rational Legal Notices is automatically installed with IBM Rational Suite 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.
Note:
This maintenance release of IBM Rational Robot contains updated licenses, as well as terms and conditions regarding the delivery of open source software. Please review these before using and installing the software.
This release of IBM® Rational® Robot V7.0.0.1 includes the following new features:
- Support for integration with ClearQuest Test Manager. This integration enables you to perform the same type of operations that you can perform with the other testing tools (Rational Functional Tester, Rational Performance Tester, and Rational Manual Tester). For more information, see the ClearQuest Test Manager 7.0.0.1 documentation.
- IBM Rational Robot provides COM Interface APIs for integration with any test management solution.
- Extensible Rational Robot - Allows you to use Rational Robot in standalone mode without any integration with any other test management solution. The following new features are provided in the Rational Robot Standalone mode:
- Extensible asset management - Allows you to manage test assets of Standalone Robot projects by extending the asset management APIs.
- Extensible log management - Allows you to change the log format file (XML) by using the log APIs.
- Configuring login mode - Allows you to create a login mode by extending the APIs of asset management, log management, or both.
- Command line option - Allows you to enter the login mode as Rational Robot Standalone from the command line.
This section provides information about installing Rational Robot 7.0.0.1 and using the integration with ClearQuest Test Manager.
To use the features described in IBM Rational Robot Documentation Version 7.0.0.1 - Document Supplement, do the following:
- Install Rational Robot 7.0. For detailed information, see the IBM Rational Robot Installation Guide from the IBM Publications Center.
- Install Rational Robot 7.0.0.1.
To use the integration with Rational ClearQuest Test Manager, do the following:
- Install Rational ClearQuest 7.0. For detailed information, see the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.
- Install Rational Robot 7.0.
- Install Rational ClearQuest 7.0.0.1.
- Install Rational Robot 7.0.0.1.
- Upgrade the Rational ClearQuest user databases to apply the new version (2.0) of the Rational ClearQuest Test Manager schema package (CQTM). For information about upgrading packages, see Administering Rational ClearQuest from the Rational ClearQuest Online Help.
- Install the IBM Rational Agent Controller (RAC). For more information, see Installing the Agent Controller.
Installing the Agent Controller
The IBM Rational Agent Controller is required for local and remote execution of Robot scripts from Rational ClearQuest Test Manager. The Agent Controller is included in a zip file with Rational Robot 7.0.0.1.
To install the Agent Controller, perform the following steps:
- Extract the contents of the Agent Controller zip file (ibmrac.win_ia32) to a directory on your computer.
- In Windows Explorer, navigate to the win_ia32 subdirectory of the directory that contains the extracted contents of the zip file.
- Double-click the setup.exe file to start the installation.
For Rational Robot you also need to install a Robot plugin into the Agent Controller:
- In Windows Explorer, navigate to the directory that contains the extracted contents of the ibmrac.win_ia32.zip file.
- Extract the contents of the rac_robot.zip file into a directory on your computer and then navigate to that directory.
- Copy com.ibm.rational.test.ft.robot and paste it into the plugins subdirectory of the directory where you installed the Agent Controller, for example C:\Program Files\IBM\AgentController\plugins\com.ibm.rational.test.ft.robot.
| Component | APAR Number | Description |
|---|---|---|
| SQABasic | PK24955 | SQASetEventWait(0) throws an error during run time. |
| Delphi | PK24955 | Test Enabler crashes while enabling Delphi 7 project. |
| Robot session recording | PK25111 | Robot does not perform case-sensitive value recognition in combo-list box. |
IBM Rational Software Support provides you with technical assistance.
For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook.
For FAQs, lists of know problems and fixes, and other support information, visit the IBM Rational Software Support Web site.
For Rational software product news, events, and other information, visit the IBM Rational Software Web site.
Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
- What software versions were you running when the problem occurred?
- Do you have logs, traces, or messages that are related to the problem?
- Can you reproduce the problem? If so, what steps do you take to reproduce it?
- Is there a workaround for the problem? If so, be prepared to describe the workaround.
© Copyright IBM Corporation 2000, 2007.
The XDoclet Documentation included in this IBM product is used with permission and is covered under the following copyright attribution statement: Copyright © 2000-2004, XDoclet Team. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
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 documentation 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 documentation. The furnishing of this documentation does not give 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 CorporationLicensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, JapanThe 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 OR CONDITIONS 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.
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:
Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, Massachusetts 02421-3112
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 documentation 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 measurements 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.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
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.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2000, 2007.
Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
- ClearCase
- ClearCase MultiSite
- ClearQuest
- IBM
- PurifyPlus
- Rational
- RequisitePro
- ScriptAssure
- TestStudio
- WebSphere
- XDE
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft and Windows 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.