Using source code control

There are plug-ins available for the workbench tools that allow you to work with integration components under source code control. By implementing source code control, all the developers on a project can add an integration component library (or user project) to their workspace and work on the components in the library without risk of other developers making changes to the components.

Note:
Although source code control can prevent developers from making changes to the same component definition, it cannot prevent developers from deploying components to the server. To prevent multiple developers from overwriting components in the server, have one person in charge of deployment and change the InterChange Server password.

Using Rational ClearCase

This section provides instructions on how to enable the ClearCase plug-ins and enable System Manager for ClearCase connectivity. It also provides some information on how ClearCase might be used, though you should consult the documentation for ClearCase and for the ClearCase plug-in for detailed information. Furthermore, this section does not cover prerequisite steps such as installing the ClearCase client, creating a view, and so forth.

Confirming the plug-ins are installed and enabled

Do the following to confirm that the required plug-ins are installed and enabled in your workbench:

  1. Navigate to the \plugins directory of your Eclipse-based tooling framework (such as WSWB or WSADIE).
  2. Look for a directory named com.ibm.btools.csm.ui.cc and explore it if it exists.
  3. Look for a file named plugin.xml. If a file by that name does not exist, but one named plugin.xml.off does exist, then rename plugin.xml.off to plugin.xml.
  4. Repeat steps 2 through 3 for the following plug-ins as well:

If any of these required directories is missing, or if they do not contain a file named plugin.xml, then you will not be able to use System Manager with ClearCase.

Configuring System Manager for ClearCase connectivity

Once you are sure the plug-ins are enabled in the file system, you must do the following to configure System Manager for ClearCase connectivity:

  1. Start your workbench.
  2. Select Perspective > Close All from the menu bar.
  3. Open the System Manager perspective.
  4. Select Perspective > Customize from the menu bar.
  5. Expand the Other node.
  6. Enable the ClearCase check box.
  7. Click OK.

    The ClearCase menu is added to the menu bar.

  8. Click the black down-turned arrow in the title bar of the WebSphere Business Integration System Manager view and choose Show ClearCase decorations from the context menu.

    Resources in the workbench will now have a context menu named ClearCase that you can use to perform source code control operations on them, and will display icons to indicate if they are checked out and so forth.

Connect to ClearCase

To connect System Manager to ClearCase, select ClearCase > Connect to Rational ClearCase from the menu bar.

Moving a project into ClearCase

For developers to access the same components, an integration component library must initially be created on one system and then moved into ClearCase. Do the following to move a library into ClearCase:

  1. Right-click an integration component library and choose ClearCase > Move Project Into ClearCase from the context menu.
  2. Navigate to the directory in your view where you want the integration component library moved to and click OK.

    The "Progress Information" dialog appears as the project is moved into source code control.

  3. At the "Add Element(s) to Source Control" window, select the integration components you want to add with the library and click OK.

Adding a project to the workspace

Once the integration component library that will be shared by the developers has been moved into ClearCase by one developer, the other developers can do the following to add the project to their own workspace:

  1. Select ClearCase > Connect to Rational ClearCase from the menu bar to connect to ClearCase.
  2. Select ClearCase > Add Project to Workspace from the menu bar.
  3. At the "ClearCase Project Location" dialog, navigate to and select the directory of the integration component library that was moved under source code control.
  4. Click OK.
  5. At the "Add Elements(s) to Source Control" dialog, click OK.

    The project folder is added to your workspace and you can check components in and out by right-clicking them and using the ClearCase context menu.

    Note:
    You might have to restart the workbench for the project folder to appear.

Using VCM

System Manager can also be used with VCM. For information on how to do so, see the documentation for VCM itself, and for the VCM plug-ins. To enable VCM connectivity, follow the steps described in Confirming the plug-ins are installed and enabled, but with the following plug-in directories instead:

Copyright IBM Corp. 1997, 2004