Rational Developer 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.

Before you begin

You must 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 information center: Running the setup wizard (http://publib.boulder.ibm.com/infocenter/clmhelp/v3r0/index.jsp?topic=/com.ibm.jazz.install.doc/topics/t_s_server_installation_setup_wizard.html).
Important: The setup wizard invites you to create a user. You must assign this new user a Developer for IBM Enterprise Platforms Client Access License.

Procedure

  1. Stop the Jazz Team Server and start it again.
  2. Verify that the user you created with the setup wizard (https://[fully-qualified hostname]:9443/jts/setup) has all the repository permissions and the Developer for IBM Enterprise Platforms Client Access Licence.
  3. Log in to the server at https://[fully-qualified hostname]:9443/ccm, as this user.
  4. Create a project area.
  5. Create three language definitions for the RPPz artifacts.
  6. Check first that you have the appropriate permissions to do so. Open the project area by right-clicking it in the Team Artifacts tab, and selecting Open.
  7. 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
  8. You must now create three language definitions:
    • RPP Design,
    • RPP Design Path,
    • RPP Generated.
    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
    1. 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
          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.
    2. 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.
    3. 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.
  9. Specify which streams are concerned by the scanning process. In the Team Artifacts tab, under Enterprise Extensions, right-click Source Code Data. then click Select streams for scanning. Specify the stream.
    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 with Rational Programming for System z artifacts, those will be indexed, after the indexing process has been manually or automatically activated. You will then be able to execute searches on the server repository.


Terms of use | Feedback

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