IBM Rational System Architect - Known Issues (2023)

IBM® Rational® System Architect® Known Issues

IBM Corporation
April 29, 2011

© Copyright IBM Corporation 1986, 2011

US Government Users Restricted Rights--Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This file contains known issues with the Rational System Architect versions below.

For known issues regarding Rational System Architect, please see the support site:

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect

CR # Description Comment
TLOG#49310 Some components in Rational System Architect utilities (for example, SA Compare and SA Simulator), check for license server version though Rational System Architect does not. These utilities require that the license server version is equal to or greater than the FLEXNet client component. However, Rational System Architect does not have the same requirement. Consequently, when the versions do not match, you get an error such as the following: "The License Server returned error code 508 There is a version mismatch between this application's FLEXNet library and the license server version. The version of the application's FLEXNet library is 11.5. The license server found is 19353@hostname and the version is 11.4. A supported configuration must have the server version equal or higher than the application's FLEXNet library version. Upgrading the license server is needed. " To workaround this problem, upgrade the FLEXNet license server to version 11.5 or higher version.

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect

CR # Description Comment

Beginning with Rational System Architect 11.3.1, in SQL Server, when you create new or upgrade existing encyclopedias created with versions prior to 11.3.1, the product creates users to execute stored procedures. The creation of these users and their purpose was not documented, in the online help or elsewhere.

For an explanation of the users created and what their purposes are, see the comment section to the right.

Important: The following information applies to creating new SQL Server encyclopedias or older SQL Server encyclopedias created with Rational System Architect 11.3.1 or older.

Rational System Architect creates users, of the type CERTIFICATE_MAPPED_USERS, to execute stored procedures that create views based on information calculated at run time. To enable these users to execute the stored procedures, the product also creates certificates for each of them to use. When they are created, the user names are appended with ‘CertUser’ suffix as follows:


By default, the users are assigned random passwords, which are generated based on a GUID. However, if your local machine has the Windows password policy enabled, you need to add an entry to the SA2001.ini file to control the format of the generated password.

To control the format of the certificate password, proceed as follows:

  1. Using your text editor of choice, open the SA.2000.INI file, located by default in
    C:\Documents and Settings\<UserProfileName>\Local Settings\Application Data\Telelogic\System Architect.
  2. To customize the permissible password values, note the following information about the format and permitted symbols:

    n or N = number 0-9
    s or S = symbol from the permitted symbols
    C = Capital letter A-Z
    c (and default) = lower case letter a-z

  3. Enter the following lines into the SA2001.INI file, adhering to the format and permissible symbols above.

    - If you do not specify permitted symbols, the default symbols are used, as shown above.
    - You can only use the symbols listed in the sample above.
    - If you do not specify a password format, a GUID-based password is used (which is the default behavior).
    - The maximum password format length is 128 characters.
    - The password is only used once to create and manage the certificate; you are not required to enter the password after the certificate is created.

  4. Save and close the SA2001.INI file.
  5. Restart Rational System Architect for the changes to go into effect.

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect

CR # Description Comment
59465 When Rational System Architect XT is installed on Microsoft Windows Server 2003 Enterprise Edition 64-bit, the following message may be displayed: "Unable to create Temp folder." To work around this issue, proceed as follows:
  1. Click Start, click Run, type cmd, and then click OK.
  2. Type the following command to enable the 32-bit mode: cscript %SYSTEMDRIVE%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1
  3. Type the following command to install the version of ASP.NET 2.0 (32-bit) and to install the script maps at the IIS root and under: %SYSTEMROOT%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
  4. Make sure that the status of ASP.NET version 2.0.50727 (32-bit) is set to Allowed and the other ASP.NET v2.0.50727 is Prohibited in the Web service extension list in Internet Information Services Manager.
  5. Launch iexplore from the desktop shortcut and type in http://localhost/saxt/default.aspx in the address link and page loads.
57625 When you export an Oracle catalog and select the 'Exclude Dafault Items' option, the file size of the exported catalog is not reduced. This occurs becaue Oracle catalogs are not filtered when they are exported as XML. The default permissions are also exported.

When you generate encyclopedia data with the SA Schema Generator, the data for 'Elementary Business Process’ definitions is not properly populated in the ODS database, when the data is retrieved for IBM Cognos.

