Before you can work with the new products, you must ensure
that the installation was successful.
Procedure
- At the end of each product installation, you must ensure
that no error has occurred. This verification step is indicated in
this document for each installation.
- Verify that all the products of the client part are installed
in the same package group and that all the products of the server
part are installed in the same package group (different from the package
group of the client part).
To do so, start IBM® Installation Manager by selecting . You must see the package group
that contains Rational® Programming
Patterns client. Verify that this group also contains the packages
of the required products.
Do the same for the server part.
- Start Rational Programming
Patterns. The Pattern Driven Programming perspective
is automatically displayed.
- From the Design Explorer view, create a
location (similar to a VisualAge® Pacbase
database). Right-click and select . Name this location
and click Finish.
- Create a Library. It contains the generation parameters of each
instance.
- Right-click the location and select .
- Enter the following information in the Library creation wizard:
- Indicate a project name.
- Leave the package to blank.
- Enter the Library name on 3 characters.
- Enter the Library label.
- Click Finish.
- Create a Data Element.
- Right-click the location and select .
- Enter the following information in the Data Element creation wizard:
- Leave the default project. This project is the project where you
created the Library.
- Leave the package to blank.
- Enter the Data Element name on 6 characters maximum.
- Leave the Parent Data Element to blank.
- Enter the Data Element format (X for example).
- Click Browse in the Generation
parameters field. Select the created Library.
- Enter the Data Element label.
- Click Finish.
- Create a Program and test its generation.
- To create a Program, follow these steps:
- Right-click the location and select .
- Enter the following information in the Program creation wizard:
- Leave the default project. This project is the project where you
created the Library.
- Leave the package to blank.
- Enter the Program name on 6 characters maximum.
- Click Browse in the Generation
parameters field. Select the created Library.
- Enter the Program label.
- Verify that the option Open editor on finish is
selected.
- Click Finish.
- In the Program editor that opens automatically, specify the type
of code to generate in the following way:
- Click the Definition tab.
- In the field Type of COBOL code, select 3:
UNIX, WINDOWS.
- Save the modification with Ctrl + S.
- To test the generation of the Program, follow these steps:
Important: If an error message indicates that
Msvcr71.dll is
missing, you must install this
dll. It corresponds
to the Microsoft® C runtime library (CRT). You install it in two ways,
depending on the products that are installed in your Software Delivery
Platform:
- If Rational Developer
for System z® V9.1 or one
of its fix packs is installed, copy Msvcr71.dll from ...\SDPShared\plugins\com.ibm.etools.cobol.win32*\importer\cobol (where
* replaces all the characters of the version number). Then, paste
it to the rpp\BIN folder of your Software Delivery
Platform.
- If Rational Developer
for System z V9.5 or one
of its fix packs or Rational Developer
for AIX® and Linux is installed, install Msvcr71.dll from
the Microsoft® .NET Framework Version 1.1 Redistributable Package
site (https://www.microsoft.com/en-US/download/details.aspx?id=26).
It is automatically installed in C:\Windows\Microsoft.NET\Framework\v1.1.4322.
Then, copy it and paste it to the rpp\BIN folder
of your Software Delivery Platform.
- Create a connection to the Rational Team Concert™ server
that will store all the artifacts of your applications. These steps
are explained in Integrating with Rational Team Concert.
- Start Jazz™ Team
Server.
- Create a repository connection from the Team
Artifacts view of the Work Items perspective.
- Connect to the project area created upon the integration.
- From the project area, verify that four language definitions
were created upon the integration. Expand . Each of these new language definitions must be exclusively
associated with one of the following scanners:
- RPP Design Scanner
- RPP DesignPath Scanner
- RPP Generated File Scanner
- RPP Macro Scanner
- In the project area, create a stream on the server by right-clicking Source
Code Data and by selecting . Save.
- Create a repository workspace from this stream by selecting . You can optionally modify the default name. Then,
click Finish.
- Share the project in which you created the Library and
the Data Element.
- In the Design Explorer view of
the Pattern Driven Programming perspective,
right-click the project and select .
- Select the repository type (Jazz Source Control)
and click Next.
- Select the repository workspace and create a component
by clicking New component. Its name usually
corresponds to the Library name on 3 characters.
- Select the component.
- Start sharing the project by clicking Finish.
- Upload the new Library and Data Element to the Rational Team Concert server.
- Open the Pending changes view.
- Expand the component line and expand the line. The two
new instances must be displayed under the project indicated in their
creation wizards.
- Select the line Share projects. Right-click
and select Deliver. The changes are then uploaded
to the server.
- Verify that the upload completed successfully and that
the two instances are now on the server.
In the Team
Artifacts view of the Work Items perspective,
expand your project area. Verify that the component is in the stream
by expanding Source control. Display the repository
files by right-clicking the component and selecting . The Library and the Data Element must be displayed
in the Repository files view.
- Verify that the server indexing that is processed by the Rational Programming Patterns
scanners is active.
- In the Team Artifacts view of
the Work Items perspective, start an incremental
update of the indexes. Expand . Right-click
and select Update Source code data.
- Start a server search on the Rational Programming Patterns artifacts
to extract the two instances that were previously uploaded to the
server.