Start Here for the Tutorials

Finding Sets of Monetary Points of Interest

Chapter 5: Loading a Project into the Database

This chapter contains the first in a set of five tutorials, which together give a tour of EuroSmart. This tutorial shows how to create a project and load the source files into a project database.

5.1 Overview

Before starting the analysis, you need to carry out an inventory of all the COBOL source, copyfiles, BMS files, JCL files and so on that comprise the application.

In this first tutorial, you create a project for the sample Order application and load its source files into a project database. You then check the loaded project and investigate a problem that occurred.

This tutorial takes about 20 minutes.

5.2 Preparation - Restarting this Tutorial

This section explains how to restart the tutorials if you have already followed some of them. If you haven't followed any of them at all, you can go straight to the next section.

If you want to restart the tutorials, you need to delete the project files that you created:

1. If you have shut down EuroSmart, restart it in the same way as before, and open the Order project by selecting it from the recent files list at the bottom of the Project menu.

2. Delete the Order project that you created, using Delete on the Project menu.

3. Confirm deletion of the project, by making sure that Delete out related database files is checked and clicking OK.

4. Delete any other project files that you have created when following the tutorials. These files might include reports, named sets and composite tools. Do this from Windows and delete all the files in the project directory, Projects\Order.

5.3 Creating a Project and Loading the Database

A central component of EuroSmart is a project database containing a complete representation of an application's source code. The database represents not only the content of your application but also its structure. The first step is to create a project for your application and load its source files into the database.

This section shows how to create a project Order.prj containing the demonstration source files, and how to load these files into the database.

1. Create a subdirectory for the project you are about to create. For example, create Projects\Order for the Order project. Do this in Windows. Never create more than one project in the same subdirectory.

   If you are running EuroSmart on a network, create a local directory for your own copy of the project, to prevent sharing conflicts with other users, for example, c:\Projects\Order.

2. From the Start menu, click Programs > Micro Focus EuroSmart > EuroSmart.

3. If you have the Unisys Extension installed, you need to reset the COBOL dialect. To do this, click Properties on the Project menu and choose General.

4. From the Project menu, click New.

5. Choose the subdirectory you just created and specify the name of the new project, Order.prj and click OK.

6. Click Yes in response to the prompt "Add Components?".

7. In the Add Components dialog, specify the source file components to add to the new project, as follows and as shown in Figure 5-1:
   • Select the drive where you installed the product, which is c: by default.

   • Ensure that File Type is set to automatic.

   • Ensure that Filter is set to *.*.

   • Select the directory where you installed the product down to the Order subdirectory, for example EuroSmart\Revolve\Sample\Euro\Order. To go back up one level in the directory hierarchy, click . ..

     Select all the source files for the Order application, by clicking the subdirectory source.

   
   
   Figure 5-1: Add Components

8. Click Add to add the selected files to the project.

9. When the 15 component files have been added to the project, click OK and click Done.

10. Click Yes to start loading the database.

11. While the files are loaded into the database, they are parsed, checking for inconsistencies and errors of various sorts. This Order project does not have any parsing problems.

    Click OK in response to message saying that the project is up to date.

The new project is now created and loaded into the project database.

5.4 Reviewing the Contents of the Project

When you create a project and load the source files, the files are parsed and checked for inconsistencies, missing files, misnamed components and so on. For example, you might uncover references to other program source files and copy books, or file definitions, screen layouts, job control and so on. You need to check for missing files and add them if appropriate, so that the project database is complete and up to date.

This section shows how to check any potential problems that were discovered when loading the sample programs into the project database.

1. Go to the Project Manager window. If this is not already displayed, click Manager on the Project menu.

2. Double click the folder of cobol files to list the 2 files, Order.cbl and Setup.cbl, that you added to the project.

3. Similarly, double click the folder copybook files to list the 11 copyfiles that the project uses. Notice that the copyfile, Accdis.cpy was not loaded. this is because the COPY statement referring to this file is commented out, and so the file is not needed.

   Note that the terms copybooks, copybook files and copyfiles are synonymous.

4. Close the Project Manager window by clicking in the top right corner of the window. The project still stays open, as shown in the EuroSmart title bar.

5.5 Reviewing the Completeness of the Project

This section shows how to review the completeness and coherence of the project and look for missing modules or misnamed files.

1. Click Complete on the Project menu. In the Complete Project window, there is one folder for each type of error to check for.

2. Double click each folder in turn to check if there are any errors in each one. If a folder disappears, there aren't any errors of that sort.

   The missing copybook file Accdis.cpy is listed together with the explanation that it is not used. We can ignore this for the purpose of this tutorial.

3. Close the Complete Project window.

5.6 Before Continuing

You can close EuroSmart, if you want to stop for now, by clicking Exit on the Project menu, or clicking at the top right of the EuroSmart window

The project that you have created and loaded into the project database is automatically saved.

You can continue with the next tutorial later, by simply reopening the project.

Start Here for the Tutorials

Finding Sets of Monetary Points of Interest