|Implementing Analysis Tools||Configuring Utilities|
This chapter describes navigating through your project with Revolve's browsers. These browsers are excellent vehicles for exploring specific component types and extending your system analysis.
Browsers enable you to examine your project's source code components. By collecting data about specific pieces of your project and component usage, you become more familiar with your system and its structure. Browsers are invoked from the Browsers menu and by selecting Information on the speed menu.
Each browser performs high level searches based on the component type that it supports and the regular expressions that are entered into the Match edit box. Most browsers accept the search characters described in the Matching section in The Interface chapter. Results are displayed in the browser's information window. Information windows allow dynamic expansion and contraction of displayed data that is customized to the particular browser in use. With this type of control, you are able to access specifics without being bogged down with details.
If the browser has an Options dialog, invoked with , you can adjust results to show minimal or maximum detail. Default options are modified by selecting the Utilities/Browser Options menu option.
The Text browser allows you to find specific text strings in your project. Each line of text which is found is accompanied with comprehensive information that makes access to the source code and file that contains it quick and easy. Any characters entered into the Text field will be included in the text search. For example, characters used in other browsers as wildcards or search characters (* , | , and ?) are considered part of a text string.
The Text Browser Options tab enables you to control the Text browser. These settings are essential to your text search because the Text browser operates in two different modes:
When Search All Project Files is checked you should:
The search is performed on loaded project files which match the specified type text string. For example, to find all occurrences of the string "date" in the files currently loaded in your project, click Search All Project Files, as opposed to Specify Search Files.
When Specify Search Files is checked:
File specifications listed consecutively must be separated with a semicolon.
Revolve searches through the file(s), finding any lines which contain text matching the given string. This is useful to search for text strings outside of the Revolve project.
Revolve assumes that Specify Search Files is being used to search for text strings outside of the loaded project, so standard Revolve features will not apply to the returned information. For example, text strings located with Specify Search Files will be displayed in the standard format as seen across Revolve but the speed menu, tools, and views will not be available.
When you check Case Sensitive, the search factors in the case as a part of the search pattern.
The Statements browser identifies statements in the source code, including the names of the programs that contain the statements and the line numbers of each usage. The Statement Options dialog is displayed when you invoke this browser from the Browsers menu.
The Statement Options dialog contains a list box of all statement types which can be found. Select individual statements in the list, or select by: Groups, Arithmetics, Control Flow, and/or File Access. If specifications are not made, an information list will not be collected.
Unlike other browsers, programs instead of statements are the top level items that are displayed. When you enter characters in the Match edit field it must identify the program that contains the statement rather than the statement itself. Statement Options must be used to define the types of statements in the scope of the query.
The Programs browser displays detailed information about programs/load modules. You can view copybooks and data files and their usage by programs/load modules, as well as the usage of the programs/load modules in other components. Program accessed screens and line numbers are also given.
The Program Browser Options enable you to screen the information that is returned in the Programs browser. For example, if Copybooks Used is the only option you have checked, your next Match in the Browser will return information about copybooks used in your project's programs. Likewise, if you Select All in the Program Browser Options, the next Match will return conclusive information based on all the settings.
The Imports browser displays information about imports in your project's source code. Use import file name's as criteria to enter into the Match edit field. Imports are returned based on their names. Each line displays the amount of use and the physical path of the import. As you expand folders, you see the components that use the import and the individual usage. Select displayed items and click Expand One Level to create a complete import cross-reference report for your entire system.
The Data Files Browser displays information about files used by programs in your project. This browser lets you quickly see where a file is accessed across an entire project. It displays the on-line programs, batch programs, and JCL's which access the file. And if you need more detail the browser will go directly to the program statements or JCL DD's where the files are accessed. The Data Files Browser will also display what buffers and copybooks are being used with each file, by using the Associated Variables option in the File Information Options dialog.
The Data Files Browser Options enable you to adjust the information that is displayed in the information window. Consistent with other tools and browsers, the options dialog gives you complete control over the data that the Match criteria are applied to.
The Variables browser displays comprehensive information about the variables and conditionals used in your application. You can access a variable's line number, as well as the file names that modify, reference, or redefine it. Also, the usage of a variable across a project can be viewed from this browser.
In Program Mode (default mode) all data usage is categorized by logical programs. A logical program includes not only the contents of the COBOL file but also the contents of all copybooks and includes which are found during the load. Therefore, if a variable is declared or used in a copybook that is used by many COBOL programs, then each program using that copybook will be listed in the information window when the variable is expanded.
In File Mode the browser groups usage by physical file. Copybooks which include usage or definitions of a variable are only listed once in the information window. COBOL programs must have a usage or definition outside of copybook or include for the program to appear in the information window when a variable is expanded.
The Variables browser can be adjusted to screen and filter the information that is displayed. Consistent with other Revolve windows, the Options... dialog contains settings that give enable you to have complete control over the information that is displayed in the Variables browser. All direct redefines, direct references, and direct modifications of the specified variable will be set by default in the Variable Browser Options dialog. In addition to the default criteria you can modify the specifications to include information about other variables that are related to the specified variable. You have the following options:
The Paragraphs and Sections browser displays information about labels in the source code. With the Paragraphs and Sections browser you have access to the name of the file(s) containing the paragraph or section, the line number of the label, the calls to the label, and the calls made within the label.
The Literals browser displays information about literals used in the source code. With the Literals browser you can access the number of occurrences of the specified literal, the name of the files containing the literal, line numbers of the literal within the file, and the entire line of text containing the literal.
The JCL Jobs browser displays information about JCL jobs. With this browser, you can quickly see which programs are called by the JCL job and which data files are accessed. This browser will also display schedules and subprojects that contain jobs. If the Unisys Extension is installed this browser will display ECL called programs and data files.
The Screens browser displays information about the screens used by the programs in your project. With the Screens browser, you can access information about the file which contains a screen definition, programs that use the screen, the line number, and type of each screen access.
The Fields browser displays information about fields used by screens or programs in the project. You can access information about the screens which contain the fields, the programs using the fields, the line number, and field type.
The CICS browser displays information about CICS datasets, programs, and transactions used in the source code. By accessing the CICS browser you can view programs that access the entities and the actual calls that perform the access (CICS reads/writes, xctl's, etc.). By selecting all items in the information window and clicking the Expand One Level button you can quickly get a cross-reference report showing which programs access different datasets, programs, and transactions. The aliased name is given in parentheses.
The IMS browser displays information about IMS entities used in the source code. By using this browser, you can cross-reference IMS Datasets, IMS PSB's, and IMS Transactions.
With the SQL browser you have access to comprehensive information about database tables and columns that are used in the source code. The information window will display the line numbers and types of each reference, as well as the programs that reference the tables and columns.
The DMS browser displays detailed information about programs/load modules. You can view copybooks and data files and their usage per DMS programs/load modules, as well as the usage of the programs/load modules in other components. DMS accessed screens and line numbers are also provided.
The DMS Browser Options enable you to screen the information that is returned in the DMS browser. For example, if Copybooks Used is the only option you have checked, your next Match in the browser will return information about copybooks used in your project's DMS components. Likewise, if you Select All in the DMS Browser Options, the next Match will return conclusive information based on all the settings.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
|Implementing Analysis Tools||Configuring Utilities|