Before using this information, be sure to read the general information under Appendix. Notices.
This edition applies to version 7.0.0 of IBM Rational Test RealTime and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces C83FZNA.
You can download the most current edition of this document from the IBM Publications Center, as follows:
For upgrade and installation information, see the "IBM Rational Test RealTime Installation Guide" (GI11-6757-00)
This section describes new product features in version 7.0.0 of IBM Rational Test RealTime.
This section contains announcements about important changes to IBM Rational Test RealTime.
Table 1 lists new options and arguments for commands.
Command | Description |
---|---|
crccc | C Code Review Compiler |
crcld | C Code Review Linker |
Table 2 lists new options and arguments for commands.
Command | New option or argument | Description |
---|---|---|
attolcc1 and attolccp | -NOFULLPATHKEY | Identifies source files based only on the filename instead of the complete path. Use this option to consolidate test results when a same file can be located in different paths. This can be useful in some multi-user environments that use source control. If you use this option, make sure that the source file names used by your application are unique. |
attolccp | -NO_DATA_TRACE | C++ only. Excludes from instrumentation structures or classes that do not contain methods. This reduces instrumentation overhead. |
attolcov | -CLEAN and -MERGETEST | New options for Code Coverage to clean up cumulated trace files to regain disk space. |
attolcc | -METRICS, -ONE_LEVEL_METRICS, and -RESTRICT_DIR_METRICS | New options that replaces the metcc command line tool. |
Table 3 lists obsolete commands, options, and arguments for commands.
Command | New option or argument | Description |
---|---|---|
metcc | This command is replaced with the -metrics option in attolcc. |
None.
This section describes known problems in this release of IBM Rational Test RealTime.
Table 4 lists significant problems in previous releases that are fixed in version 7.0.0.
Problem ID | Description |
---|---|
RATLC00866973 | Unable to change the font size and color of the Output Window. |
RATLC00869159 | In the Eclipse integration, the verbose mode which is set in the Eclipse preferences, is only applied to the workbench after the project settings have been opened and saved. |
RATLC00869172 |
In the Eclipse integration, each time you click on a report link, Eclipse opens a new source editor. |
RATLC01099649 | The IBM Rational ClearQuest integration with IBM Rational TestManager is incompatible with the IBM Rational ClearQuest integration with Test RealTime. |
RATLC01190452 | In Component Testing for C++, a 'const' qualifier on
a return type is instrumented as a void return which causes compilation errors.
Workaround: remove the 'const' qualifier. |
RATLC01190494 | In Component Testing for C, when parsing a .ptu test script that contains nested INCLUDE instructions and within each included test script there are IF / ELSE / END IF statements, the following error occurs: "The keyword ELSE doesn't match with a keyword IF". |
RATLC01190422 | On zLinux for IBM zSeries, if the product generates an "undefined reference to clock_gettime" message in the link phase, add the '-lrt' parameter to the configuration settings in Build > Linker > Additional objects or libraries. |
RATLC00387114 | Ada Test Script Compiler terminates abnormally when stubbing a procedure that is not included in a package. |
RATLC01190479 | Compilation error of the runtime on Solaris with Sun Forte 6.2 compiler.
Workaround: In the file att.c line 1247, change the type "int" to "void". |
RATLC01190488 | Instrumented code compiles with error C2660: '_atk_get_lock' : function does not take 0 parameters. |
RATLC00867882 | User interface splits multi-parameter preprocessing macros in the wrong place. |
RATLC01190333 | A test script that has a name with an accented character in it causes the report generation to fail. |
This section lists the problems fixed in this release of Test RealTime.
Table 5 lists significant problems in previous releases that are fixed in version 7.0.0.
Problem ID | Description |
---|---|
APAR IC48120; RATLC01104836 | Component Testing for Ada: When testing a string one character long, an empty string was displayed in the report. |
APAR PK12757; RATLC01100341 | Component Testing for Ada: When stubbing a child unit within a package, an error message was generated at build time |
APAR PK15236; RATLC01103844 | Component Testing for Ada: Support for Standard.Wide_Character has been fixed. |
RATLC00867781 | Component Testing for Ada: Test script generator aborted with error message "entity not found". |
APAR IC46748; RATLC01089880 | Component Testing for Ada: Test script generator created an empty script in the case of a package that contained only generic procedures. |
APAR IC48492; RATLC00869219 |
Component Testing for Ada: Test Script Compiler required STANDARD.WIDE_STRING even in Ada83 mode. |
RATLC00387114 | Component Testing for Ada: Test Script Compiler terminated abnormally when stubbing a procedure that was not included in a package. |
APAR PK17313; RATLC01107849 |
Component Testing for Ada: The following error message occurred: "Internal error in the function is_unconstraint_type". |
APAR PK18349; RATLC00385527 | Component Testing for C: CSV decimal separator could not be set to a decimal point in the dataPool sample. |
RATLC00867622 | Component Testing for C: When the keyword END STUB was missing, the generated code was incorrect and no error messages were displayed |
APAR PK20760; RATLC00869081 | Component Testing for C: Test script compiler terminated abnormally when encountering an enum statement with arithmetic expression vales. |
APAR IC45698; RATLC01082215 | Component Testing for C: User interface terminated abnormally when switching from a test report to a coverage report while the test report was loading. |
RATLC00867505 | Component Testing for C: Undeclared stubs are now automatically generated to ensure successful link. |
APAR IC48633; RATLC00868745 | Component Testing for C: Test script compiler terminated abnormally when casting to void* in a VAR statement |
APAR PK10038; RATLC01096100 | Component Testing for C: When a variable was declared and initialized in a DEFINE STUB block, the initialization was not taken into account |
APAR PK12263; RATLC01099313 | Component Testing for C: Test script compiler terminated abnormally when encountering an environment block with a VAR statement with both INIT IN and INIT WITH variables overridden in the ELEMENT block. |
APAR IC47509; RATLC01099957 | Component Testing for C: Compiled test script contained direct call to the system memcpy function. |
APAR IC44552; RATLC00866818 | Component Testing for C: During the execution of the wizard, the value in the Settings dialog box for the Default include directories was copied to the User include directories. This leaded to a duplication of include directories that could generate a command line too long for the command line processor. |
APAR PK19498; RATLC01110585 | Component Testing for C++: Contract check could generate incorrect C++ code when instrumenting virtual methods. |
APAR IC46116; RATLC01085628 | Component Testing for C++: When applying a contract check to a class that contained methods that return a pointer to a template class, the instrumented code might not compile. |
APAR PK08614; RATLC01089962 | Component Testing for C++: When applying a contract check to a class member function returning a pointer type "const signed char *", the instrumented code might not compile. |
APAR IC46802; RATLC01094286 | Component Testing for C++: When applying contract check to a method that returns "const std::wstring&" with the option --no_exceptions_generation_allowed set in the TDP, the instrumented code could not compile. |
APAR PK09090; RATLC01094714 | Component Testing for C++: CHECK METHOD statement might not work correctly when used for a method of a class within a specific namespace |
APAR PK10635; RATLC01096864 | Component Testing for C++: Internal error when analyzing the Microsoft Visual .NET ATLMFC include files. |
APAR PK10848; RATLC01097214 | Component Testing for C++: When testing methods that took a parameter of a type declared in a class, the C++ code generated by the test script compiler was incorrect. |
APAR IC48009; RATLC01103947 | Component Testing for C++: Incorrect C++ code was generated by the test script compiler. |
APAR IC48853; RATLC00144561 | General: Newly created C sub-projects to a C++ project did not build correctly without editing the settings. |
APAR PK18073; RATLC00867022 | General: HTML report exported from coverage results generated by the IBM Rational Rose RealTime integration might have had broken links |
RATLC00867929 | General: The term "script in error" at the end of the traces was confusing and has been changed to "errors detected". |
APAR IC48540; RATLC00868174 | General: Saving an existing projects as a new one incorrectly changes the System Testing test script name in the project browser. |
APAR PK10571; RATLC01096780 | General: User interface does not start and no error message is displayed if the library qt-mt332.dll is not found. |
APAR IC47576; RATLC01100804 | General: The "#pragma interface" and "#pragma implementation" directives are not correctly handled in some cases. |
APAR PK16866; RATLC01105234 | General: When viewing the Code Coverage report in the user interface via the context menu in the project browser the user interface aborts abnormally. |
APAR PK19270; RATLC01109678 | General: User interface terminated abnormally when trying to read a very large and incomplete test report. |
APAR IC48273; RATLC00868092 | General: Syntax highlighting in the editor highlighted keywords in mixed upper and lowercase, which are not recognized by test script compiler. |
APAR PK10104; RATLC01096152 | General: When opening multiple editor tabs in Studio, if you right-clicked on a tab that it was not selected and then selected close, a new menu editor would appears and would not vanish. |
APAR PK08753; RATLC01094300 | General: When a new project was created, the full path to the TDP directory was saved. When the project was re-opened on another computer and the TDP is in another directory the project could not be built because the TDP could not be found. |
APAR IC46826; RATLC01094442 | General: When building a project and generating HTML reports from the command line, the user interface terminated abnormally when the build process failed at the link stage. |
APAR IC47205; RATLC01097178 | General: When double clicking on the test node, the user interface opened all the reports even if no data was available for some of them |
APAR IC47777; RATLC01102669 | General: When creating a new project by importing a makefile, files with a minus sign (or hyphen) in their name were not imported correctly and files with more than one ".." in their relative paths were not imported. |
APAR IC45000; RATLC01077577 | IBM Rational TestManager Integration: In the TestManager integration, the TestLog only gave access to the first child project node execution report. |
APAR PK18970; RATLC00868286 | IBM Rational Rose RealTime integration: Rose RealTime integration did not pick up user objects in C language models |
APAR PK05694; RATLC01085723 | Runtime Analysis: Support for variable size arrays has been added to the instrumentor. |
APAR IC47552; RATLC01100250 | Runtime Analysis: Strings with a tba character "\t" were incorrectly dumped to the buffer in the TDP runtime. |
APAR IC47622; RATLC01101801 | Runtime Analysis: Environment variables were not expanded in the User Include Directories setting. |
APAR IC47737; RATLC01102295 | Runtime Analysis: The instrumentor generated an error message when it could not decide what operations to perform to convert one object from one class to another. |
APAR IC47336; RATLC01102571 | Runtime Analysis: Warning "wrong categorization" error message could occur when analyzing a specific Ada construction. |
APAR PK09091; RATLC01094718 | Runtime Analysis: The right section of an HTML code coverage report was not printed correctly with Microsoft Internet Explorer. |
APAR IC46917; RATLC01095247 | Runtime Analysis: A 'error C2099: initializer is not a constant' message could occur when compiling instrumented code using a dynamic piece of code inside a static variable initializer. |
APAR PK10798; RATLC01097070 | Runtime Analysis: Loading certain specific TIO/FDC files (containing errors) would terminate abnormally the user interface. |
APAR IC48568; RATLC00868384 | Runtime Analysis: Analysis of a certain specific Ada constructions failed. |
APAR IC46683; RATLC01089430 | Runtime Analysis: Incorrect code was generated when using the nocheck (<->) symbol for a unconstrained stub parameter |
APAR IC48138; RATLC01104981 | Runtime Analysis: During the instrumentation process the attolada instrumentor terminated abnormally on specific Ada statements. |
APAR IC48363; RATLC00868183 | Runtime Analysis: Instrumentor produced an error when an enclosed class was defined outside of a class. |
APAR IC47819; RATLC01102976 | Runtime Analysis: When instrumenting some template functions the FDC file was not generated correctly. |
APAR PK17624; RATLC00868107 | Runtime Analysis: Instrumentor did not set line number for calls using function pointer |
APAR IC47292; RATLC01098119 | Runtime Analysis: When instrumenting certain specific C++ constructions using many template instantiations, the instrumentor could terminate abnormally without outputting an error message. |
APAR IC48091; RATLC01104371 | Runtime Analysis: During the instrumentation of certain C++ files the following error message is displayed and the instrumentation process aborts TestRT attolccp with an "internal error" message. |
APAR IC48261; RATLC00868084 | Runtime Analysis: When searching the stack for MIU, the runtime searched too far down the stack |
APAR IC45528; RATLC01080935 | System Testing for C: atspreproCPP test script compiler produced a syntax error if an identifier was very long. |
APAR IC45919; RATLC01083806 | System Testing for C on Solaris. When generating a test report form certain RIO and TDF files using "atsmerge" the program terminated abnormally. |
APAR IC45978; RATLC01084735 | System Testing for C: When displaying multiple System Testing reports, the summary displayed an erroneous count of passed and failed tests. |
APAR PK11454; RATLC01098134 | System Testing for C: The test report displayed transcoded characters and not the original ones. |
APAR PK10638; RATLC01096866 | Target Deployment Port: The input/output code in the Ada TDP is using child units which is not compatible with Ada83 code in GNAT. |
APAR PK13527; RATLC01101155 | Target Deployment Port: TDP Editor could hang when trying to update a specific TDP from Test RealTime version 2002.05.21. |
If you have questions about installing, using, or maintaining this product, contact IBM Customer Support as follows:
The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support Home page for Rational products can be found at http://www.ibm.com/software/rational/support/.
Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to http://www.ibm.com/planetwide/.
The IBM Support Assistant (ISA) is a locally installed serviceability workbench that makes it both easier and simpler to resolve software product problems. ISA is a free, stand-alone application that you download from IBM and install on any number of machines. It runs on AIX, (RedHat Enterprise Linux AS), HP-UX, Solaris, and Windows platforms.
ISA includes these features:
For more information about ISA, including instructions for downloading and installing ISA and product plug-ins, go to the ISA Software Support page.
IBM Support Assistant: http://www.ibm.com/software/support/isa/
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.