There is no workaround for this issue.

If you log in as a user with non-admin permissions, the REST URI fails to return JPG and PNG.

As a workaround, a user with admin permissions can grant the non-admin user permission to the temp folder.

On Oracle 10g encyclopedias, when you relate a definition to another definition that is Checked Out or Frozen, and the definitions contain mirrored properties, and you click 'OK' to close the edit difinition dialog, junk characters may be displayed in an information message.

There is no workaround for this issue.

When you send encyclopedia artifacts to DOORS, link the artifacts in DOORS with the relationships 'Diagram linked to Definition' and 'Symbol linked to Definition,' then you update the data into Rational System Architect, the DOORS Transfer Unit and links to the relationships are not generated in the ODS database when the data is retrieved for IBM Cognos.

There is no workaround for this issue.

When running Rational Publishing Engine reports on workspace-enabled encyclopedias, the WMF file for diagrams on parent workspace are not returned. In the ODS database that is created for the encyclopedia, the diagram table contains the following columns for WMF diagram images:

  • 'DiagramWMFImage' - stores diagram WMF image in blob format
  • 'DiagramWMFImageURL' - stores the diagram WMF image URL

This issue is caused by the following:

  • The 'DiagramWMFImage' column does not contain the diagram blob information from the parent workspace ID, if the diagram is not modified in child workspace.
  • When used in a report with the child workspace ID, the 'DiagramWMFImageURL' will not return the diagram information of the parent workspace ID.
This will be addressed in a future release.

The SA Schema Generator fails to generate the encyclopedia schema in a cross domain environment. An 'Invalid Server/Encyclopedia name' message appears.

There is no workaround for this issue.

Unable to baseline an extremely large workspace-enabled encyclopedia.

Extremely large encyclopedia have exhibited timeout issues when attempting to perform a workspace baseline. This issue is being investigated.

On a Microsoft Windows 2008 server, when running the Workspace Schema option on an Oracle encyclopedia, the following error message is displayed: "A database error has occurred in OraOLEDB: ORA-01017: invalid username/password; logon denied." When you click 'OK' to close the error dialog, you get this other error message: "-2147217327 SAImf Error." Additioally, the Message Center displays "A database error has occurred in OraOLEDB: ORA-01017: invalid username/password; logon denied / There was a problem automatically opening the encyclopedia '<ency_name>' in System Architect. Please start System Architect and open this encyclopedia to complete the schema change."

To work around this problem, you should manually open the encyclopedia to complete the Workspace Schema operation.
58233 Relationships between symbols and diagrams are not included in the XML files that are generated by the Report Server Manager. Consequently, reports that use those XML files in Rational Publishing Engine are blank. There is no workaround for this issue.

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect 11.3.1.

(Video) What if... Basil Fawlty used IBM Rational System Architect to Optimize his hotel booking process

CR # Description Comment
54131 Diagrams are not displayed in the Compare Models output page when using Mozilla Firefox 3.0. This is an installation problem. The problem is that the IBM JRE 5.0 is not recognized by the Firefox browser. To resolve this problem, uninstall Firefox and the IBM JRE. Reinstall Firefox, and then reinstall IBM JRE (in that order). The diagrams will now be displayed in Mozilla Firefox 3.0.
54371 Rational System Architect crashes when you click Cancel while saving a file to the .XPS format, in the Object History dialog. To avaoid this issue, do not click Cancel while saving a file a file to the .XPS format.
54377 Incorrect relationships shown in Stakeholder Position Matrix. In Stakeholder Position Matrix, if you relate a Stakeholder to a Stakeholder, and then relate the Stakeholder Position to another Stakeholder, the former relationship will get lost. If you reload the matrix (through the ‘Reload’ command, or by closing and reopening the matrix), you will find that both relationships exist.
54691 With Microsoft Internet Explorer 6.0, you cannot expand the Diagrams and Definitions node in the ‘System Architect Browser’ when you log into Rational System Architect XT as Reader and open an encyclopedia created in previous version of Rational System Architect. Before attempting to open an encyclopedia created with an earlier Rational System Architect version, in SA Catalog Manager, the catalog for the server where the encyclopedia is stored should be upgraded to the current release, and the 'Publish Optimized XT Reader Views' should be run on the encyclopedia, which updates the permissions.
54721 Error message is displayed when clicked on 'Edit' button in 'Properties' window. To avoid this error message, do not double click the Edit button.
55447 When you try to create a report from Rational Publishing Engine (RPE), where the RPE client is in one domain, and you attempt to connect through the REST URI option to a machine on a different domain, a connection error occurs.

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect 11.3.

