PreviousManaging Projects ToolsNext

Chapter 19: The Interface

This chapter describes the environment that you will be working in. After reading this chapter you should be able to navigate some of the most commonly used features.

19.1 Introduction

The Revolve interface consists of different tools, browsers, and dialogs which are invoked from the Desktop. Tools and browsers are windows designed around a series of common features that make using Revolve both flexible and consistent.

Figure 2:1 shows the interface.

Figure 19-1: The Interface

The following sections describe the main features you will encounter while using Revolve's interface.

19.2 Desktop

The Desktop houses all of Revolve's features and analyses. It is displayed when Revolve is invoked. The menus and toolbars let you create and open projects, as well as invoke the necessary features needed to address your analysis. All of the windows used in conjunction with this environment are contained in the Desktop.

19.3 Match Edit Bar

The Match edit bar contains features that enable you to search your project for specific items and load them into the open tool or browser. Use the Match edit field to enter criteria that identifies desired items in the project. The following are special characters that you can use to perform high-level searches:

Use This:
To Do This:
       * Use this to find all items with similar names. For example, if "WS*" is entered into the Match edit field in the Variables browser, the information window will display all the variables with names that begin with "WS." In most cases, if the wildcard character is used alone as a match criteria, the information window will fill with all items in the project as they pertain to the specific browser or tool.
       ? Use this to construct a pattern where "?" stands for a single arbitrary character. For example, "WS?" would match all names consisting of "WS" and another character, like WS1 or WSA.
       | Use the or bar to enter multiple matching patterns for one query. For example, "*month*|*year*" would return all items which have either "month" or "year" in their names.

If a pull-down list box is displayed on the Match edit bar, you can specify how the results in the Information Window are organized or what types (e.g. program or load module) of items are searched for in the project. If you change the selection in this list after Match has been clicked, you need to click Match again to apply the new setting to the information displayed.

After search parameters have been established, click Match . The criteria is applied to the project and the results are displayed in the Information Window. The Match edit bar displays a description of how many items were returned based on the criteria. For example, the text, "64 Variables matching "default*"" is displayed after default* is entered in the field and Match is clicked.

19.4 Information Screening

In addition to the Match edit bar, many tools and browsers have their own Options dialogs. Click Options... on the toolbar of the tool or browser you are using and customize the settings according to your needs. Options enable you to modify the project search criteria as well as how items are displayed in the Information Window. Often new settings are automatically applied to the project when you click Ok and the results are instantaneously returned. However, some browsers require that you click Match again.

19.5 Information Window

Most of the tools and browsers use an Information Window to display results based on the criteria specified in the Match edit bar.

The Information Window uses a folder format to display results and information. Relevant project items, depending on the analysis that was performed, appear as parent folders in the same vertical column and at the same hierarchical level. When a parent folder is expanded, additional information appears beneath and indented as children folders. Note Figure 19-2 below.

Folders are expanded by double-clicking with the mouse. Also use , , to expand and collapse folders.

The results displayed in Information Windows are organized as follows:

- a parent line which has not been expanded. The "+" indicates that Revolve has retrieved database information for this item that will appear as subsequent or children folders when double-clicked.

- a parent line which has already been expanded and contains children folders.

- a line which has been expanded and whose children are currently displayed.

- a line which is not expandable. Commonly referred to as a leaf.

Figure 19-2: The Information Window

19.6 Toolbar

The toolbar contains buttons for the operations you use most commonly. While several buttons are common across all windows, many are related to the tool or browser they are contained in. When you place the cursor on top of a button its name is displayed in floating text. For definitions of specific buttons, see Appendix B.

19.7 Speed Menu

The speed menu is displayed by right-clicking on an item in a tool or browser. It enables you to quickly access other features that are applicable to the selected item. The speed menu is especially useful for highlighting selected items and providing quick access to the source code in the Source View or the Integrated Editor.

Select this:
To do this:
Select Make the selected item the scope of analysis. After doing this, the item should be displayed at the bottom of the Desktop.
Highlight Highlight the item's occurrence in the source with the color displayed in the Color Menu.
Clear Clear highlighting in the source code for the selected element.
Capture Results Add the selected to an item in the Capture Results dialog.
Go To Open the Source view for the selected element's source code.
Information Display the Browser that applies to the selected element.
Tools Open applicable Tools for the selected element.
Browsers Choose a Browser to invoke.

19.8 Viewing Source Code

When the View Source Code button is clicked, the Split Screen Editor is opened within the current Information Window. It displays the source code for any element selected in the information window.

See also For more information about the Split Screen Editor, see the section on the Integrated Editor

19.9 Printing

Printing the contents of an open window is performed by pressing the Print button .

The generated report will contain either a graphical or textual representation of the information displayed in the open window. Any information which has not been expanded (as with collapsed hierarchy levels in information windows) will not be printed. The following options are available in the Printdialog:

19.10 Highlighting

Highlighting marks source code elements in selected colors. The Color menu, located at the bottom of the Desktop, allows you to specify a highlighting color. When you click Highlight in a browser, the source code for all leaves () will be highlighted in the specified color. The Source view is invoked to display the line of code that was highlighted.

You can also highlight by right-clicking on an element and selecting Highlight. To view the highlighted code, right-click on it again and select Go To, or click to view the source code in the Split Screen Editor.

To remove highlighting for an item, right-click the element and select Clear.

See also Color Menu.

19.11 Modification Driver

To support the transition from source code analysis to the implementation of modifications Revolve supplies you with the Modification Driver. The Modification Driver lets you automatically insert text, comments, and/or code into the source code of selected items. This feature facilitates the implementation of source code changes in Revolve and allows for Revolve analysis results to marked for follow-up modifications in other development environments. Identified changes can be tagged or commented in the source code with the Modification Driver and easily located in Micro Focus Workbench® or other editing environments.

To insert user-defined text:

  1. Select applicable item(s) in the information window. Multiple items can be selected. The Ctrl key used with the left mouse button allows you to select multiple items that do not occur sequentially.
  2. Click . The Modification Driver dialog is displayed.
  3. To tag columns, activate the Tag columns check box.
  4. Specify the column numbers in the respective fields. The column tag parameters should be set from 1 to 6 for COBOL code
  5. In the adjoining field, enter the text that should be inserted into the tagged column.
  6. To insert comments or code before selected source code, activate the Insert before check box and enter text into the adjoining field. To insert COBOL comments, space over six positions in order to preserve proper column alignment. Also preface comments with an asterisk (*).
  7. To insert text after selected code, activate the Insert after check box and enter text into the adjoining field. To insert COBOL comments, space over six positions in order to preserve proper column alignment. Also preface comments with an asterisk (*)

To insert text into the source code of multiple items in one step, set the parameters discussed above and click Execute all . The Execute button inserts text into the code of the current item. To skip a selected item's source code and continue insertions in the next item's code, click Skip. All insertions can be viewed in the Split Screen Editor.

Upon closing the browser or tool in which changes have been made, you will be prompted by a Save File dialog to save modifications. Yes to All saves all modifications that have been made. No to All cancels all changes. Yes saves the modification of the displayed item and No cancels it.

19.12 Capturing Results

The Capture Results dialog is invoked by clicking Add to Annotation.... Capturing results enables you to add selected items to annotations, subprojects, POP files, and TAG files.

Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousManaging Projects ToolsNext