IBM Compiled Code Coverage is an extension for Visual Studio Code that provides access to compiled code coverage results produced by IBM debug engines.
Simplify your installation experience by using newly bundled extension packs that contain IBM Compiled Code Coverage as well as other extensions available for IDzEE and ADFz customers.
Prerequisite One of the following for code coverage collection:
IBM z/OS Debugger Remote Debug Service: for collecting code coverage for compiled applications running on z/OS and having IBM Compiled Code Coverage automatically add connections and open results
IBM z/OS Debugger Headless Code Coverage: for collecting code coverage results and running Code Coverage Service via z/OS Unix commands.
IBM z/OS Debugger Headless Code Coverage Started Task: for collecting code coverage results and running Code Coverage Service using a started task
NOTE: IBM z/OS Debugger PTF 17.0.3.2 level or higher is required. For more information on service see Fix list for IBM z/OS Debugger.
Running Code Coverage Service and Collecting Code Coverage on z/OS
In order to collect code coverage on z/OS you have one of three options:
Using Remote Debug Service:
Start Remote Debug Service with code coverage, and in particular Code Coverage Service options enabled.
In Z Open Debug, create a connection to the RDS instance.
Use a debug profile in Z Open Debug activated in code coverage mode, or alternately instrument your JCL with code coverage options with RDS in the TEST runtime option. For example TEST(,,,RDS&userid:*)
Launch your application in the normal way.
Your code coverage result will automatically be opened in VS Code when ready.
Using Headless Code Coverage on z/OS UNIX:
Start the headless collector via z/OS UNIX, and ensure that you specify appropriate Code Coverage Service options. Note the collector port, along with the code coverage service port. The code coverage service port will be needed to create a connection to access your results.
Use a debug profile in Z Open Debug activated in code coverage mode, or alternately instrument your JCL with code coverage options with RDS in the TEST runtime option. Ensure that the profile has the right IP location and port option to connect to your headless code coverage instance. Alternately instrument your JCL with code coverage options with RDS in the TEST runtime option. For example TEST(,,,TCPIP%localhost:*)
Launch your application in the normal way.
Using Headless Code Coverage as a started task:
Obtain the code coverage collector and Code Coverage Service ports. The code coverage service port will be needed to create a connection to access your results.
Use a debug profile in Z Open Debug activated in code coverage mode, or alternately instrument your JCL with code coverage options with RDS in the TEST runtime option. Ensure that the profile has the right IP location and port option to connect to your headless code coverage instance. Alternately instrument your JCL with code coverage options with RDS in the TEST runtime option. For example TEST(,,,TCPIP%localhost:*)
Launch your application in the normal way.
Viewing Results
To view results:
You will need to add a connection to a Code Coverage Service instance by providing the URL for the CCS instance. Note: on IBM Z, when using Remote Debug Service and Z Open Debug, this is not required.
After providing credentials, a list of your results appear.
Use the context menu to select the View Report action and open the report.
