Exporting files and folders to Rational ClearCase

You can export files and folders from Rational Team Concert™ source control to Rational® ClearCase®. Exported files and folders are checked in to an existing VOB.

About this task

To export a files and folders from Rational Team Concert source control to Rational ClearCase, you add them to a component in a synchronized stream and then use the Select Files To Synchronize window to specify files and folders to export. Exports, like imports, are handled by the synchronization process. The initial synchronization adds the files and folders to Rational ClearCase source control. Subsequent synchronizations treat them like any other artifact in a synchronized stream. Changes made in Rational ClearCase are applied to the ClearCase Synchronized Stream, and changes made in the synchronized stream are applied to Rational ClearCase.
Attention: During the export, Rational Team Concert source control components are automatically mapped to VOBs and UCM components. If this mapping fails because no suitable VOB is mounted on the synchronization host, a synchronization error occurs. For more information, see How exports are mapped to VOBs and UCM components.
Rational ClearCase places more restrictions on component names than Rational Team Concert source control. The name of any Rational Team Concert source control component that contains files that you want to export to Rational ClearCase must conform to these rules:
  • It must contain only letters, digits, and the special characters underscore (_), period (.), and hyphen (-)
  • A hyphen cannot be used as the first character of a name.
  • It must not be an integer; this restriction includes octal and hexadecimal integer values. However, noninteger names are allowed.
  • It must not be one of the special names ".", ",", "..", or "...".
If you want to select files or folders to synchronize from a Rational Team Concert source control component whose name does not conform to these rules, change the name of the component first. After the files and folders have been successfully synchronized, the component can be renamed (and restored to its original name if you want), without disrupting synchronization of files in it.

To export files or folders:

Procedure

  1. You must be logged on to the synchronization host where the stream was created.
  2. Add the component that contains the files or folders to the synchronized stream. For more information, see Adding and removing components and Delivering change sets. Until a component is in the synchronized stream, files and folders in it cannot be synchronized with Rational ClearCase.
  3. Open the ClearCase Synchronized Streams view and select the stream to which you delivered the project in Step 2.
  4. Click the Select Files to Synchronize icon Select Files to Synchronize icon.
  5. On the Select Files To Synchronize page, click Select files and folders in Jazz.
    • To browse for files and folders in the synchronized stream, click Browse. If no files and folders are visible in the window, verify that the component that contains them has been added to the synchronized stream (see Step 2).When you have finished selecting files and folders, click OK to close the browser and display the selected paths in the list of Files and folders to synchronize.
    • To select files and folders manually, enter the path name of a component root folder that exists in the synchronized stream and then click Add. Path names have the form:

      component_name/project_root_dir

      so the path name of a folder named org.example.tests.junit in a Rational Team Concert source control component named Tests would be:

      Tests/org.example.tests.junit

    If you want, you can use the Remove and Edit buttons to modify selected path names after they have been added.
  6. When you are finished selecting files and folders, click Finish to request synchronization.

Results

Files and folders in the selected components are exported to Rational ClearCase as UCM components or VOB folders. In the example in Step 5, a folder named org.example.tests.junit is added to the UCM component named Tests, or else created as a subfolder of the VOB whose VOB tag is Tests, depending on how the synchronized stream is defined.


Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug