Performing Rational Team Concert actions from within Rational Rhapsody

For model elements that are saved as separate units, you can perform a number of Rational® Team Concert® actions directly from the pop-up menu for the item in the model browser.

Installing the plug-in for direct integration

  1. Open Rational Team Concert and select Help > Install New Software.
  2. On the Available Software page, click Add.
  3. On the Add Repository page, click Local to display the directories on your computer.
  4. In the folder where Rational Rhapsody® is installed, there is a folder that is called RTCIntegration. This folder contains a folder that is named RTCEclipseClient32bitPlugins and a folder named RTCEclipseClient64bitPlugins. Select the folder that corresponds to the version of Rational Team Concert that you installed - 32-bit or 64-bit.
  5. Click OK.
  6. On the Available Software page, expand IBM Rational Rhapsody Tools.
  7. Select the IBM Rational Rhapsody integration for Rational Team Concert plug-in, and click Next.
  8. On the Install Details page, select Next.
  9. On the Review License page, accept the terms of the license agreement and click Finish.
  10. When the installation has finished, restart Rational Team Concert.

Setting the Rational Team Concert integration properties

  1. Set the property ConfigurationManagement::General::CMTool to RationalTeamConcert.
  2. Verify that the property ConfigurationManagement::RationalTeamConcert::ShowCMStatus is set to True.

Troubleshooting the integration with Rational Team Concert

If Rational Rhapsody does not seem to be communicating with the integration plugin for Rational Team Concert, try the following steps.

  1. Check for relevant messages in the Error Log view in Rational Team Concert.
  2. If you upgraded to a newer release of Rational Rhapsody, make sure that you installed the plugins that are included with the new release.
  3. Verify that you have installed the correct version of the plugins - 32-bit or 64-bit. Keep in mind that the plugin must match the Rational Team Concert client in terms of 32-bit or 64-bit. The version of Rational Rhapsody that you are running (32-bit or 64-bit) is not relevant.
  4. Relaunch Rational Team Concert using the -clean option. This should resolve any cache-related issues.

Rational Team Concert actions available in the pop-up menu

Once you have installed the plug-in and set the necessary properties, the following options are displayed in the pop-up menu for elements in the browser that have been saved as separate units and for controlled files. These options can be found in the Rational Team Concert submenu.

  • Save
  • Save and Check-in
  • Check-in
  • Deliver
  • Check-in and Deliver
  • Associate Change Request (available only in projects that are enabled for Rhapsody Model Manager)
  • Lock
  • Unlock
  • Locate in Pending Changes
  • Locate in Repository Files
  • Show History
Note: When using the integration with Rational Team Concert:
  • If you select the Lock option from the pop-up menu for a unit, the status of the underlying file will be changed to read/write.
  • If you use the Unit Information window in Rational Rhapsody to change a read-only unit to read/write, the file for the unit will be locked in Rational Team Concert.
  • If you select the Unlock option from the pop-up menu for a unit, the status of the underlying file will be changed to read-only.
  • If you use the Unit Information window in Rational Rhapsody to change a unit to read-only, the file for the unit will be unlocked in Rational Team Concert.

The linkage between the Lock/Unlock status and the file system status is controlled by the property ConfigurationManagement::RationalTeamConcert::UnitLockIfReadWrite. The default value of this property is True. If you change the value of this property to False, selecting Lock or Unlock does not affect the status of the file in the file system. Similarly, changing the status of the file to read/write or read-only does not affect the Lock/Unlock status in Rational Team Concert.

Rational Team Concert status icons

If you set the value of the property ShowCMStatus to True, then elements that have been saved as separate units (and controlled files) will have their statuses reflected in the model browser, based on combinations of icons that represent the following statuses:

  • Icon for locked by meLocked by me
  • Icon for locked by someone elseLocked by someone else
  • Icon for outgoingOutgoing
  • Icon for incoming changes availableIncoming changes available
  • Icon for conflicts with incoming changesConflicts with incoming
  • Icon for requires merge with incomingRequires merge with incoming
  • Icon for in-syncIn-sync
  • Icon for unresolvedUnresolved
  • Icon for status could not be retrievedStatus could not be retrieved
Note: If you use the Undo option that is provided by Rational Team Concert in order to undo changes you have made to a Rational Rhapsody unit, you will not receive a notification in Rational Rhapsody that the file on disk no longer matches the element. To make sure that the information that is displayed is consistent with the saved file after using the Undo option in Rational Team Concert, unload the unit in Rational Rhapsody and reload it.

Automatic check-in and delivery of changes to model

When using the direct integration with Rational Team Concert, you can choose to have your model changes automatically checked-in to Rational Team Concert when you save the model. You also have the option of having model changes automatically checked-in and delivered when the changes are saved.

The property ConfigurationManagement::RationalTeamConcert::UnitAutomaticOperationOnSave determines what Rational Team Concert actions are performed automatically when changes are saved. The property can be set to the following values:

  • None
  • CheckIn
  • CheckInAndDeliver

If UnitAutomaticOperationOnSave is set to CheckIn or CheckInAndDeliver, you can customize the check-in comment that is used by modifying the value of the property ConfigurationManagement::RationalTeamConcert::UnitAutomaticChangeSetComment.

Associating change sets with work items when using automatic check-in

If you configured Rational Rhapsody to automatically check-in changes to Rational Team Concert when they are saved in the model (using the property UnitAutomaticOperationOnSave), you can use the property AssociateWorkItemOnCheckIn (under ConfigurationManagement::RationalTeamConcert) to have change sets associated with a work item.

Set the value of the property to CurrentWorkItem to have change sets associated with the work item that is set as "current" in Rational Team Concert.

To have change sets associated with a specific work item, set the value of the property AssociateWorkItemOnCheckIn to AssociateWorkItemURL, and use the property AssociateWorkItemURL (under ConfigurationManagement::RationalTeamConcert) to specify the URL of the work item to use. If you want to associate change sets with more than one work item, the value of the property AssociateWorkItemURL should be a comma-separated list of URLs.

Note: For projects that are enabled for Rhapsody Model Manager, you can also use the Associate Change Request... option that is included in the pop-up menu (in the Rational Team Concert submenu).

Renaming units

If you configured Rational Rhapsody to use the integration with Rational Team Concert (using the CMTool property), then when you rename a model element that is a unit, the file that represents the unit is also renamed. You can modify this behavior by changing the value of the property RenameActivation.

Increasing the amount of memory allocated to Rational Team Concert

If you are working with a very large model while using the integration with Rational Team Concert, you may encounter "out of memory" messages. To avoid such memory issues, try to increase the amount of memory that is allocated to Rational Team Concert by changing the value of the Xmx parameter in the eclipse.ini file in the root directory of your Rational Team Concert client installation.