IBM® Rational® SoDA® for Word Service Release 2003.06.13 Release Notes


Version 2003.06.13

Release Date: September 2004

Last Updated: 08/03/2004

Material ID/Part Number: GI11-5919-03


© Copyright IBM Corporation. 1996, 2004.  All Rights Reserved.

Any reproduction or distribution of this work is expressly prohibited without the prior written consent of IBM Corporation.

Legal Notices Information


These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications at www.ibm.com/shop/publications/order. Search for GI11-5919-03 to find the latest version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to www.ibm.com and enter "IBM Publications Center" in the Search field.)


Scope

Product changes described in this document and contained within this service release apply to:

The Service Release Notes includes:

Getting Started

Installation Information

When you are ready to install IBM Rational SoDA, be sure to check the Web for the latest available downloads:

1.       Go to  http://www.ibm.com/software/rational/support/.

2.       Then, go to the Download Center and navigate to Rational patches and service releases.

Installation Issues

Difficulty Installing SoDA for Word on a French Windows NT SP6a Operating System

SoDA for Word will not install successfully on a French Windows NT4 SP6a operating system unless Internet Explorer (IE) 6.0 and the Microsoft Security Roll-Up Patch (SRP) [that is, Windows NT 4.0 Service Pack 6a (SP6a) Hotfix] are already installed. If the following message is displayed while you are installing SoDA for Word:

"This product to restrict installs to NT4SP6a and up, W2K SP2 and up, and WinXP"

Cancel the installation, install IE 6.0 and the Microsoft SRP, and then install SoDA for Word.

After Installing IBM Rational Product, Restart System Before Applying This Service Release

After you install a Rational product, you must restart your system before applying this service release. Do not apply this service release until you have restarted your system after installing a Rational product. See RATLC516372, below.

RATLC00516372 - If the Rational Setup Wizard does not appear when you apply this service release, use Windows Task Manager to end one of the msiexec.exe processes. The Rational Setup Wizard window should appear. If it still does not appear, cancel the next msiexec.exe. As a result, installation of this service release should be successful. Workaround: Restart you system before applying this Service Release.

IMPORTANT NOTICE!! Microsoft Windows 2000 NTFS "Change Journal" defect can cause file system corruption during installation of Rational products

Under certain circumstances, file system corruption can result from installing Rational Version 2003 products on Windows 2000 to an NTFS partition that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000.  Before you install any Rational Version 2003 product on Computer that is running Windows 2000:

  1. Disable all virus detection software
  2. Read IBM Support Technote 1135295. Go to http://www-1.ibm.com/support/us/search/index.html and search for "Rational Installer Change Journal."
  3. Read Microsoft Knowledge Base article 820888 at http://support.microsoft.com/default.aspx?scid=kb;[LN];820888.  This article includes information about an update from Microsoft that fixes the defect.

Compatibility Issues

Rational Products

SoDA for Word version 2003.06.xx can report on Rational products of the same version, 2003.06.xx.  SoDA is backwards compatible in the same way that any Rational point product is backwards compatible (i.e. if an individual Rational product version 2003.06.xx can read data from an earlier version of that product, then SoDA can also read that data and report on it).

Menu Incompatibles

This release contains no menu corruption or compatibility issues for ClearCase and Adobe Acrobat 5.0.5.  Therefore, it is no longer necessary to use the commands on the SoDA toolbar instead of the commands on the SoDA menu.

Product Documentation

Documentation for IBM Rational is available on-line at http://www.ibm.com/software/rational/support/documentation/.

Restrictions and Guidelines on Using SoDA

Defects fixed in this release

Component

RATLC ID

Description

SoDA for Word

RATLC00020191 Report Generation Fails, upon creating a domain extension that calls a script.  Script attributes not working correctly.

SoDA for Word

RATLC00369599

Sequence Diagrams (REPEAT - interaction diagram) text display poorly as there is not enough space between characters.  Characters are overlapped  Caused by incorrect height proportions on inserted diagram image.

SoDA for Word

RATLC00373091
RATLC00456221 / IC40481

Extra Repeat Commands (white space) when no objects present during Recursion (when setting "ParaMarkerAfterRepeat=FALSE").  SoDA introducing a new line at the end of each ITERATION RESULT of RECURSIVE REPEAT.

SoDA for Word

RATLC00375046 / IC37820

Following error can occur when attempting to generate Read-Only SoDA report against a Rose Model in ClearCase:

This file could not be found
Try one or more of the following:

  • Check the spelling of the name of the document
  • Try a different file name
SoDA for Word RATLC00375734 / IC39750 In Word XP, SoDA commands in template include a space between annotation and the placeholder causing the related formatting not to be included in generated report.  Workaround included removing the extra spaces, however, when the template is reopened, the spaces are re-inserted. The formatting has to be preserved in the report regardless of the space between the annotation and the placeholder.

SoDA for Word

RATLC00376423

FormattedText property does not work correctly for Word Bookmark, Paragraph and Heading.  Word does not transfer the style for bulleted items or captions if the Bookmark does not include a paragraph marker.

SoDA for Word

RATLC00376665 / IC40428

The following error may occur when generating a template with a one row table with a wrap-around SoDA REPEAT command (when using SoDA 2003.06.12):

Unexpected error has occurred.  Please restart Word and try again.  If the error persists, please contact technical support.

SoDA for Word RATLC00377444
RATLC00723623 / IC41194
In versions of SoDA previous to SoDA 2003.06.12 menu items were implemented through Word macros.  In SoDA 2003.06.12 some of these macros were removed from the SoDA Release due to the addition of COM Add-In functionality.  Due to customer request, the majority of the macros have been added back to this Release of SoDA (2003.06.13), see below*.
SoDA for Word RATLC00377626 / IC41318 Report generation may hang and consume memory when generating a template that includes one or more Rose diagrams using the scale to fit option in the DISPLAY command.

SoDA for Word

RATLC00720851

The following error may show when attempting to run templates that include tables after upgrading to SoDA for Word 2003.06.12j:

Unexpected error has occurred. Please restart Word and try again. If the error persists, please contact technical support.

Upon reviewing the Word *.doc the SoDA commands appeared to be placed in the wrong position.

SoDA for Word RATLC00723623 / IC41194 Macros necessary to automate SoDA reports are being re-added to SoDA 2003.06.13.
SoDA for Word RATLC00724544 / IC41433 SoDA 2003.06.12 does not work with templates created with previous versions of SoDA correctly.  When trying to generate reports, the following error may occur:

An unexpected error has occurred, please restart Word and try again

Upon trying to open the template, using the template view, you may encounter missing annotation errors.

* In relation to RATLC00377444 and RATLC00723623, the following macros are added back to SoDA 2003.06.13:

To Run Macro's:

In Microsoft Word select Tools > Macro > Macros. In the Macros dialog box select a macro name from the list and click  Run.

Files changed by this release

rosert.dll
sodastartup.exe
sodamacros.dot
soda.rsc
SoDAWord2000.dll
SoDAWord2002.dll
SoDAWord2003.dll
xmlagent.dll

Contacting IBM Rational Software Support

The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support homepage can be found at http://www.ibm.com/software/support.

Voice Support is available to all current contract holders via a telephone number in your country (where available). For specific country phone numbers, please refer to the IBM Software Support Handbook, Appendix B: Contact Information, found at http://www.ibm.com/software/support.