Tool Mentor: Accessing Rational ClearCase from Rational Rose

Purpose

This tool mentor describes how to use the Rational Rose ClearCase add-in to access Rational ClearCase in order to manage changes to Rose model files and their generated source code files.

This section provides links to additional information related to this tool mentor.

Overview

The Rational Rose ClearCase add-in provides a tight integration between Rational ClearCase and Rational Rose. Using this add-in, you can access many ClearCase functions from within Rational Rose, making it simple and convenient to set up and ensure source control and change management for Rose model files, as well as some types of Rose-generated source files.

Rational Rose files include model files (.mdl), files and controlled units (.cat, .sub, .prc, .prp), as well as source files generated from ANSI C++ or Rose C++ classes and components.

For details about Rose files, refer to the Controlled Units topic in Rational Rose online help.

Tool Steps

In order to successfully work with Rational ClearCase from Rational Rose, you must ensure that the Rose ClearCase add-in is active in the Rose Add-In Manager. You can then perform the following ClearCase tasks from within Rose:

Create and manage the Rose development environment
Add Rational Rose files to Rational ClearCase version control
Check in and check out Rational Rose files
View Rational ClearCase information about Rational Rose files
Deliver Rational Rose files to the integration stream
Update a work area from the integration stream

1. Create and manage the Rational Rose development environment

You can use Rational Rose ClearCase menus to perform many of the tasks required to create and manage the Rose development environment from within Rose:

Use Start Version Control Explorer to view ClearCase Details and gain access to ClearCase environment commands, including commands for working with VOBs, views, branches, streams, and projects.
Use Project Explorer to create and work with ClearCase projects, views, and streams. Once you start the Rational ClearCase Explorer, you have access to all of the ClearCase commands that allow you to define and promote baselines, deliver and rebase streams. This command is only available if you are running ClearCase 4.0 or higher.

For More Information

Refer to these Rational ClearCase Tool Mentors:

2. Add Rational Rose files to Rational ClearCase version control

To add files to Rational ClearCase version control from Rational Rose, you can use Rose shortcut menus, or choose Add to Version Control from the ClearCase submenu on the Rose Tools menu. Depending on the version of ClearCase you are running, this command displays a Rose dialog that interfaces with ClearCase, or it displays the actual ClearCase dialog. You can also remove files from ClearCase version control using Rose ClearCase commands.. However, you should always exercise caution when removing files from version control.

For More Information

For details about adding and removing files from Rational ClearCase version control, refer to the Rational Rose ClearCase add-in online help and the Rational ClearCase Tool Mentor Setting Up the Implementation Model Using Rational ClearCase.

3. Check in and check out Rational Rose files

To check out and check in files to Rational ClearCase version control from Rational Rose, you can use Rose shortcut menus, or choose one of the following commands from the ClearCase submenu on the Rose Tools menu:

Check In
Check Out
Undo Checkout
Get Latest

Depending on the version of Rational ClearCase you are running, these commands display Rational Rose dialogs that interface with ClearCase, or they display the actual ClearCase dialogs.

For More Information

For details about Rational Rose file check out and check in to Rational ClearCase version control, refer to the Rose ClearCase add-in online help and the Rational ClearCase Tool Mentors Checking Out and Checking In Configuration Items and Using UCM Change Sets.

4. View Rational ClearCase information about Rational Rose files

The Rational Rose ClearCase add-in provides two sets of commands that allow you to obtain ClearCase information about Rose files.

The List commands query Rational ClearCase and then display the information you request in text format. List commands include: Object, History, Checkouts, Version Tree, and All of the Above.
The Browse commands directly access Rational ClearCase dialogs, allowing you to view file information using ClearCase's graphical browsers. Browse commands include Properties, History, Version Tree, and Directory.

For More Information

For details about how to view Rational ClearCase information within Rational Rose, refer to the Rose ClearCase add-in online help. For detailed explanations of ClearCase file information, refer to the Rational ClearCase online help.

5. Deliver Rational Rose files to the integration stream

To deliver Rational Rose files from your development stream to an integration stream, use the Deliver Stream command from the Rational ClearCase submenu of the Rose Tools menu. This command is only available if you are running ClearCase 4.0 or higher.

For More Information

For details about delivering a development stream to an integration stream in Rational ClearCase, refer to the Rational ClearCase Tool Mentor Delivering Your Work.

6. Update a work area from the integration stream

To update the Rational Rose files in your development stream from a more recent baseline in the integration stream, use the Rebase Stream command from the Rational ClearCase submenu of the Rose Tools menu. This command is only available if you are running ClearCase 4.0 or higher.

For More Information

For details about rebasing a development stream using Rational ClearCase, refer to the Rational ClearCase Tool Mentor Updating Your Work Area.

Rational Unified Process 2003.06.13