CR # Description Comment
48016 In System Architect, when you have a Baseline Workspace open, and attempt to create a new encyclopedia, you are unable to create the new encyclopedia, and the following message is displayed: 'The read-only version cannot create a new encyclopedia path. Please open an existing path.’ To prevent this error, do not attempt to create an encyclopedia while you have Baseline Workspace open. Instead, consider, shutting down and restarting System Architect, or open a non-Baseline encyclopedia before attempting to create a new encyclopedia.
48037 If System Architect shuts down abnormally when you have diagrams opened, the auto-recovery feature inappropriately displays the ‘Select Workspace’ dialog and enables you to select a Workspace, which makes it possible for you to select an incorrect Workspace. Ensure that you select the correct Workspace. Doing so allows the auto-recovery feature to recover and open your diagram(s).
48701 The speed at which Dynamic Views open in the Explorer is slower on all Views other than the ‘All’ Views. The ‘All’ Views opens at optimum speed, while other Views do not. You can use the ‘Classic Explore’ instead of the ‘Explorer’ for optimum performance.
49954 Information is lost when you change UML 2 diagram contents in a Workspace encyclopedia, where diagram is keyed by a parent Workspace Avoid creating UML 2 diagrams in enyclopedia Workspaces as this feature is not yet supported.


Using an encyclopedia's display name when you open it through the API can be noticeably slower than opening the encyclopedia through a connection string. If opening an encyclopedia through an API, do not use the encyclopedia’s display name. Use connection strings instead.
47887 When using the sym.Penstyle or sym.Linestyle in a VBA macro to modify the symbol, the settings do not get applied. For example, using ‘sym.PenStyle = PENSOLID4’ does not work. Do not use the sym.Penstyle or sym.Linestyle. As an example, use the following code instead ‘sym.SetField SYMFLD_PENSTYLE, PENSOLID4.’
47924 If you customize the installation of System Architect so that System Architect Catalog, System Architect Encyclopedia Manager (SQL Server) or System Architect Encyclopedia Manager (Oracle) are not installed, and you then install System Architect Encyclopedia XT over that customized installation, the shortcut icons for those components are not added to the Start menu. The shortcuts should be added because Rational System Architect XT uses those components to manage users and encyclopedia access. You can create shortcuts to launch the components and add them manually to the Start menu, Desktop, or elsewhere.


Previous Root Workspace history values are displayed under the current child Workspace column. For example, suppose you create definition ‘A’ in a Workspace named Root, and baseline the Root Workspace. You then create a Workspace named WS2, from the Root baseline. If you open Workspace WS2, and view definition ‘A’ in the History window, the Workspace column incorrectly displays WS2. It should display Root, the Workspace in which the definition was created.

There is no workaround for this issue.


When you create or modify a diagram property where the LENGTH value is 40000 or higher, in the diagram property dialog, the label for that property is displayed, but you cannot enter data into the field.

Do not create or modify properties where the LENGTH value exceeds 40000.


When you customize the installation of the System Architect Process Integrator for Visio 2003 or Visio 2007, and choose an installation path other than the default, the installation still creates the default installation path, with a duplicate of the “SetSecurity.InstallState” file.


When you install System Architect to a custom folder, then install System Architect XT over that custom installation, an additional ‘System Architect Suite’ folder is created.

All System Architect XT files are created in the location where System Architect is installed


When you update a definition property using the ‘Advanced Edit’ feature, the update is not shown in the Property pane, even if you selected ‘Yes’ to refresh the Explorer.

You can click the 'Refresh' option to view property updates.


The ‘Undo’ button becomes disabled when you apply a color scheme to any of the following diagram types: Class, State, Business Process, Organization Chart, Network Concept, Enterprise Direction, or Physical Data Model.


In System Architect Catalog Manager, no warning message is displayed when changes are made to the Users or Roles on an encyclopedia that has been enabled with the ‘Published Optimized XT Reader Views’ (also known as Libnet).

