Integrating with Rational Team Concert

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

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 not already been done.
   3. Assign this new user a Developer for IBM Enterprise Platforms Client Access License.
   4. 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. Start Rational Programming Patterns.
   2. Open the Work Items perspective.
   3. In the Team Artifacts view, create a repository connection at:

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

      with the administrator user already created.

   4. Create a project area.
      Note: Explanations about project areas can be found in the Rational solution for Collaborative Lifecycle Management documentation.
3. Verify the access permissions:

   As an administrator, you must verify that the user who is to create the language definitions for the Rational Programming Patterns artifacts has the appropriate access permissions.

   1. From the Work Items perspective of the Eclipse workspace, open the project area by right-clicking it and selecting Open.
   2. On the Overview tab of the project area, verify the role that is assigned to the user who is to create the language definitions.
   3. Open the Process Configuration tab. Expand Project Configuration in the Configuration tree and select Permissions. In the list of Roles, select the role of the user who is to create the language definitions. In the Permitted actions tree, verify that the lines Language Definitions and Source Code Data are selected.
      Figure 1. The Process Configuration tab

      
   4. Save.
4. Create the language definitions and select the associated scanners:
   You can now create four language definitions:

   • RPP Design
   • RPP Design Path
   • RPP Generated
   • RPP Macro
   1. Expand the project area in the Team Artifacts view. 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

      
   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,pacprogram,pacreport,pacinputaid,
           pactext,metaentity,userentity,metadataaggregate,metaentitytype

           Important: Only these file extensions are used by Rational Programming Patterns. Wildcards cannot be used.
           Attention: Up until version V9.1, the pacmacro extension was one of the design artifact extensions. A specific language definition is now dedicated to it. You must then remove it from the language definition for the design artifacts and create a language definition for the Macros.
      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. 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,dllpdp,txtpdp

          Important: Only these file extensions are used by Rational Programming Patterns. 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. Create the language definition for the Macros.
      • Select New Language Definition again.
      • In the General tab:
        • Enter RPP Macro in the Name field.
        • Enter an optional description, such as RPP Macro Scanner, in the Description field.
        • Select COBOL in the Language field.
        • Enter the following file extension in the File Extensions field:

          pacmacro

          Important: Only this file extension is used by Rational Programming Patterns. Wildcards cannot be used.
        • In the Scanners tab, remove the default scanner and add the RPP Macro 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 view, 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 you select it. Follow the instructions of 'Creating steams' in the Rational Team Concert documentation.

   Figure 3. How to access the stream selection wizard

   
6. Modify parameters
   • Memory parameters of the client workstation:
     • eclipse.ini

       You must modify the memory parameter of the Software Delivery Platform. Its maximum value varies according to the operating system and the memory available. You must then find the maximum value for your configuration.

       To do so, edit the eclipse.ini file that is located directly under the root of your Software Delivery Platform.

       The Java™ heap size is set to 1024 by default (in -Xmx1024m). You can increase this value to adapt it to your configuration.

       Note: For an installation in 32-bit mode, the maximum value is 1.5 gigabyte.
     • scm.ini

       The migration of data from Pacbase to Rational Programming Patterns uses the scmtools to save the migrated data in Rational Team Concert

       You must modify the scm.ini file like the eclipse.ini file.

       The scm.ini file is in ...\scmtools\eclipse. The Java heap size is set to 512 by default (in -Xmx512m).

   • Memory parameter of the server:

     You can adapt the server.startup.bat file that is in the ...\server directory. In a 64-bit environment, and if the server allows it, you can modify the line set JAVA_OPTS=%JAVA_OPTS% -Xmx4G to increase the maximum memory in use to 8G.

   • Properties of the Rational Team Concert server:
     • No creation of duplicate components:
       By default, the component names are not unique in the Rational Team Concert repository. To avoid inconsistencies, an administrator is then advised to prevent users from creating components whose names are not unique.

       1. Log in as an administrator to https://[fully-qualified hostname]:9443/ccm/admin.
       2. In the Configuration entry, click Advanced properties.
       3. Scroll the properties down to the SCM category. Scroll the category down to com.ibm.team.scm.service.internal.tasks.InternalScmService.
       4. Find the property Encourage component names to be unique.
       5. Click its current value (false by default) and change it to true.
       6. Click the Save button that is at the beginning of the properties page.
     • Maximum number of files in source code data resource:
       With this modification, you avoid a too large memory consumption.

       1. Log in as an administrator to https://[fully-qualified hostname]:9443/ccm/admin.
       2. In the Configuration entry, click Advanced properties.
       3. Scroll the properties down to the Source code data collection category. This category contains the line com.ibm.team.enterprise.internal.metadata.collection.service.Metadata
          CollectionService.
       4. Change the value of the property Max. number of files in source code data resource. Click its current value and enter 100 instead.
   • DB2® parameter:
     To run Rational Team Concert with a DB2 database, you can see the jazz.net site for information about the DB2 tuning. To import large DB2 databases, you must increase the following values:

     db2 UPDATE DB CFG FOR CCM using LOGPRIMARY 100
     db2 UPDATE DB CFG FOR CCM using LOGSECOND 100

     where 100 is the increased value. To see the values, use the following command: :

     db2 GET DB CFG FOR sample |grep '(LOG[FPS]'

     You obtain the following values:

      Size of journal files (4 Kb)      (LOGFILSIZ) = 1000
      Number of primary journal files   (LOGPRIMARY) = 3
      Number of secondary journal files (LOGSECOND)  = 2