Plugins
Additional configuration management items can be added by using the Plugins capability.
This is done by adding textual file to the plugins directory in the STM_ROOT directory. The text files have the extension .txt. Each file describes the elements needed for a plugin entry. In addition a directory will be added under the plugins directory of the Workarea and Databank to hold the data.
The <plugin>.txt file format:
NAME <name of the tool to be displayed in Rational Statemate Main Window>
ABBREV_NAME <abbreviation of the tool name (for Workarea browser use)>
ICON <path to icon (X-Icon) to be displayed in main window>
ICON_DIMMED <path to icon to be displayed in main window when dimmed>
COMMAND <path to command - See below>
FILE_TYPE <file extension - See below >
SUBDIR <sub directory in the plugins directory>
LICENSE <String. Usage to be defined in future ><path to command> - to be executed when clicking on the icon or when double clicking on a file with a matching extension in the Workarea browser. The command will be called with the following parameters:
1. <project name>
2. <user name>
3. <Databank path>
4. <Workarea path>
5. <STM ROOT>
6. [<The file name in the Workarea>]. Include the directory name, relevant only when executed from double clicking in the WAB.
<file extension> - of file related to the tool. This type will become a configuration item.Only the NAME and COMMAND, above, entries are mandatory.
In the case of the ICON entry used, an icon will be displayed in the main window.
In the case of FILE_TYPE entry used, a configurable item will be added to Workarea browser list, and double clicking on the file will invoke the COMMAND with the file name.
All plugins files will be saved in a new directory in the Workarea, and in the Databank subdirectory "plugins" or in the case of a SUBDIR entry in the plugin text file, in
The specified sub directory.Example of a <plugin>.txt file :
NAME ClearCaseExplorer
ICON C:\IBM\Rational\Statemate\4.6\etc\mmi\stm\CCexplorer.xpm
COMMAND C:\IBM\Rational\Statemate\4.6\bin\clear_case_explorer.bat