Chapter 10: Investigating Your Project

In this session, you take a look at the Investigator tool and how to incorporate it into your system analysis.

Please see the Tutorials Map to check that you have run all necessary previous sessions.

10.1 Overview

Effective system analysis requires knowledge of the system and an organized plan to implement modifications. The Investigator tool enables you to load project components of varied types into one interface for extended analysis and organization.

10.2 Preparation

This session uses the project you created in the chapter Finding Points of Interest.

If you have closed Revolve, open it as before.
If you have closed it, open the Order project by selecting it from the "recently used files" list at the bottom of the Project menu.

10.3 Adding Items to the Investigator From Tools and Browsers

While working in Revolve's tools and browsers you can add items to the Investigator using the Revolve clipboard. For example:

Select Browsers > Variables.
Type *VALUE in the Match edit box.
Click Match or press Enter.
Variables in your project that match the name selection criterion are displayed.
Click the first variable and drag the mouse down the list, to select all the variables displayed in the window.
Right-click and click Capture Results.
Click Copy to Clipboard, then OK to close the Capture Results dialog box.
Click OK on the Capture to Clipboard message.
Click Enterprise > Investigator.
Click Cancel on the Selection Criteria dialog box.
Click Paste from clipboard.
Double-click the COBOL variable folder.
The folder expands to display the variables that were copied from the Variables browser.
In the Investigator you can remove elements from the display without removing them from the tool. Let's assume that the variables CAT-END-VALUE, and CAT-START-VALUE are unnecessary variables in this analysis. However, you're not sure that you want to remove them entirely from the Investigator. In this case, you can place these variables on the Filtered list.
Select the variables CAT-END-VALUE and CAT-START-VALUE.
Click Exclude Selected.
This excludes the variables from the displayed list. They are placed on the filtered list. You cannot see this immediately because the window has not been refreshed.
Click Show/Hide filtered list.
This toggles to the Filtered list. It displays all items that match filters specified in the Selection Criteria dialog or are directly excluded by the user.
Double click the COBOL variable folder to examine the filtered items.
The E flag indicates that you excluded these elements. User-specified filters like this are also displayed on the User tab when you click Options....
Click on the Investigator to close it, then click Yes.
Click Window > Close All Windows.

10.4 Creating Selection Criteria

You can add items to the Investigator in two ways. In this section, you add items directly to the Investigator using Selection Criteria.

To add items directly to the Investigator, you can set up Selection Criteria:

Click Enterprise > Investigator.
In the Variable tab's Name field, type *VALUE.
The name-matching pattern *VALUE searches the project for all variables that include VALUE at the end of their names.
Click Add.
Check Name filters.
This applies all naming filters defined in the Name Filters dialog to the Pattern Selection criteria.
Click Name.
Name patterns specified here are not included in the Investigator's results.
Type CAT* in the Name field.
This means that variables matching the *VALUE pattern but containing CAT at the beginning of their names will not be listed by the Investigator.
Click Add and then OK.
Click OK in the Selection Criteria dialog, and click Yes in response to the apply new pattern criteria prompt.
Double-click the COBOL variable folder.
The matching results are displayed. These items all correspond to the name criteria *VALUE. Depending on the Display Format that is selected in the Utilities > Options... > User tab, detail may be abbreviated or extensive.
Click Show /Hide filtered list.
Double-click the COBOL variable folder.
These are the variables in the project that matched the filter criteria CAT*. The N flag indicates they are filtered because of their names.
Click Show /Hide filtered list again to return to the selected list.

10.5 Saving Selection Criteria

You can save selection criteria in a file so that you can reuse the same criteria later in your analysis. To do this:

On the Investigator toolbar, click Options....
Let's add some more criteria. Click the Data File tab.
The Data File tab, like the Variable tab, adds items that correspond to the Pattern Selections and Filters. In this case, the items are references to external files.
Type PROD.* in the Name field.
Click Add, OK and then Yes in response to the apply new pattern criteria prompt.
The elements that match the criteria are loaded into the Investigator.
Double-click the file folder.
The filenames that matched the name patterns are displayed.
Click Options... again.
Click Save.
You can save the existing criteria to a .sel file for use in other tasks and analysis.
Navigate to your \projects\shadows directory.
Name the file sample, and click Save to save it as sample.sel.
Click OK in the Selection Criteria dialog box.
Close the Investigator by clicking , and reopen it by clicking Enterprise > Investigator.
Click Load, then navigate to the file you saved as sample.sel and open it.
Click OK, and Yes in response to the apply new pattern criteria prompt.
The results are displayed just as they were before.

10.6 Translating PIC Clauses

In addition to loading and examining files, you can modify PIC clauses with the Investigator. In our project, there are some monetary data items defined as PIC 9(7)V99 that we're going to translate to PIC 9(9)V99. To do this:

On the Investigator toolbar, click Options.
Click the PIC Translation tab.
This tab enables you to define PIC translations that you apply to your project variables.
Type 9(7)V99 in the From field.
Type 9(9)V99 in the To field.
Click Add and then OK.
The translation is listed in the translation list.
Double-click the COBOL variable folder.
Notice the PIC clauses are displayed for the various variables that match the name patterns and filters in sample.sel. To apply the PIC translations to these variables we'll use the Modification Driver.
Select all the elements contained in the COBOL variable folder.
Click Modification Driver.
The first selected item is referenced. Specify the code modifications you want to implement. The modification driver can insert blocks of text, tags, and other user-defined information into the source code of selected elements. In this case we want to implement the PIC translation for 9(7)V99 PIC clauses.

The first selected variable in the Investigator might not have a PIC clause. This is indicated if the PIC Translation check box is disabled (grayed). If this is the case, click Skip until the first variable with a PIC clause is encountered and the check box is enabled.
Check PIC Translation.
This specifies that the Modification Driver's function is to perform the PIC translations defined in the Investigator's PIC Translations tab.
Click Setup to list the defined translations.
Click OK.
Click Execute All.
The Modification Driver translates 9(7)V99 PIC clauses to 9(9)V99 in selected variables. When it encounters a PIC clause that is not 9(7)V99, it displays the PIC Translations tab for you to add further translations if you want to. Notice the name of the variable is displayed along the top of the tab.
Click Cancel until the Modification Driver finishes running through the list.
The non 9(7)V99 clauses are preserved while all 9(7)V99 clauses have been automatically translated.
Select a variable with a 9(7)V99 clause in the Investigator, like Line 132: 15 WS-LINE-VALUE PIC 9(7)V99.
Click View Source Code.

The source code has been modified to include the new PIC translation. Changes must be saved and the project must be parsed for these modifications to take effect on the project. However, only the Administrator of a shared project can update the project by parsing and remaking it.

To update the project to incorporate the changes:

Close the Investigator window, then click Yes on the Save File message.
Click Project > Make Administrator.
Click at the bottom of the Revolve desktop to open the Project Manager window.
Double-click the cobol files folder.
Click Status.
Revolve checks time stamps on COBOL files to see which files have been modified. ONLINE1.CBL contained the changed PIC clauses. It displays a status of Out of Date.
Click Make.
The project is parsed to incorporate all recent changes. Click OK when it is finished.
Double-click the cobol files folder again.
The files have a status of Loaded. The PIC translations have been successfully implemented.

10.7 Summary

In this session you:

Loaded the Investigator from tools and browsers
Loaded with Selection Criteria
Saved Selection Criteria
Translated PIC clauses

This session completes the Revolve Enterprise Edition tutorials. For further information, please read the Revolve Enterprise Edition User's Guide, or see the online help system.

Comments on the books? Click Send Us Comments.