Re
admeRational Rose® RealTime
The Rational Rose RealTime Readme file contains important updates for
Rational Rose RealTime 2002.05.20. For additional information regarding
Rational Rose RealTime, see the Release Notes for Rational Rose RealTime,
the Release Notes and Installation Guide for Rational Rose RealTime
Professional Edition, and
the Rational Rose RealTime web
site, http://www.rational.com/support.
Note: In some cases, you may note discrepancies between the printed documentation, the online documentation, and this Readme file. In these cases, the Readme file is the most up-to-date and should be followed.
This Readme is organized as follows:
This topic is organized as follows:
Please read the following notes before you install Rational Rose RealTime:
With your software shipment, you received a Welcome letter containing your Start-up License Key Certificates for this product. You need these keys to run your software. The start-up keys will expire a few weeks after shipment. Ensure that you request your permanent license keys as soon as possible. The availability date for your permanent keys is indicated in the top section of your Start-up License Key Certificate.
Please check the Installation Guide for Rational Rose RealTime for detailed instructions on how to install your license keys, and how to request permanent license keys.
You cannot run earlier versions of Rational Rose RealTime with the latest version of Rational Rose RealTime on Windows NT, Windows 2000, and Windows XP Pro.
Thank you for selecting Rational Rose RealTime, the real-time industry's leading environment that unifies software teams by integrating with best-in-class Rational products including Rational ClearCase, Rational RequisitePro, and Rational SoDA.
Please read this Readme file before you install or use Rational Rose RealTime. We also recommend that you review the Release Notes for Rational Rose RealTime.
Please visit the Rational Web site for the latest Release Notes, patches, and other information at http://www.rational.com/support
If you encounter any problems while installing or running Rational Rose RealTime, please check here first to see if you encountered a known problem. If you find a problem that is not yet documented, please call Rational Technical Support so we can investigate it, provide you with a workaround, and track the problem for further action.
See Technical Support for telephone numbers and e-mail addresses of the Rational Customer Service contacts for your region.
This chapter is organized as follows:
Please refer to the Installation Guide for Rational Rose RealTime for instructions on installing a start-up license and obtaining a permanent license.
Note: If you are installing licenses on a UNIX platform, DO NOT follow the instructions on the Rational Start-up License Certificate or on the envelope in which the certificate is delivered to you. See the Installation Guide for Rational Rose RealTime for instructions on installing Rational Rose RealTime.
[Go To Top]
Checking the Validity of Your License Keys
If you upgrade to Rational Rose RealTime 2002.05.20 from Rational Rose RealTime releases 6.0, 6.0.1, or 6.0.2, your license keys are not valid. For information on obtaining new license keys, see Requesting License Keys in the Installation Guide for Rational Rose RealTime .
If you upgrade to Rational Rose RealTime 2002.05.20 from Rose RealTime releases 6.1, 6.1.1, 6.2, 6.3, or 6.4, your license keys are valid.
For more information on license keys, see the topic Installing License Keys in the Installation Guide for Rational Rose RealTime.
A toolset launched manually will require a license.
A second toolset session launched manually on the same platform will require a second license.
A toolset launched as a COM Automation server will NOT require a license unless it is explicitly made visible by setting the RRTEI Application object's Visible property to True. For more information on RRTEI, see Extensibility Interface Reference in the Rational Rose RealTime online Help.
A toolset launched with a compiled script passed as a command line argument will require a license since the toolset will be made visible before running the script.
A toolset launched with both the -runScriptAndQuit and a compiled script passed as a command line argument will not require a license since the toolset will not be made visible when running the script.
Note: A toolset session, regardless of how it is initiated, will require a license if the toolset is made visible.
We recommend that you save your license files in a safe location.
When upgrading from an older version of Rational Rose RealTime:
For additional information on licensing, see the Licensing chapter in the Installation Guide for Rational Rose RealTime.
For detailed information, see the Rational Rose RealTime Release Notes.
The Rational Rose RealTime Professional Edition has the following issues:
If you modify a model when a target observability (TO) session is running, the Undo and Redo menu commands are disabled; use caution when editing. Additionally, if Rational Rose RealTime is currently interacting with an add-in while TO is active, such as RQA-RT, there will be brief periods during extensibility calls from the add-in to Rational Rose RealTime where editing will be disabled. If this occurs, continue making the edit change until you are successful.
For the most recent documentation updates, please visit the Product Support section of the Rational Rose RealTime web site at:
http://www.rational.com/support
Where printed documentation exists, always refer to the online Help, Release Notes and Readme for the latest updates.
Rational Rose RealTime uses the concept of a Type Descriptor (RTObject_class) for describing a data type to the Services Library. The Services Library uses the information in the descriptors to initialize, copy, destroy, encode, and decode objects of the corresponding type.
This structure describes common type structures more compactly than is possible with just RTObject_class. For attributes and association ends that are something other than a single, inline instance of a data type, a type modifier is normally required to inform the RTS of its structure. For example, a field of type 'int *' is not an int but rather points to an array of ints. The type modifier includes the information that the data are indirect and gives the number of elements in the array through a function.
A new check box called GenerateTypeModifier allows you to specify the generation of RTTypeModifier. It is possible that the type descriptor specified in the preceding field is specific to this structure, and so a type modifier is not required nor desirable. An example of this is 'char *' used to hold a null-terminated C string. The RTS defines RTpchar and RTType_RTpchar. For this example, it would be appropriate to use the RTType_RTpchar descriptor and deselect the GenerateTypeModifier property.
For attributes and association ends that are something other than a single, inline instance of a data type a type modifier is normally required to inform the RTS of its structure. For example, a field of type 'int *' is not an int but rather points to an array of ints. The type modifier includes the information that the data are indirect and gives the number of elements in the array through a function.
When contacting Rational Customer Service by email or by telephone, you will have to provide the following information:
If your organization has a designated, on-site support person, please try to contact that person before contacting Rational Customer Service.
You can obtain technical assistance by sending electronic mail to the appropriate email address. Electronic mail is acknowledged immediately and is usually answered within one working day of its arrival at Rational. When sending an email, include "Rational Rose RealTime" in the subject line, and in the body of your message include a description of your problem.
When sending email concerning a previously-reported problem, please include in the subject field:
"[SR# XXXXXXXXX]"
where XXXXXXXXX is the service request number. For example:
SR# 111222333] New data on Rational Rose RealTime install issue
Occasionally, Rational Customer Service engineers may ask you to fax information to help them diagnose problems. You can also report a technical problem by fax if you prefer. Please mark faxes "Attention: Technical Support" and add your fax number to the information requested above.
Telephone, fax, and email information for Rational Customer Service appear in the following table.
|
Your Location |
Telephone |
Fax |
|
|---|---|---|---|
|
North America |
(800) 433-5444 (408) 863-4000 |
(781) 676-2460 |
support@rational.com |
|
Europe, Middle East, Africa |
+31 (0) 20-4546-200 |
+31 (0) 20-4546-202 |
support@europe.rational.com |
|
Asia Pacific |
+61-2-9419-0111 |
+61-2-9419-0123 |
support@apac.rational.com |
If you have a problem or questions regarding the licensing of your Rational Software products, please contact the Licensing Support office nearest you. Telephone numbers for license support are listed in the following table.
|
Region |
Telephone Number |
Fax Number |
|---|---|---|
|
Americas |
800-433-5444 |
781-676-2510 |
|
Europe, Israel, and Africa |
+31 (0)20 4546 200 |
+31 (0)20 4546 202 |
|
North Asia Pacific (Mainland China, Hong Kong, Taiwan) |
+852 2143 6382
|
+852 2143 6018
|
|
Korea |
+82 2 556 9420 |
+82 2 556 9426 |
|
South Asia Pacific Australia, New Zealand, Malaysia, Singapore, Indonesia, Thailand, The Philippines, Vietnam, Guam and India |
+61-2-9419-0111 |
+61 2 9419 0123 |
|
Japan |
+81 3 5423 3611 |
+81 3 5423 3622 |
Email addresses for license support are listed in the following table.
|
Region |
Email Address |
|---|---|
|
Americas |
lic_americas@rational.com |
|
Europe, Israel, and Africa |
lic_europe@rational.com |
|
North Asia Pacific Mainland China, Hong Kong, Taiwan, and Korea |
lic_apac@rational.com |
|
South Asia Pacific Australia, New Zealand, Malaysia, Singapore, Indonesia, Thailand, The Philippines, Vietnam, Guam and India |
lic_apac@rational.com |
|
Japan |
lic_japan@rational.com |
IMPORTANT NOTICE
COPYRIGHT
Copyright ©1993-2002, Rational Software Corporation. All rights reserved.
Version Number: 2002.05.20
PERMITTED USAGE
THIS DOCUMENT CONTAINS PROPRIETARY INFORMATION WHICH IS THE PROPERTY OF RATIONAL SOFTWARE CORPORATION ("RATIONAL") AND IS FURNISHED FOR THE SOLE PURPOSE OF THE OPERATION AND THE MAINTENANCE OF PRODUCTS OF RATIONAL. NO PART OF THIS PUBLICATION IS TO BE USED FOR ANY OTHER PURPOSE, AND IS NOT TO BE REPRODUCED, COPIED, ADAPTED, DISCLOSED, DISTRIBUTED, TRANSMITTED, STORED IN A RETRIEVAL SYSTEM OR TRANSLATED INTO ANY HUMAN OR COMPUTER LANGUAGE, IN ANY FORM, BY ANY MEANS, IN WHOLE OR IN PART, WITHOUT THE PRIOR EXPRESS WRITTEN CONSENT OF RATIONAL.
TRADEMARKS
Rational, Rational Software Corporation, Rational the e-development company, ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearQuest, ClearQuest MultiSite, DDTS, Object Testing, Object-Oriented Recording, ObjecTime & Design, Objectory, PerformanceStudio, ProjectConsole, PureCoverage, PureDDTS, PureLink, Purify, Purify'd, Quantify, Rational, Rational Apex, Rational CRC, Rational Rose, Rational Suite, Rational Summit, Rational Visual Test, Requisite, RequisitePro, RUP, SiteCheck, SoDA, TestFactory, TestFoundation, TestMate, The Rational Watch, AnalystStudio, ClearGuide, ClearTrack, Connexis, e-Development Accelerators, ObjecTime, Rational Dashboard, Rational PerformanceArchitect, Rational Process Workbench, Rational Suite AnalystStudio, Rational Suite ContentStudio, Rational Suite Enterprise, Rational Suite ManagerStudio, Rational Unified Process, SiteLoad, TestStudio, VADS, among others, are either trademarks or registered trademarks of Rational Software Corporation in the United States and/or in othercountries.All other names are used for identification purposes only, and are trademarks or registered trademarks of their respective companies.
Microsoft, the Microsoft logo, Active Accessibility, Active Channel, Active Client, Active Desktop, Active Directory, ActiveMovie, Active Platform, ActiveStore, ActiveSync, ActiveX, Ask Maxwell, Authenticode, AutoSum, BackOffice, the BackOffice logo, BizTalk, Bookshelf, Chromeffects, Clearlead, ClearType, CodeView, Computing Central, DataTips, Developer Studio, Direct3D, DirectAnimation, DirectDraw, DirectInput, DirectMusic, DirectPlay, DirectShow, DirectSound, DirectX, DirectXJ, DoubleSpace, DriveSpace, FoxPro, FrontPage, Funstone, IntelliEye, the IntelliEye logo, IntelliMirror, IntelliSense, J/Direct, JScript, LineShare, Liquid Motion, the Microsoft eMbedded Visual Tools logo, the Microsoft Internet Explorer logo, the Microsoft Office Compatible logo, Microsoft Press, the Microsoft Press logo, Microsoft QuickBasic, MS-DOS, MSDN, Natural, NetMeeting, NetShow, the Office logo, One Thumb, OpenType, Outlook, PhotoDraw, PivotChart, PivotTable, PowerPoint, QuickAssembler, QuickShelf, Realmation, RelayOne, Rushmore, SourceSafe, TipWizard, TrueImage, TutorAssist, V-Chat, VideoFlash, Virtual Basic, the Virtual Basic logo, Visual C++, Visual FoxPro, Visual InterDev, Visual J++, Visual SourceSafe, Visual Studio, the Visual Studio logo, Vizact, WebBot, WebPIP, Win32, Win32s, Win64, Windows, the Windows CE logo, the Windows logo, Windows NT, the Windows Start logo, and XENIX are trademarks or registered trademarks of Microsoft Corporation in the United States and other countries.
FLEXlm and GLOBEtrotter are trademarks or registered trademarks of GLOBEtrotter Software, Inc. Licensee shall not incorporate any GLOBEtrotter software (FLEXlm libraries and utilities) into any product or application the primary purpose of which is software license management.
Portions Copyright ©1992-2002, Summit Software Company. All rights reserved.
PATENT
U.S. Patent Nos.5,193,180 and 5,335,344 and 5,535,329 and 5,835,701. Additional patents pending.
Purify is licensed under Sun Microsystems, Inc., U.S. Patent No. 5,404,499.
GOVERNMENT RIGHTS LEGEND
Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in the applicable Rational Software Corporation license agreement and as provided in DFARS 277.7202-1(a) and 277.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct. 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 227-14, as applicable.
WARRANTY DISCLAIMER
This document and its associated software may be used as stated in the underlying license agreement. Rational Software Corporation expressly disclaims all other warranties, express or implied, with respect to the media and software product and its documentation, including without limitation, the warranties of merchantability or fitness for a particular purpose or arising from a course of dealing, usage, or trade practice.