Description

The Rational Team Concert SCM source configuration extracts files from the Rational Team Concert SCM into an HCL Launch component version. The source files can be pulled from a snapshot or live stream.

Quick Info

Product
HCL Launch
Type
plugin
Compatibility
HCL Launch version 7.0 or later
Created by
HCL Software
Version Name Action

7.1044519

launch-air-rtc-scm-7.1044519.zip

8.1101694

launch-air-rtc-scm-8.1101694.zip

launch-air-rtc-scm-7.1044519.zip

7.1044519


launch-air-rtc-scm-8.1101694.zip

8.1101694


Summary

The IBM Rational Team Concert SCM source plugin supports creating components from the Rational Team Concert source-code management system.

Compatibility

This plugin requires HCL Launch version 7.0 or later.

This plugin runs with Rational Team Concert version 4.0.3 or later.

This plugin supports all operating systems that are supported by the HCL Launch agent.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
8 Minor enhancements
7 APAR PI87707. Added tracking of user who requested a manual version import.

Usage

To use the RTC SCM plugin, create a component to define the RTC artifacts to be used. The component contains the information for importing the artifacts and any processes to perform on the artifacts.

For additional information about using the Rational Team Concert scm tool, see the Getting Started with the Jazz SCM command line interface topic.

Create a component

To create a component, complete the following steps. For more information, see Creating components
topic in the product documentation.

  1. In the HCL user interface, click Components and then click Create Component.
  2. In the Create Component window, specify a name and description for the component.
  3. In the Teams fields, specify the access information for the new component.
  4. To use a template for the new component, select a template from the Template list. In this case, the component inherits source configuration, properties, and processes from the template.
  5. In the Source Config Type list, select RTC SCM.

  6. Specify the properties for the component. See the Setting tab for descriptions.
  7. Click Save.

Import a version

When the artifacts are imported, a component version is created using the version of the package. You can specify to import a specific package version or import all versions. If importing all versions, a component version is created for each version.

  1. Click the Versions tab for the component.
  2. Click Import New Versions.
  3. Specify a specific version of the package to import, or leave blank to import the latest version of the package available in the repository. Additionally, enable Import All Versions to import all versions of a package.
  4. Click Save.

Step palette

To access this plugin in the palette, click SCM > RTC.

Steps

The following process steps are available in the RTC SCM plugin.

Import Version

Creates a new component version and imports artifacts

This step has no input properties.

Roles

The RTC SCM plugin adds the following roles automatically to resources. You cannot add these roles manually.

RTCSCMImportProperties

Properties for the RTCSCMImportProperties role
Name Type Description Reference
Version Name String The name given to the imported component version. If snapshot is selected, the RT server is searched this snapshot name. If left blank, the latest snapshot name or ID is used.
Workspace History Enumeration Use a snapshot or stream as the initial workspace history. Values are SNAPSHOT and STREAM.

RTCSCMProperties

Properties for the RTCSCMProperties role
Name Type Description Reference
Command Path String The full path to the scm executable on the HCL Launch agent, including the file name. For example: \RTCClient\scmtools\eclipse\scm.exe. ${p:component/RTCSCMProperties/commandPath}
Excludes String New line separated list of ant style exclude patterns. ${p:component/RTCSCMProperties/excludes}
Include Root Boolean Select Include Root to load the component names in the Rational Team Concert stream as top-level folders in the HCL Launch component.
Includes String New line separated list of ant style include patterns. ${p:component/RTCSCMProperties/includes}
RTC Password Password The password used to connect to the RTC server. ${p:component/RTCSCMProperties/password}
RTC Server URL String The URL of the RTC server. ${p:component/RTCSCMProperties/serverUrl}
RTC Username String The username used to connect to the RTC server. ${p:component/RTCSCMProperties/username}
Stream String The name or alias of the default flow target stream. ${p:component/RTCSCMProperties/stream}
Version Naming Convention Enumeration Indicates whether to use the version ID or name when Importing Versions Automatically, Importing Stream, or when Import Version name is left blank. Valid values are ID and NAME. ${p:component/RTCSCMProperties/autoGenerateName}