Overview

This helper generates a report of the current Rhapsody INI file.

Applicable To	Project
Menu Entry	Power Pack  Reporting Tools  Generate INI File Report
Demonstration	Watch the Video

Operation

The helper creates a HTML report of the ‘current’ INI file (see below). The report is generated into the user temp directory. Each section in the INI file is presented in the sidebar, allowing easy browsing of the content.

A screenshot of a chat

AI-generated content may be incorrect.

The Possible Entries tab details additional entries that you could add to your INI file to control Rhapsody. These entries are largely undocumented in the IBM documentation.

Entries in the INI are grouped by tabs. Any lines in the INI file that are commented out (by adding a semi-colon at the start) are highlighted in green and entries with no content are highlighted in grey:

A screenshot of a computer

AI-generated content may be incorrect.

Helpers are listed as tabs in a sidebar and grouped into known tools:

A screenshot of a computer

AI-generated content may be incorrect.

Viewing the Report

After generation the report opens automatically:

· Inside Rhapsody (Rhapsody 10 or above)

· In the system web browser

· Both

Depending on the value of the following property:

RhapsodyPowerPack.ReportingTools.OpenInBrowser

Determining the INI File on Which to Report

When Rhapsody is launched, by default it uses the rhapsody.ini file located in USER_OMROOT (for a split install) or OMROOT (for an install with all files in one location). However, Rhapsody may be launched from a command line where a specific INI file may be specified as a command line switch. The “current INI file” may be seen in Rhapsody by selecting the menu Help  About Rhapsody and then clicking the Version Details button:

A screenshot of a computer

AI-generated content may be incorrect.

There is no Rhapsody API to detect the current INI file, however there is an API to read a specific entry from the current INI file and so the helper detects the INI file on which to report in the following order:

1. By Specific Key

If you have multiple INI files and use the command line to launch Rhapsody with those specific INI files, then you may add the following sections to those INI files:

[RhapsodyPowerPack]

ThisINIFile=C:\IBM\Rhapsody\10.0.1\rhapsody.ini

ThisINIFileDescription=Basic INI file with no debugging or logging options enabled.

If the ThisINIFile entry exists, then the helper uses that specified file. The description entry is optional but if used this is included in the report:

A screenshot of a computer error

AI-generated content may be incorrect.

2. User OMROOT

If no ThisINIFile entry is found in the file, then the helper looks in the USER_OMROOT folder for a rhapsody.ini file and if this is found then it is used for the report.

3. User OMROOT

Lastly the helper looks in the OMROOT folder for a rhapsody.ini file and if this is found then it is used for the report.

If no file is found using any of these approaches, then an error is reported.