How exports are mapped to VOBs and UCM components

Using the ClearCase Synchronizer, IBM® Engineering Workflow Management (EWM) components are automatically mapped to VOBs and UCM components on export.
When you export a file or folder from EWM, it is added to a VOB or UCM component whose name matches the name of the EWM component where it originated.
Important: The VOB to which the exported files and folders are to be added cannot be created by the synchronization process. It must exist before synchronization begins.

Exporting to UCM

When files in a EWM component are selected to be in a synchronized stream defined by a UCM stream, the following rules govern how EWM components are mapped to UCM components:
  • If there is a UCM component that has the same name as the EWM component, it becomes the target of the export.
  • If the UCM component that is described in Step 1 does not exist, then the synchronization process attempts to create one in a PVOB whose tag matches the value of the PVOB_TAG property in the ClearCase Provider Properties of the synchronized stream. The root directory of the component is created in a VOB whose tag matches the value of the COMPONENT_VOB_TAG property in the ClearCase Provider Properties of the synchronized stream.
  • If the PVOB_TAG or COMPONENT_VOB_TAG properties are not set, or if the PVOB or VOB does exist, the export is blocked until the problem is resolved.
Note: If the name of the EWM component contains characters that cannot be used in Rational® ClearCase® component name, the export fails. Rename the component in the EWM to follow the rules for Rational ClearCase component names, and then request another synchronization. After first successful synchronization, the EWM component can be renamed back to its original name.

Exporting to base Rational ClearCase

When files in a EWM component are selected to be in a synchronized stream defined by a Rational ClearCase branch type and label type, the following rules govern how exported components are mapped to VOB folders:
  • If the COMPONENT_VOB_TAG property in the ClearCase Provider Properties of the synchronized stream is set, the synchronization process looks for a sub-VOB component with the name that matches the EWM component. That sub-VOB component must be under a VOB with a tag that matches the COMPONENT_VOB_TAG property of the synchronized stream. Then, the synchronization process can export the EWM component.
    For example, if the EWM component name is componentA and the COMPONENT_VOB_TAG property is set to \vobA, the synchronization process looks for the sub-VOB component, \vobA\componentA, in the Rational ClearCase view. If matching sub-VOB component does not exist, it creates a subfolder as a sub-VOB component. The new subfolder has the same name as EWM component.
    Note: If the VOB does not have sub-VOB component attribute type, it fails to create a subfolder as a sub-VOB component. Refer to Preparing a sub-VOB component for base Rational ClearCase synchronization for more information on setting the sub-VOB component attribute type and exporting it again.
  • If the COMPONENT_VOB_TAG property in the ClearCase Provider Properties of the synchronized stream is empty, and the COMPONENT_VOB_TAG_PREFIX property is set, the synchronization process looks for the VOB with a tag that matches the specified prefix and the name of the EWM component. Then, the VOB becomes the target of the export.

    For example, if the EWM component name is componentB, and the COMPONENT_VOB_TAG_PREFIX property is set to /vob, the synchronization process looks for the VOB with the tag of /vob/componentB in the Rational ClearCase view.

  • If both the COMPONENT_VOB_TAG property and the COMPONENT_VOB_TAG_PREFIX in the ClearCase Provider Properties of the synchronized stream is empty, the VOB with a tag that matches the name of the EWM component becomes the target of the export.
  • If no such VOB is mounted, the export fails. Either of the following actions can correct the problem:
    • Rename the EWM component to match the tag of a mounted VOB.
    • Create a VOB that has the appropriate name (tag) and mount it.
Restriction: If you previously exported files and folders to a UCM component that has the same name as the Jazz™ source control component, then the latter component is already associated with that UCM component. You cannot export to a VOB with the same name.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki