Generating code coverage in a remote debug session
With Concurrent Debug and Code Coverage, you can run code coverage collection in parallel with the active debug session. When this feature is enabled, code coverage data is collected during the debug run, and code coverage annotations are displayed and updated in the debug editor. You can turn code coverage collection on or off at any time during your debug session. The final code coverage result only includes coverage information for the source regions where code coverage collection is turned on.
About this task
Notes:
- This feature is supported only in the Debug Tool compatibility mode.
- 64-bit applications are not supported.
- ZUnit is not supported.
- Concurrent Debug and Code Coverage requires z/OS Debugger 15.0.1 or later, with PTF UI74257 applied.
Concurrent Debug and Code Coverage supports the following languages:
- Enterprise COBOL for z/OS, Version 4, Version 5, and Version 6
- Enterprise PL/I for z/OS Version 4 and Version 5
- C/C++ feature of z/OS Version 1 and Version 2
- IBM High Level Assembler (HLASM), Version 1 Release 4, Version 1 Release 5, and Version 1 Release 6
Procedure
By default, Concurrent Debug and Code Coverage is disabled. You can enable it at the beginning or in the middle of a debug session.
-
Select the debug target, and click the Start Code Coverage icon
in the Debug view toolbar, main toolbar,
or the context menu in the Debug view. The Set Code Coverage Parameters window is displayed. This window occurs only when you start code coverage collection for the first time for each debug session.
- In the Set Code Coverage Parameters window, specify the
Test ID and Tags parameters, or accept the default
value for Test ID. The default value for Test ID is
the program name appended by a datetime stamp. Then click OK to close the
window. The first time you start Concurrent Debug and Code Coverage for a debug session, all executable lines of the current debug source are marked as uncovered in the editor. You can drive your debug session by using regular debug actions. The code coverage annotations are updated after each debug action.
- To stop code coverage collection for this debug target, run to a certain location or
suspend the session, and click the Stop Code Coverage icon
in the Debug view toolbar, main toolbar,
or the context menu in the Debug view. The code coverage annotations are still displayed, but are not updated with the debug actions until you start code coverage collection again. - Run the debug session to completion or terminate the debug session. A line-level code coverage result is added in the Code Coverage Results view and a report is opened in the editor area.
- If the debug session is terminated, the code coverage result includes coverage statistics only up to the termination location.
- If the debug session runs to completion, the code coverage result includes statistics from all source regions where code coverage collection is turned on.
