PreviousBrowsing Your Project SourceConnect Customization for RevolveNext

Chapter 7: Configuring Utilities

This chapter describes the utilities that enable project and source file configuration.

7.1 Introduction

The Utilities menu provides you with a variety of options for customizing the analysis environment, including:

7.2 Options

The Options... menu item displays numerous tabs that enable you to set specific and general project options according to your analysis needs. This menu item is enabled for general environment settings prior to opening a project. When a project is opened, more tabs are available for project specific options.

Notice that if a project is shared, the options that are ADMIN exclusive are disabled to operators with USER access. For more information on shareable projects, refer to the section entitled Shareable Projects in the Managing Projects chapter.

7.2.1 Extensions

The Extensions tab enables you to allocate a supported file type to an unrecognized extension. An extension is a three character string that is separated from the file name with a period and identifies the file's type. Revolve references the extensions defined in the Extensions tab when loading files by automatic typing. Automatic typing is performed when automatic is selected in the Add Component dialog's Type field. It signals to the parser that file extensions define file type. For example, when adding the component ONLINE1.CBL's extension is CBL. .CBL indicates that ONLINE1 is a COBOL file. The parser recognizes the extension .CBL as a COBOL file and loads it into the project accordingly.

Figure 7-1: The Extensions Tab

A list of file extensions and associated file types is displayed in the Extensions tab. Define new extensions or delete existing ones. New settings are applied to the current project only and will take effect the next time that you add components.

7.2.2 Keymapping

The Keymapping tab, enables you to create keyboard shortcuts for frequently performed operations in the Integrated Editor. Keymappings are very useful for customizing the editing environment. They make editing more efficient because common operations and functions are initiated from the keyboard, cutting down on mouse usage.

Figure 7-2: The Keymapping Tab

There are many common operations that are defined by default. They are displayed in the Current Mappings list. New mappings are assigned keystrokes and an action performed. Then they are added to the current mappings list and are immediately available for use in the Integrated Editor.

7.2.3 Search Directories

The Search Directories tab displays a list of directories used to search for system components and included files during the parsing process. A search directory is an accessible system directory that you identify because it contains components of a certain type that are referenced in project modules.

Figure 7-3: The Search Directories Tab

The Automatic Component Locator (ACL) uses search directories to locate and load referenced project components. For example, notice in the figure above, c:\revolve\sample\cobol\ is defined as a search directory for COBOL files. During the parsing process, a JCL references a file named BATCH1.CBL. When the parser encounters the reference, it deploys the Automatic Component Locator to the search directories defined for COBOL. If BATCH1.CBL is contained in c:\revolve\sample\cobol\ then it is loaded and parsed into the project. This functionality helps you automate some of the project creation process.

Though adding search directories with the Search Directories tab is a satisfactory method, it is preferred that you use the Add Components dialog and the Automatic Component Locator instead. For an example of adding search directories, refer to Creating and Loading Projects in the Getting Started book and see the section in this chapter on ACL.

In addition to accessing the Search Directories tab from the Utilities >, you can also access it from the Project Manager with Options.... Note that the functionality of search directories settings modified from the Project Manager apply to elements selected in the manager's information window. This enables you to configure component level search directory settings. See the section Configuring At Component Level in the chapter Managing Projects for more information.

7.2.4 Import Translations

The Import Translations tab enables you to define file name translations for copybooks, proclibs, control cards, libraries, and other included files. Translating import names to supported standards is useful in some systems.

Figure 7-4: The Import Translations Dialog

7.2.5 ACL

During the initial setup of a project, you can spend a lot of time identifying relevant source code components in a system and downloading the correct files. The Automatic Component Locator or ACL makes this process easier and faster by:

Figure 7-5: The ACL Tab

