Rational Programming Patterns for System z

Integrating with Rational Team Concert

Rational® Programming Patterns for System z® is now installed on top of IBM® Rational Team Concert™. You must configure Rational Team Concert in order to integrate Rational Programming Patterns for System z with it.

About this task

The purpose of this integration is to prepare the building of indexes in the Rational Programming Patterns for System z server. You must:

Procedure

  1. Create a user and assign permissions to this user:
    1. Start the Jazz™ Team Server and open its setup wizard

      (https://[fully-qualified hostname]:9443/jts/setup)

      Follow all the steps explained in the Rational Team Concert documentation: Running the setup wizard

    2. Create a user, if it has already been done.
    3. Assign this new user a Developer for IBM Enterprise Platforms Client Access License.
    4. Stop the Jazz Team Server and start it again.
    5. Verify that the created user has all the repository permissions and the Developer for IBM Enterprise Platforms Client Access License.
  2. Create a project area:
    1. Log on to the server, at:

      https://[fully-qualified hostname]:9443/ccm

      as this user.

    2. Create a project area.
      Note: Explanations about project areas can be found in the Rational Team Concert information center.
  3. Verify the access permissions:

    To create the language definitions for the Rational Programming Patterns for System z artifacts, you must have the appropriate access permissions.

    1. Open the project area by right-clicking it in the Team Artifacts tab, and selecting Open.
    2. Open the Process Configuration tab of the project area. Expand Project Configuration in the Configurations tree and select Permissions. In the Permitted actions tree, select Language Definitions and Source Code Data.
      Figure 1. The Process Configuration tab
      Permissions for language definition
    3. Save.
  4. Create the language definitions and select the associated scanners:
    You can now create three language definitions:
    • RPP Design,
    • RPP Design Path,
    • RPP Generated.
    1. Expand the project area in the Team Artifacts tab. Then expand Enterprise Extensions > System Definitions > z/OS. Right-click Language Definitions and select New Language Definition. The Language Definition editor opens up. It contains a General tab and a Scanners tab.
      Figure 2. The Language Definition editor
      New language definition
    2. Create the language definition for the design artifacts.
      1. In the General tab:
        • Enter RPP Design in the Name field.
        • Enter an optional description, such as RPP Design File Scanner, in the Description field.
        • Select COBOL in the Language field.
        • Enter the following file extensions in the File Extensions field:
          dataaggregate,dataelement,dataunit,pacblockbase,pacdialog,pacscreen,
          pacdialogserver,pacserver, paclibrary,pacmacro,pacprogram,pacreport,
          pactext,metaentity,userentity,metadataaggregate,metaentitytype
          Important: Only these file extensions are used by Rational Programming Patterns for System z. Wildcards cannot be used.
      2. In the Scanners tab, remove the default scanner and add the RPP Design Scanner for this language definition.
      3. Save.
    3. Create the language definition for the design path artifacts.
      1. Select New Language Definition again.
      2. In the General tab:
        • Enter RPP Design Path in the Name field.
        • Enter an optional description, such as RPP DesignPath File Scanner, in the Description field.
        • Select COBOL in the Language field.
        • Enter the following file extension in the File Extensions field:

          designpath

          Important: Only this file extension is used by Rational Programming Patterns for System z. Wildcards cannot be used.
      3. In the Scanners tab, remove the default scanner and add the RPP DesignPath Scanner for this language definition.
      4. Save.
    4. Create the language definition for the generated artifacts.
      • Select New Language Definition again.
      • In the General tab:
        • Enter RPP Generated in the Name field.
        • Enter an optional description, such as RPP Generated File Scanner, in the Description field.
        • Select COBOL in the Language field.
        • Enter the following file extensions in the File Extensions field: cblpdp,bmspdp,mappdp,mfspdp
          Important: Only these file extensions are used by Rational Programming Patterns for System z. Wildcards cannot be used.
        • In the Scanners tab, remove the default scanner and add the RPP Generated File Scanner for this language definition.
        • Save.
  5. Associate data streams with the language definitions:

    Specify which streams are to be scanned. In the Team Artifacts tab, under Enterprise Extensions, right-click Source Code Data. Then click Select streams for scanning. Specify the stream.

    If you cannot see any steam, you must create one before selecting it. Follow the instructions of 'Creating steams' in the Rational Team Concert documentation.

    Figure 3. How to access the stream selection wizard
    Select streams for scanning

Results

The configuration steps are now finished.

When you deliver a project which contains Rational Programming for System z artifacts, the artifacts will be indexed, after the indexing process has been manually or automatically activated. You will then be able to perform searches on the server repository.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)