![]() |
![]() |
![]() |
![]() |
![]() |
Using ClearCase Together with an SDL System
This section describes one way of using the SDL Suite and ClearCase in an integrated way. For more information about SDL Suite/ClearCase Integration, see Readme files in <inst dir>\examples\cm\win32\clearcase\ or <inst dir>/examples/cm/unix/clearcase/.
For a more general description of using a configuration or version control system, please see How to Manage the Diagrams in a Project.
Introducing ClearCase with the SDL Suite - Checking in Files
When handling of files by ClearCase is to be applied on a system being developed by the SDL Suite, the following approach can be used.
- Make sure that all files (related to the system) are configured in one directory hierarchy outside ClearCase. See the work area part in Example 50.
- Install the ClearCase menu into the Organizer. Please add clearcase.ini to your org-menus.ini file. The SDL Suite will search for the org-menus.ini first in the directory where the SDL Suite was started, then in a directory pointed to by the HOME environment variable and finally in the directory in which the SDL Suite was installed.If you do not already have a org-menus.ini file, the clearcase.ini can serve as one. Just copy clearcase.ini to either your HOME directory or to where you have the SDL Suite installed and rename it to org-menus.ini. For more information on dynamic menus, please see Defining Menus in the SDL Suite. (The ClearCase menu that comes with the distribution of the SDL Suite is an example and could be tailored by the user.)
- Set an appropriate ClearCase view. Copy the system file to the top level directory of the ClearCase file system. You may have to edit it in order to remove the line defining SourceDirectory.
- Open the system file to bring up the structural view of the system (the diagrams are marked as invalid in the Organizer - this is OK for now).
- The MkDir for Object menu command can be used to create the directory structure in a ClearCase VOB. Select an object in the Organizer and execute the MkDir for Object menu command to create the directory for the selected object in the ClearCase VOB.
- Now you can populate the ClearCase directory structure with the diagram files, by copying the files from the directory in step 1. above.
- Re-open the system file in the Organizer. All diagrams should now be connected to their files.
- Select the System File icon and do the Recursive MkElem menu choice to create all the objects in the ClearCase VOB.
- Select the System File icon and the Recursive Check In will check in all objects into the ClearCase VOB.
- The directories must be checked in separately. Use the command Check In Directory to do that.
The system file for the diagram system can be checked in but it is not suitable for version control since the Organizer wants to update it in situations unrelated to revision changes. The system file should be regarded as one developer's personal view of the system being developed. On the other hand, the top level control unit file should be checked in and is suitable to be put under revision control.
Introducing ClearCase with the SDL Suite - Opening a System
The top level control unit file allows to load the system into the Organizer if a user starts from scratch. Say that there is a checked in diagram system in a ClearCase VOB. A developer that wants to start working on that diagram system has to do the following.
- Mount the ClearCase VOB containing the diagram system.
- Set the appropriate ClearCase view and start the SDL Suite in it on a new system.
- Load the ClearCase menu into the Organizer $-telelogic/sdt/examples/ClearCase/sdtcc.mnu
- Set the Source Directory to the top level directory for the diagram system.
- Connect the top level control unit file with the System File icon and run the Recursive Update ClearCase menu command. This loads the system into the Organizer.
- Save the system file. (The Organizer will warn that the top level control unit file is read only but this can be disregarded.)
http://www.ibm.com/rational |
![]() |
![]() |
![]() |
![]() |