Quick Reference

DevEnterprise has an easy-to-use graphical interface that provides programmers with a view of their application. With this product, programmers can statically analyze complex systems and programs, dynamically analyze business functions, and segment application programs easily, which simplifies their re-use in other applications.

Metadata Analyzer

To log in

This step logs you in and connects you to a Metadata Server. Contact the administrator of the Metadata Server for the host (machine name) and port number of the Metadata Server, and record this information below.

Launch Metadata Analyzer

Select Guest from the Userid drop-down list. The host (machine) name and port number of the Metadata Server autopopulate.

Viewing collected metadata

The Metadata Analyzer is used to access metadata that has been collected about your applications. It lets you:

• Search for entities that match your criteria .
• View the results of the search — the entities in the repository that match the search criteria.
• View the properties of the metadata found , such as name, type, length, and owner.

 Search for entities that match your criteria

The first step in finding out information about your applications is to search for entities that match what you are looking for. There are several ways to search for an entity, including:

• Using the Search dialog box
• Using the Search Relationships wizard
• Using the Advanced Search dialog box

Using the Search dialog box

The simplest way to search is by using the Search dialog box.

From the Search menu, select Search.

When you have entered all of the search criteria, click Search. Entities that match the search criteria are shown in the Entities view .

Using the Search Relationships wizard

The Search Relationships wizard lets you find entities based on their entity criteria and their relationship to other entities, such as Jobs that use a certain Dataset.

1. From the Search menu, select Search Relationships.
2. Complete this dialog box as described below.
   
3. In this dialog box, select those entities you want to carry on to the next step of the wizard, then click Next.
   
   
4. In this dialog box, select the type of related entities you want to see.
   
   
   
5. Use this dialog box to qualify the entities you selected in the previous step.
   
   
6. Click Search to perform the search. When processing is complete, do one of the following:

• • If Run in batch and produce report files was not selected, click OK on the Search Progress dialog box to view the results in the Entities view.

  • If Run in batch and produce report files was selected, close the Command Prompt window and open the text files, located in the output location entered in the Search Relationships wizard, to view the results.

Using the Advanced Search dialog box

Using the Advanced Search dialog box contains a multi-line text box you can use to enter multiple sets of search criteria.

1. From the Search menu, select Advanced Search.
2. Click Add Criteria to open the Search dialog box. Complete the dialog box according to the instructions above.
3. When you have entered all of the search criteria, click Search.

 View the results of the search

The Entities view shows a tree view of the entities resulting from a search.

To view the results of the search

By default, the tree is collapsed to show only the entity types that match the search criteria and the number of entities of each entity type found by the search. Each time you expand the tree, it shows another level of entities that are related to the entities found in the search.

If your search doesn't return the results you expected, you may want to contact your Metadata Analyzer administrator to verify that the entities you are searching for have been collected.

To filter the Entities view

To refresh the Entities view to show only the entities that match a given name, filter the Entities view.

1. Select the folder you want to filter.
2. From the Tools menu or by right-clicking the folder, select Filter Entities.
3. Enter the filter you want to use, including wildcards in any position of the name, or select from the drop-down list, and click OK.

The Entities view refreshes to show only the entities that match the name you entered.

View the properties of entities

The Properties view can help you determine whether you have located the entities you are looking for. When you select an entity in the Entities view, the Properties view populates with attributes describing the entity.

The Entity tab shows the properties of one entity at a time.

The Entity List tab shows the properties of multiple entities.

Additional functionality

To help identify the impact of any code change

1. Select the entity or entities you want to perform impact analysis on. If you select one entity, the results will display in the Impact Analyzer window. If you select more than one entity, impact analysis is run in batch mode and the results are saved to multiple text files.

   Note

   To run impact analysis in batch mode, all entities selected in the Entities view must be of the same type.

2. Do one of the following:
   • From the Tools menu, select Impact Analysis.
   • Click .
   • Right-click the entity and select Impact Analysis from the shortcut menu.
