Viewing the Code Coverage Information

Code coverage statistics

After executing an application with code coverage, the IDE automatically opens the Micro Focus Code Coverage window to display the code coverage information. If the window is not visible, to display it click View > Micro Focus Code Coverage.

The window visualizes the code coverage information from the latest run with code coverage stored as a Results_datetime.tcz file. It shows the paragraphs and the sections within the program and what percentage of the code has been covered or not:

Covered and missed blocks

To view the covered and missed blocks, either scroll down the code of a COBOL program or double-click the lines of the program's structure in the Micro Focus Code Coverage window:

You can specify your color preferences for the colorization of covered and missed blocks as follows:

1. In the IDE, click Tools > Options > Environment > Fonts and Colors.
2. Specify your preferences for the following items in the Display items list - COBOL Code Coverage - Covered and COBOL Code Coverage - Not Covered.
3. Click OK.

Editing the code after producing coverage results

The information displayed in the Micro Focus Code Coverage window and the colorization of the editor reflect the state of the application at the time it was executed to produce that specific coverage results file. If you then make a change in the code and compile it, this might move the code in the editor. As a result, the colorization in the editor might not accurately match the information displayed in the Micro Focus Code Coverage window. The data displayed in the Micro Focus Code Coverage window will still reflect the historical state of the program when the data was generated.

Other situations where the colorization in the editor might not accurately represent the information in the code coverage view include:

• The results from running with code coverage are accumulated in a single results file (specified in Tools > Options > Micro Focus > Code Coverage > Results Options).
• When loading a merged results file that includes the data from different runs with code coverage.
• When loading a results file from running the application with code coverage before you changed the code.

Viewing previous code coverage results

Visual COBOL keeps the history of the previous results of running the application with code coverage. To load the results from previous runs with code coverage, click immediately next to the field showing the current results file and select an item from the list.

Exporting code coverage information

To export the code coverage information and save it as a .tcz results file:

1. Click , (Export coverage), in the Micro Focus Code Coverage window.
2. Specify a name and location for the coverage file, then click Save.

Importing existing code coverage results

To import the code coverage information from an existing .tcz results file:

1. Click (Import coverage), in the Micro Focus Code Coverage window.
2. Browse to and select an existing code coverage report .tcz file, then click OK.

   This imports the code coverage statistics from the .tcz file into the Micro Focus Code Coverage window and adds colorization to your source files indicating the missed and the covered blocks.

Merging the code coverage results from different runs

You can merge the results file from different executions with code coverage. This provides combined statistics of running the application in different scenarios. To merge the results:

1. Click , (Merge results), in the Micro Focus Code Coverage window.
2. In the Merge Results dialog box, check the results files you want to merge, then click OK.

   This creates a MergedCoverageFile_datetime.tcz results file and loads the information in it in the Micro Focus Code Coverage window.

Toggling the code coverage colorization on or off

To toggle the code coverage colorization on or off in the editor, click (Show code coverage coloring) in the Micro Focus Code Coverage window.

Showing unexecuted programs

To show the unexecuted programs, click (Show unexecuted program information) in the Micro Focus Code Coverage window.

Generating an HTML report

To view the code coverage index report file, TCIndex.htm, click (Generate code coverage HTML report) in the Micro Focus Code Coverage window.

Deleting code coverage results

To delete the Results_datetime.tcz that is currently loaded in the Micro Focus Code Coverage window, click (Remove). This unloads the file from the IDE and deletes it from disk. To delete all results files, click (Remove all).