Instead of having to individually add all source components to a project, you can specify a subset of modules (i.e. JCL job members, CICS tables, etc.) and let the Automatic Component Locator search for and load all of the required components. The ACL identifies references to components within the subset of modules and accesses defined search directories to locate and load components as they are referenced (i.e. COBOL, copybooks, procs, BMS, etc.). The ACL then recognizes references within the referenced components and loads the applicable files contained in defined search directories.

The ACL is enabled by default on the ACL tab. It works in conjunction with the Search Directories feature to locate directories containing necessary source components. If you want to use the ACL, you should set up search directories before adding components to a project. The best way to do this is to use the Add Components dialog. Select the directory that contains referenced source components. Set the Type to the type of the referenced components. Then click Add Search. When you add the subset of project modules, the search directory is used to load referenced components. For an example of adding search directories, refer to Creating and Loading Projects in the Getting Started book.

Not only is the functionality of the Automatic Component Locator useful when setting up a project but also in maintaining the project. When new components are added into a project during development, the Automatic Component Locator adds the new components and parses the new code. To start the loading process select Make on the Project menu or click Make on the Project Manager. Once the Make is complete, click Ok in the message box. The Automatic Component Locator only adds components referenced within the current project. That means that on line components not called by existing components in the project, such as MFS screens, may need to be added manually.

7.2.6 Project

The Project tab enables you to configure your project by locating necessary modules on your local system. The fields contained in the Project tab are designed to configure your projects according to the following functionality.


Revolve enables the administrator to protect administrative access to a shareable project with a password. You are required to know the password every time administrative access to a project is requested.

7.2.7 Directories

The Directories tab is where you configure general Revolve directory parameters.

7.2.8 User

The User tab provides options for operator specific settings. It is here that you specify a USER ID for yourself that is used in shareable projects and other features like annotations. You can also change the font that is used to display information in tools and browsers. The following options can be used to customize the analysis environment and operator settings.

7.2.9 Power Keys

The keys F1 - F12 are assigned useful functions. With a single keystroke you can perform frequently used commands. The settings for the power keys are displayed in the Defined Power Keyslist.

The Power Key Definition window displays the definition of the selected power key and enables you to edit an existing definition or create a new one. Once you're satisfied with your power key definition, click Set to save it and make it accessible.

7.2.10 DOS Translations

The DOS Translations tab enables you to map DOS drives, directories, and file names to other file names and directories. This feature is useful when a project has been built on a drive that appears to have different logical paths to different users. For example, if a project has been built on one user's workstation where the source files are located on a logical path beginning with U:\SOURCE\DTE.CBL and those same source files are stored on a second user's workstation on the logical path C:\PROJ\TEST.CBL then a file name translation can be used to map the original settings to the secondary user's parameters.

Figure 7-6: The DOS Translations Tab

7.2.11 External Tools

Tools can be integrated into Revolve with the External Tools tab. Once a tool has been added into Revolve, it is invoked from the Tools menu or the speed menu. When you want to add a new tool, first type the name of the tool in the Tool edit box. Then enter the command line call to the tool by entering it in the Command edit box, or by clicking the Browse button and selecting an executable program.

Once the tool name and command-line options have been completed, click on the Add Tool button to add the tool. Note that if a new tool is being added with the same name as a tool already incorporated, the new tool replaces the older tool.

The command line can include the parameters for the file name, directory, line, and column of the selected element. These parameters are substituted into the following wildcards:

%D Specifies the directory of the source code file that contains the selected element.
%E Specifies the extension of the source code file that contains the selected element.
%F Specifies the path and name of the source code file that contains the selected element.
%N Specifies the name of the source code file (with extension) that contains the selected element.
%S Specifies the name of the source code file (no extension) that contains the selected element.
%X Specifies the column in the source code where the selected element is located.
%Y Specifies the line number in the source code where the selected element is located.

To use these parameters, place {}'s around the portion of the command line that you want to be executed when an item is selected For example:

notepad.exe {%F} 

