Read this chapter if you are upgrading from a previous release of SoDA. It describes the changes made to SoDA between the SoDA 3.1.0b and SoDA 2001a.04.00 releases.
In this release, domains for Rational Rose 2000e and 2001 are provided with SoDA. The Rose domain for version 98i 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 2001 domain now 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. This has the advantage of improved performance and reduced memory consumption if Rose is already running on the machine, however note that if you are viewing a different model than the one required by the SoDA domain, the required model will automatically be loaded in your Rose session.
The Rose 2001 domain no longer uses encapsulated postscript as the format for graphics imported into a SoDA template, instead JPG is used. See the note under the Rose RealTime domain below for additional information regarding graphics.
Note that 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.
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 98i, 2000 and 2001 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 the new Rose 98i, 2000 or 2001 domains. An upgrade utility is provided with SoDA for upgrading older Rose templates for compatibility with Rose 98i, 2000 and 2001. The utility is accessible through the SoDA->Utilities->Upgrade Document... menu option. See the Upgrading SoDA section of the online help for more information. There is no template change between Rose 2000 and Rose 2001.
SoDA is shipped with Ghostscript 2.6.11, which is used during generation of Rose templates to improve the appearance of diagrams. Ghostscript may be optionally installed while installing SoDA. Note that the use of Ghostscript is only beneficial if you are running Rose 2000e. The Rose 2001 integration no longer generates encapsulated postscript files.
SoDA now includes a domain compatible with Rose RealTime 2001a.03.00 for Unix.
The environment variable SODA _GRAPHIC_FORMAT is used to specify the type of graphics files exported from the Rose or Rose RealTime domains. By default, this is set to jpg. In this case, when a document is generated from a Rose or RoseRT model, the domain will create a directory named <document name prefix>.dia and will fill it with a.JPG file for each diagram requested from the model. On Solaris, the environment variable SODA_GRAPHIC_FORMAT can be changed to tiff, which causes TIFF files to be generated rather than JPG
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 introduces 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.0 and TestMate 3.2 in this release.
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 2001a.04.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.
Ghostscript is public domain software provided without warranty. Its use is subject to the GNU General Public License