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.

Rational System Architect 11.3.1.4

For known issues regarding Rational System Architect 11.3.1.4, please see the support site: http://www.ibm.com/software/awdtools/systemarchitect/support/.

Rational System Architect 11.3.1.3

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

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.


Rational System Architect 11.3.1.2

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

CR # Description Comment
59896

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:

SASP_XTReaderCreateViewsCertUser
SASP_XTReadCreateProfViewsCertUser
SASP_WorkspacesViewsUpdateCertUser

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.

    [Database]
    PermittedSymbols=!£$%^&*()_+-={}[]:@;~#?/.>,<|\
    PasswordFormat=CcnsCcns
    Note:
    - 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.


Rational System Architect 11.3.1.1

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

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

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

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

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

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

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

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

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

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.

 


Rational System Architect 11.3.1

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

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.

 


Rational System Architect 11.3

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. 

46771

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.

49649

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.

47930

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.

47981

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.

 

48097

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

48157

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.

48293

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.

 

48374

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.

49687

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.

48630

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.

49044

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

 

49969

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

 

48503

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

 

49826

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

 

49973

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

 

50460

Incorrect stylesheet for lines on Business Process diagram.

 

50204

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


Rational System Architect 11.2

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.


Fixed Problems

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: http://publib.boulder.ibm.com/infocenter/rsdp/v1r0m0/index.jsp.


Contacting Support

Please visit our Rational support overview site at: http://www.ibm.com/software/awdtools/systemarchitect/support/.
You will find a one-sheet reference guide about how to best contact support in your geography.


Notices

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
U.S.A.

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
Licensing
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:
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:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142
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 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.

Trademarks

IBM, the IBM logo, and ibm.com 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 www.ibm.com/legal/copytrade.html.

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.

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.