JAVA Developer Console: ClearCase UCM Project Creation

In my previous post I have explained about UCM project and different terminologies used in ClearCase. In this post I will show how to create a UCM project in IBM Clear Case. Creation of a UCM Project is done through the ClearCase Project Explorer. The Project Explorer can be started through the Start menu in Windows or through the ClearCase Explorer on the UCM page of the Toolbox tab.

Once the Project Explorer is started, right click on PVOB where the project is to be created and select New Project…This will start the New Project Wizard. (If the PVOB is not visible in the Project Explorer, select View -> Show all Project VOBs.).

In the New Project Wizard, enter the UCM Project name. It should be descriptive but should also be concise, since the play a role in the path to the elements in ClearCase. The Integration Stream Name will automatically be populated with UCM Project name and appended with “_Integration”. It is recommended to shorten this to “_Int” to keep the path name to the elements as short as possible. A short description should be entered that gives information about the purpose of the UCM Project.

Determine if this is to be a single stream (only an integration stream) project or a multistream project (Traditional). Select the option which corresponds to the development environment you are trying to create. Click Next.

At this point, it must be decided if the UCM Project is to be based on an existing project or created as a new entity. Select No to create a new UCM Project that is not based on an existing UCM Project, Click Next.

If the new UCM Project is to be based on the recommended baselines of an existing project, select Yes and highlight the integration stream of the UCM Project the new project will use as a base. If the PVOB that is needed does not appear in the window, select “Show all UCM Project VOBs”. Click Next.

In this Wizard, the components that will be included in the UCM Project will need to be selected.

Based on previous UCM Project:

If the new UCM Project was based on an existing UCM Project, the components and their baselines will be displayed in the window. Check these to make sure they are what are expected. Components can be added deleted if necessary by highlighting the component and selecting the Remove button. If the displayed component has the incorrect baseline, highlight the component and select Change. This will bring up a dialog similar to adding a component (see below). To add additional components, follow the steps for adding a component (below). If all components are correct, click Next.

New UCM Project:

If the UCM Project is not based on an existing UCM Project, components must be added to the project. To add a component to the UCM Project, select Add… This will bring up the Add Baseline window.

From the drop down menu, select the component to be added to the UCM Project. Once the component is selected, select Change >> All Streams from “From Stream:” This will display all the available baselines for the component that was selected.

Highlight the baseline that is to be used as the basis for the UCM Project and then select OK. This will add the component to the UCM Project.

Repeat the above steps until all the components have been added to the UCM Project. Then click Next. This will display following wizard.

At this point, the components that are to be modifiable in the UCM Project must be selected. If a component is checked, the component is modifiable. If not checked, the component will be read-only in the UCM Project.

Based on previous UCM Project:

If the UCM Project is based on a previous project, the components will be configured according to the old UCM Project. Modify this as necessary for the new UCM Project.

New UCM Project:

By default, all components are set to read-only. Check the components that will be modifiable in the UCM Project.

Once the components have been configured, select the Policies button. This will bring up the Project Policies window.