Rational® Programming
Patterns is now installed on top of IBM® Rational Team Concert™.
You must configure Rational
Team Concert in order to integrate Rational Programming Patterns with it.
About this task
The purpose of this integration is to prepare the building
of indexes in the Rational Programming
Patterns server. You must:
- Ensure that the user has the permissions required for the configuration,
- Create a project area (if it has not already been done),
- Create three language definitions and associate indexing scanners
to them,
- Select the data streams which will be scanned.
Procedure
- Create a user and assign permissions to this user:
- 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
- Create a user, if it has already been done.
- Assign this new user a Developer for IBM
Enterprise Platforms Client Access License.
- Stop the Jazz Team
Server and start it again.
- Verify that the created user has all the repository
permissions and the Developer for IBM Enterprise Platforms Client
Access License.
- Create a project area:
- Log on to the server, at:
https://[fully-qualified
hostname]:9443/ccm
as this user.
- Create a project area.
- Verify the access permissions:
To create
the language definitions for the Rational Programming
Patterns artifacts, you must have the appropriate access permissions.
- Open the project area by right-clicking it in the Team
Artifacts tab, and selecting Open.
- 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
- Save.
- Create the language definitions and select the associated
scanners:
You can now create three language definitions:
- RPP Design,
- RPP Design Path,
- RPP Generated.
- Expand the project area in the Team Artifacts tab.
Then expand . 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
- Create the language definition for the design artifacts.
- 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. Wildcards
cannot be used.
- In the Scanners tab, remove the default scanner
and add the RPP Design Scanner for this language
definition.
- Save.
- Create the language definition for the design path artifacts.
- Select New Language Definition again.
- In the General tab:
- In the Scanners tab, remove the default scanner
and add the RPP DesignPath Scanner for this
language definition.
- Save.
- Create the language definition for the generated artifacts.
- Select New Language Definition again.
- In the General tab:
- 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
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.