Testing the installation

Before you can work with the new products, you must ensure that the installation was successful.

1. 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.
2. 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 Start > All programs > IBM Installation Manager > View installed packages. 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.

3. Start Rational Programming Patterns. The Pattern Driven Programming perspective is automatically displayed.
   1. From the Design Explorer view, create a location (similar to a VisualAge® Pacbase database). Right-click and select New > Location. Name this location and click Finish.
   2. Create a Library. It contains the generation parameters of each instance.
      1. Right-click the location and select New > Library.
      2. 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.
      3. Click Finish.
   3. Create a Data Element.
      1. Right-click the location and select New > Data Element.
      2. 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.
      3. Click Finish.
   4. Create a Program and test its generation.
      1. To create a Program, follow these steps:
         1. Right-click the location and select New > Program.
         2. 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.
      2. In the Program editor that opens automatically, specify the type of code to generate in the following way:
         1. Click the Definition tab.
         2. In the field Type of COBOL code, select 3: UNIX, WINDOWS.
         3. Save the modification with Ctrl + S.
      3. To test the generation of the Program, follow these steps:
         • Expand the Program line that is nested under the location in the Design Explorer view.
         • Right-click the new Program. Select Generate > Program generation.

           The generation starts and a progress bar is displayed.

         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.
         • From the version 9.5 of Rational Developer for System z (IBM Developer for z Systems™) or of 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.
4. 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.
   1. Start Jazz™ Team Server.
   2. Create a repository connection from the Team Artifacts view of the Work Items perspective.
   3. Connect to the project area created upon the integration.
   4. From the project area, verify that four language definitions were created upon the integration. Expand Enterprise Extensions > System Definitions > z/OS > Language Definitions. 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
5. In the project area, create a stream on the server by right-clicking Source Code Data and by selecting New > Stream. Save.
6. Create a repository workspace from this stream by selecting New > Repository workspace. You can optionally modify the default name. Then, click Finish.
7. Share the project in which you created the Library and the Data Element.
   1. In the Design Explorer view of the Pattern Driven Programming perspective, right-click the project and select Team > Share project.
   2. Select the repository type (Jazz Source Control) and click Next.
   3. Select the repository workspace and create a component by clicking New component. Its name usually corresponds to the Library name on 3 characters.
   4. Select the component.
   5. Share the project by clicking Finish.
8. Upload the new Library and Data Element to the Rational Team Concert server.
   1. Open the Pending changes view.
   2. Expand the component line and expand the Outgoing > Share projects line. The two new instances must be displayed under the project indicated in their creation wizards.
   3. Select the line Share projects. Right-click and select Deliver. The changes are then uploaded to the server.
9. 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 Show > Repository files. The Library and the Data Element must be displayed in the Repository files view.

10. Verify that the server indexing that is processed by the Rational Programming Patterns scanners is active.
    1. In the Team Artifacts view of the Work Items perspective, start an incremental update of the indexes. Expand Enterprise Extensions > Source code data. Right-click and select Update Source code data.
    2. Start a server search on the Rational Programming Patterns artifacts to extract the two instances that were previously uploaded to the server.