Users should be notified that hanges to their roles on an encyclopedia enabled with the ‘Published Optimized XT Reader Views’ have been made.


The 'Optimize XT Reader Views' do not get updated in System Architect Catalog Manager when you add permissions.

For permissions to be updated, you have to exit System Architect Catalog Manager, reopen it, and click on the 'Publish Optimized XT Views' menu option.


When you import an XML file of an Entity Relationship Diagrams containing 2 entity symbols, but only one of them has a definition, both entity symbols are imported into the repository. Only one entity symbol is shown on the diagram, but a Delete Diagram preview shows tow entities.

A workaround for this issue is to move one the entity symbol shown on the diagram, and save the diagram. Afterwards, only the entity shown on the diagram is shown on the Delete diagram preview.


The OV-5 diagram is not autorefreshed after after you branch ICOMS.


System Architect Process Integrator files are installed directly into the ‘C:’ drive without any folder being created.


It is not possible to move packages across packages by dragging them in UML tab.


The System Architect Explorer is not refreshed when you pressing the F5 key.


Incorrect message - Auto-Arrange Left to Right without save.


Incorrect stylesheet for lines on Business Process diagram.


‘Generate User Prop..’ option not functioning in baseline enabled encyclopedia.

51906 While trying to open an encyclopedia with Rational System Architect 11.3, an error message similar to the following may be displayed: “Unprintable char at line#12: at char position# 27." The workaround for this issue is to delete the ‘solnprops.cfg’ file in the temp folder. Additionally, you should modify the ‘solnprops.cfg’ file in the encyclopedia so that either a blank line or a comment is the last line in that file. To do this, you have to export the ‘solnprops.cfg’ file, modify it (as described above), and import it back into the encyclopedia. See the Rational System Architect online help for information on the temp folder and modifying files in the encyclopedia.

The table below contains Change Request numbers, issue descriptions, and comments (where applicable) for Rational System Architect 11.2.

CR # Description Comment
TLOG#52027 When attempting to install Rational System Architect version 11.2.15, an extranous version of the misexec.exe file can be found running in the Task Manager. Consequently, you cannot install Rational System Architect version 11.2.15. To workaround this issue, you should 'kill' the msiexec.exe process in the Task Manager.

For details of problems that have been resolved in Rational System Architect V11.3, view the What's New file, located in the Rational System Architect Information Center:

Please visit our Rational support overview site at:
You will find a one-sheet reference guide about how to best contact support in your geography.

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 written license inquiries to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785

(Video) Overview of IBM® Rational® System Architect® Analytics

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send written inquiries to:

IBM World Trade Asia Corporation
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

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:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

(Video) Overview of IBM® Rational® System Architect® Analytics

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 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.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples 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.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.


IBM, the IBM logo, and are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copy and Trademark information at


(Video) Supporting regulatory standards with the IBM Rational solution for systems and software engineering

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds 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.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office

UNIX is a registered trademark of The Open Group in the United States and other countries.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

(Video) How to Polish your IBM Rational System Architect Diagrams

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product or service names may be trademarks or service marks of others.


1. Service-oriented Architecture Analysis with Rational System Architect Part III
2. Rational Requirements Composer and Rational Software Architect Integration
3. 5 Reasons IBM i RPGers Are Switching to RDi
4. System Architect Design Manager 11.4.3
(System Architect)
5. 321 Gang: IBM Rational Solutions for Tools Validation in an FDA Environment
(321 Gang)
6. System Requirements and Use Cases in an IBM Rational Environment
(321 Gang)
Top Articles
Latest Posts
Article information

Author: Terrell Hackett

Last Updated: 16/06/2023

Views: 5995

Rating: 4.1 / 5 (52 voted)

Reviews: 91% of readers found this page helpful

Author information

Name: Terrell Hackett

Birthday: 1992-03-17

Address: Suite 453 459 Gibson Squares, East Adriane, AK 71925-5692

Phone: +21811810803470

Job: Chief Representative

Hobby: Board games, Rock climbing, Ghost hunting, Origami, Kabaddi, Mushroom hunting, Gaming

Introduction: My name is Terrell Hackett, I am a gleaming, brainy, courageous, helpful, healthy, cooperative, graceful person who loves writing and wants to share my knowledge and understanding with you.