Read this chapter if you are upgrading from a previous release of SoDA. It describes the changes made to SoDA between the SoDA 2001a.04.00 and SoDA 2002.05.00 releases.
In this release, domains for Rational Rose 2001a and 2002 are provided with SoDA. The Rose domain for version 2000e is no longer included. You must have Rational Rose installed in order to use the Rose domain. During the installation process, you will be asked for the location of your Rose installation. SoDA will automatically enable the Rose domain compatible with the release of Rose that you are using.
The Rose 2002 domain operates as a client-server application, if you have Rose already running on your machine, the Rose domain will connect to that instance of Rose for retrieving model information.
The Rose 2002 domain supports JPEG, TIFF and Postscript graphics.
Note that the JPG and TIFF graphics rendered in a FrameMaker+SGML document may not always appear as cleanly as postscript images. This is most observable when a graphic is scaled to a small size. Increasing the visible size of your document (say to 140% or more) will reveal the missing detail, or printed documents will also show full image quality.
If you are using Rose for the first time, it is recommended that you run Rose at least once before attempting to generate a Rose template. This ensures that Rose properly sets up your Windows emulation environment.
By default, a.JPEG file is created for each Rose or RoseRT diagram requested from your model. This default can be overridden by using the environment variable SODA _GRAPHIC_FORMAT to specify the type of graphics files to be exported from the Rose or RoseRT domains. Setting SODA_GRAPHIC_FORMAT to tiff before starting SoDA, will cause TIFF files to be generated rather than JPG. Setting SODA_GRAPHIC_FORMAT to eps, will cause encapsulated postscript files to be generated.
Note: At this time postscript graphics are not supported through the RoseRT domain, only jpg images can be included in your SoDA documents. Postscript graphics support for RoseRT is expected to be included in an uncoming service patch for RoseRT 2002.05.00.
If you are using SoDA on HP-UX, please see "Known Limitations" on page 11 for important information regarding using the Rose integration on that platform.
Users of Rational Rose who are upgrading from SoDA 3.0.1C or earlier should note that the schema for the Rose 2001a and 2002 domains is different from that of the Rose 98 domain shipped with previous versions of SoDA. The Rose templates shipped with SoDA have been updated to the new schema, however your existing Rose templates cannot be edited or generated using newer Rose domains. An upgrade utility is provided with SoDA for upgrading older Rose templates for compatibility with Rose 2002. The utility is accessible through the SoDA->Utilities->Upgrade Document... menu option. See the Upgrading SoDA section of the online help for more information.
SoDA is shipped with Ghostscript 2.6.11, which is used during generation of Rose templates to improve the appearance of postscript diagrams. Ghostscript may be optionally installed while installing SoDA.
SoDA now includes a domain compatible with Rose RealTime 2002.05.00 for Unix.
The Apex domain supports Apex 3.2, and Apex 4.0 in this release. The Apex domain for version 3.0 is no longer included on the distribution media. Contact Rational Customer Support if you still require this combination.
The Apex domain for Apex 4.0 includes the Apex/ClearCase integration. Apex/ClearCase provides the Apex development environment while enabling the use of ClearCase for configuration management and version control. If you are using the Apex/ClearCase integrations, there are a few limitations to be noted:
The TestMate domain supports TestMate 3.2 and TestMate 4.0 in this release. The TestMate 3.0 integration domain is no longer included.
The SoDA integration domain for ClearCase 3.0 and later is included in this release. This version of the ClearCase domain contains an updated schema for better compatibility with the ClearCase domain available on Windows. ClearCase 4.0 or later is required to use the UCM features of the ClearCase domain.
This release of SoDA includes support for ClearQuest 2002..05.00 on Unix. If you have Rational ClearQuest for Solaris or HP-UX, you may use SoDA to document your ClearQuest database.
The ClearQuest domain utilizes a feature of SoDA/Frame called dynamic schema generation. This feature allows SoDA to determine the schema corresponding to a particular ClearQuest database at runtime. Since different ClearQuest databases will have different schemas, the properties and relationships available within a ClearQuest template depend on the database being documented. SoDA communicates with ClearQuest to determine the schema for a particular database as needed. This may happen during template customization, or during generation. SoDA will prompt you for a login name and password for your ClearQuest database. There will be a short delay while SoDA communicates with ClearQuest to obtain the database schema.
For further information on how to use the ClearQuest integration, please see the on-line help.
