Start Here for the Tutorials

Finding Dates and Reviewing the Worksheet

Chapter 5: Loading an Application into the Database

The tutorial in this chapter shows how to create a project and load the source files into the project database.

5.1 Overview

Before starting the year 2000 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 demonstration application and load its source files into a project database. You then review the completeness of the project to make sure that there are not any missing files. Finally, you check the warnings that might have occurred when parsing the application.

This tutorial takes about 20 minutes.

5.2 Preparation

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

To restart the tutorials:

1. If SmartFind Plus is not running, restart it in the same way as before.

2. Open the Tour project, by selecting it from the recent files list at the bottom of the Project menu.

3. Delete the project, as follows:
   • Click Delete on the Project menu.
   • Check Delete out related database files.
   • Click Yes.

   This deletes the project and the worksheet if you have created one.

5.3 Creating a Project and Loading the Database

The central component of SmartFind Plus 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 tour.prj containing the demonstration source files, and how to load these files into the database.

1. From the Start menu, click Programs > Micro Focus SmartFind Plus > SmartFind Plus.

2. From the Project menu, click New.

3. Use Create New Folder to create a directory, such as projects\tour, for the project you are about to create. Never create more than one project in the same directory.

   If you are running SmartFind Plus 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\tour.

4. Choose the subdirectory you just created and specify the name of the new project, tour.prj and click Create.

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

6. 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 Redeem subdirectory, for example, \Sfplus\Revolve\Sample\Smartfind\Redeem. Click . . to go back up one level in the directory hierarchy.

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

   
   
   Figure 5-1: Add Components

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

8. When the 11 component files have been added to the project, click OK and click Done.

9. Click Yes to start loading the database.

10. While the files are loaded into the database, they are parsed, checking for inconsistencies and errors of various sorts.

11. 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 Completeness 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, parsing 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 demonstration programs into the 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 see the 3 files that you added to the project.

3. Similarly, double click the folder copybook files to see the 7 copyfiles that the project uses. Copybooks, copybook files and copyfiles are synonymous.

4. Now go to the Complete Project window, by clicking Complete on the Project menu.

5. Check for each type of error, by double clicking each folder in turn in the Complete Project window. If a folder disappears, there are no errors of that sort.

   There is one control card file that is listed as not found. This does not matter for the purpose of these tutorials, but you can clear it as follows:

   • Select the line containing the warning about the missing control card.
   • Click Fix.
   • Click Import is not available.
   • Click OK.

6. Close the Complete Project window, by clicking at the top right of the window.

5.5 Reviewing Parsing Problems

When you create a project and load the source files, the files are parsed, checking for inconsistencies, COBOL syntax errors and so on. You need to fix these problems as appropriate, so that the database is accurate, complete and up to date before you start the year 2000 analysis itself.

In this section you check whether any parsing problems were discovered when loading the demonstration programs into the database.

1. Click Scripts on the Tools menu.

2. Double click Parsing Problems.

3. Select List Errors and Warnings and click Run/Stop.

4. Select all the programs and click OK.

   There are not any parsing problems.

5. Close the Report window and the Scripts window, by clicking at the top right of those windows.

6. Close the Project Manager window. The project still stays open, as shown in the SmartFind Plus title bar.

The new project is now loaded correctly into the project database, and ready for you to analyze.

5.6 Before Continuing

You can close SmartFind Plus, if you want to stop for now. The project that you have created and loaded into the database is automatically saved.

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

Start Here for the Tutorials

Finding Dates and Reviewing the Worksheet