Creating a Test Coverage Report

To create a report on PL/I test coverage data use the tcpli utility.

tcpli with no arguments lists the modules for which test coverage information is available in the current pli.tci file. Modules are identified by the name of the corresponding .stb debug information file.

tcpli myprog.stb will output a test coverage report for the myprog program or module. The report consists of a listing of the source file(s) for program myprog, with each line preceded by a count of the number of times code in that line has been executed. Lines that do not contain any executable code will be preceded by '---'. Example:

$ tcpli myprog.stb
Source file myprog.pli
--- foo: proc options(main);
--- dcl x fixed bin(31) init(0);
  1 display(x);
  1 do until (x = 10);
 10 x = x + 1;
 10 display(x);
 10 end;
  1 end;

Note: Use tcpli -help to see other supported options for the tcpli utility.

If the program contains %INCLUDE files, they will be included in the report listing only if they contain executable code.