3. Select the entity types to include in the impact analysis.

The Impact Analysis Progress dialog box (when only one entity is selected for impact analysis) or a Command Prompt window (when more than one entity is selected) appears and provides messages as the impact analysis progresses. When the impact analysis processing is complete, click OK.

• If only one entity was selected for impact analysis, the Impact Analyzer window shows the results.
• If more than one entity was selected, view the results in the text files in the output location entered in the Select Target Types dialog box.

Impact entities information includes the information about the entities that might impact or be impacted by the entity you performed impact analysis on. Dead ends information displays information about the entities that are considered obstacles or "dead ends" in trying to determine the impact entities. If any dead ends exist, try to remedy them , then perform impact analysis again. In the Impact Entities view (only available when a single entity was chosen for impact analysis), if you selected more than one target type to do impact analysis on— for example, data items and jobs— use the Target Type drop-down list to view impact or dead ends information for each target type included in your impact analysis. The figure below shows the Impact Analyzer window; the same information is provided in the text files when batch processing is selected.

1. To see how an entity might be affected, look at the path between the entities. Select the entity, then do one of the following:
   • From the Tools menu, select Impact Path.
   • Click .

To build a structure chart that gives a graphical view of an entity's relationships

1. Select the entity in the Entities or Relationships view.
2. Do one of the following:
3. 
   
   • From the Tools menu, select Structure Chart.
   • Click .
   • Right-click and select Structure Chart.
4. Select the direction you want to chart.
5. Select in the Filter Structure Chart dialog box the entity types you want to include in the structure chart. By default, all types applicable to the selected entity are included—except data items. Data items are excluded by default because there are typically a large number of them. Including data items may result in a very large chart.

Program Analyzer

Views

Outline view

The left side of the Outline view lists the program’s divisions, sections, and procedures. The right side includes the source code.

Structure chart view

The Structure Chart view makes your COBOL program easier to understand by breaking it into procedures.

Control flow view

The Control Flow view allows you to analyze the flow of control within the procedures that make up your program.

Metrics and diagnostics

Program-level metrics

The easiest way to get metrics and diagnostics information is to run portfolio metrics reports. Portfolio metrics can give you a report of all of the following metrics and diagnostics information for multiple programs at one time:

• Procedure-level metrics
• Diagnostic information

If you want to get metrics and diagnostics information for a single program, follow the instructions for the Procedure-Level metrics, Program-Level metrics, and Diagnostics.

1. From the Start menu, select Programs>Compuware>DevEnterprise>Portfolio Metrics.
2. Specify the directories that contain the programs you want included in the portfolio metrics. All files in the specified directories will be included in the analysis.
3. Click Next and specify the directories that contain the copybooks and includes you want included in the portfolio metrics. All files in the specified directories will be included in the analysis. Copybooks must be downloaded to your machine to be included in portfolio metrics reporting.

4. Click Next and do the following:

   • Select the reports you want generate

   • Indicate the directory location where you want the reports to be store

   • Select the delimiter to be used for the report

   • Select one radio button under Run Options:
     • Run Immediately
     • Save as a batch file to run later

5. Click Finish.

   • If you selected Run Immediately, a command prompt opens runs the portfolio metrics reports.

   • If you selected Save as a batch file to run later, the Save As dialog box appears so you can name the .BAT file. This file can be run later or set up to run as a scheduled task.

Procedure-Level Metrics

The Procedure-Level Metrics gives a compilation of metric scores for each procedure in your program.

View>Metrics>Procedure-level Metrics

Program-Level Metrics view

The Program Metrics view gives program-wide metrics, computed for your program as a whole.

View>Metrics>Program-Level Metrics

Diagnostics view

The Diagnostics view displays E-level, S-level, and W-level syntax errors, code flaws, and other errors detected during analysis.

View>Diagnostics

1. To correct syntax errors or code flaws, double-click the error. The corresponding line highlights in the program.

1. Make any needed changes to the program.
2. Re-analyze the program to check your corrections.