If no item is selected when the tool is executed, then the command-line within the brackets is not executed. To modify any tools listed in the External Tools tab, click on the name of the tool in the Current Tools list. This enables you to modify the name or command line for the tool. When finished with the changes to the tool, click Add Tool to add it again. If you modified the name of the tool, a new tool will be created with the new name. If the tool name remains the same, the older tool will be replaced with your modifications.

To delete a tool from Revolve select the tool's name from the list and click Delete.

7.2.12 Component Parameters

The Component Parameters tab contains options that determine how system files are handled in your project. These options serve as default settings for all components based on type as they are added to the current project. For example, all COBOL files that are added to the project are given parameters based on these settings. If you change COBOL settings, all COBOL files that are already loaded in the project are not affected. The new settings are applied to new COBOL files that you add to the project.

Figure 7-7: The Component Parameters Tab

The following parameters are available.

Type: This pull down list box allows you to determine component file type. Component parameters are applied to all components of this specified type that are subsequently added to the project. Component parameter's vary depending on this setting.
Version: This pull-down list box allows you to specify the version of COBOL that is being used.
Starting Column: Determines the column in which the code begins (after line numbers and comment indicator column if any).
Ending Column Specify the first non-relevant column in the source code. For example, if you code in columns 2 through 72, then column 73 is the ending column.
Comment Chars: User-defined comment characters must be entered into the comment chars field. No separations (commas, semicolons, etc.) are needed between characters. Lines of code preceded by the specified characters will be recognized by Revolve as comments.
End Column No Comments: Allows code to be loaded beyond the ending column.
Allow Extended ASCII Check this to indicate that ASCII symbols 128 to 255, known as extended ASCII, be translated to appropriate characters.
Comment * in first column: Marks any line starting with a * as a column no matter where the * first appears.
Use Component Name: For COBOL and text types, specifies that the component's file name should be used as the load module name.
Use Oracle Keywords: For COBOL , initiates the parsing of Oracle keywords.
Align fields: For BMS types, aligns the BMS fields so that they fall on the correct boundaries. For example a setting of 2 bytes would align the BMS fields so that they all started on a word (16 bits) boundary.
Schedule ID: For JCL types, sets or changes the SCHID. The SCHID is optionally used by JCL to identify pieces of JCL code which should be executed.
Optional PROC Card: For JCL types, indicates that a proc card is not required on cataloged procedures.
Librarian Replacement When this is checked it enables Librarian replacement procedures.
Word Storage Mode: Effects COBOL BINARY variable size. With this option selected variables align on 2,4, and 8 byte boundaries, in contrast to single byte boundaries.
Multiple Statements/Line: Allows multiple statements per line in COBOL programs.
//Terminates Job Indicates that when a "//" card is encountered in the JCL, processing will stop.
Defines an IO-PCB Specifies that the program has defined an IO-PCB. Auto indicates the CMPAT option is taken from corresponding PSB. Yes indicates the program defines an IO-PCB. No means it does not define an IO-PCB.
Import By Type If enabled, indicates imports are strictly interpreted. For example, COPY ABC would not find ABC.INC because it is an include file as opposed to a copybook file.
PL/I 48 Character Keyword For PL/I types, limits the character set for PL/I keywords.
Skip Preprocessor Procs If you don't use the Revolve PL/I preprocessor and your code contains preprocessor macros, then this option should be enabled.

The term for the settings available in the Component Parameters tab is Project Level, because these options are applied to all components as they are added to the project. Sometimes it is useful to redefine parameters for components that have already been added to the project. Revolve facilitates this in the Project Manager. For more information see Configuring At Component Level.

7.3 Tools/Views Options

The Tools/Views Options... tabs enable you to modify the default settings for various tools and views. Most views and tools that make use of an option dialog are represented here with a corresponding tab. The settings on these tabs are defaults and are used when tools and views are opened.

7.4 Browser Options

The Browser Options tabs enable you to modify the default settings for several browser Option dialogs. These settings are used when browsers are opened and implemented in analysis.

Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousBrowsing Your Project SourceConnect Customization for RevolveNext