Ability to invoke ClearCase source control command move within Rose RealTime

Resolving The Problem

Selecting the element under Rational® ClearCase® control and performing a ClearCase "move" will move the file corresponding to the controlled unit from the original source control location to the new source control location. Move will occur by using the "cleartool mv" command. This will cause an implicit check-out of the relevant directory or directories. The files and folders being checked-out will be listed in the dialog box. Once the actions are complete, the user will need to check-in the elements, which can be completed through the Rational Rose® RealTime / ClearCase integration.

How to use ClearCase move from Rose RealTime:

• Go to Tools > Options
• Check the check-box "Enable clearcase move"

*Note: By default Tools > Option "Enable clearcase move" will be unchecked. In this case the right mouse click maintains original behavior (allowing you to move elements without using ClearCase move).

By default the right mouse click drag and drop exhibits the same behavior as the left click drag and drop. The "Enable clearcase move" setting will be persistent through the Rose RealTime sessions.

• Right-click* on the ClearCase element to be moved and drag to the source control location where it is to be moved. In the illustration below – the user has right-clicked on NewClass1 and will drag it to NewPackage2
  
  

Once the drag and drop action is completed – the warning dialog will be displayed as illustrated below.
After selecting Yes, the Source will be physically moved (using the ClearCase mv command) to the NewPackage2 source control destination. In this case, NewClass.rtclass physically will move to the NewPackage2 source code location.



Refer to the table below for the detailed set of use cases and behaviors involving the ClearCase Move feature.

Limitations: As illustrated in the table below – the ClearCase Move will only be allowed when right clicking and dragging and dropping element from Clear Case source control to another ClearCase source control location.

Attempting to perform right-click drag and drop from ClearCase source control to a location not under ClearCase source control will not be allowed and user will see the following warning message:

Source \ Destination	Under Source Control	Not Under Source Control	Scratch Pad
Under Source Control	Right-click drag and drop CLEARCASE MOVE. File location changes on disk.	Right-click drag and drop Not allowed.	Right-click drag and drop Not allowed.
Not Under Source Control	Right-click drag and drop Model Move. No change in file location.	Right-click drag and drop Model Move. No change in file location.	Right-click drag and drop Not allowed.