, you can adjust
results to show minimal or maximum detail. Default options are modified by
clicking Utilities > Browser Options.
This chapter describes navigating 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 or 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
Options
, you can adjust
results to show minimal or maximum detail. Default options are modified by
clicking Utilities > Browser Options.
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.
Text Browser Options enable 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 match considers the case of text as 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 Statements dialog is displayed when you invoke this browser from the Browsers menu.
The Options tab on the Statements 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 you do not specify anything, an information list will not be collected.
Unlike other browsers, it is programs rather than statements that are the top level items displayed. When you enter characters in the Match edit field they must identify the program that contains the statement rather than the statement itself. Use the Statements dialog 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 Options tab on the Programs dialog enables 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 click Select All, 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 names 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 JCLs which access the file. And if you need more detail the browser will go directly to the program statements or JCL DDs where the files are accessed. The Data Files browser will also display which buffers and copybooks are being used with each file, if you use the Variables shown in checkboxes in the Data Files tab of the Options dialog.
The Data Files tab on the Options dialog enables 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 to which the Match criteria are applied.
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 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, 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.
You switch between Program and File mode by clicking the relevant button on the Variables browser toolbar.
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 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 Data Structure browser illustrates the data hierarchy by displaying all the variables in a program, section, or group level.
When the Data Structure browser is invoked from the Browsers menu, an Open Data Structure dialog appears. To find a specific file, enter the file name into the Match edit box and click Match. Or use the list to find and select multiple files for display in the browser. The Select All button selects all of the items in the scroll-able list and opens Data Structure browsers for each file.
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 job stream browser provides a way of exploring a job stream in terms of its associations with other application objects. When you expand a job stream in the browser, it will show all the events, job executions, and manual operations contained within it, as shown below:
Job stream operations is a collectively name for the events, job executions, and manual operations shown above. When any job stream operation is expanded in the browser, you can see its predecessors, successors, and exclusions:
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, xctls, et cetera.). By selecting all items in the
information window and clicking Expand One Level
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 PSBs, 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 Options tab on the Options dialog enables 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 click Select All, the next Match will return conclusive information based on all the settings.
The Custom Browsers tool enables you to load compiled scripts into a browser-type interface in order to perform specific script-based queries on your project. Results are based on the criteria you type into the Match edit field. Compiled scripts must have an extension of .rqc. Contact Micro Focus to obtain compiled scripts supported by this interface.
Copyright © 2006 Micro Focus (IP) Ltd. All rights reserved.