Configuring code coverage preferences

You can use the Code Coverage preference page to configure code coverage preferences.

About this task

Your administrator might have set default code coverage preferences for your TPF Toolkit. In that case, if you open the Code Coverage preference page, the page is completed with default values. You can change the default values to suit your needs.

Procedure

  1. Click Window > Preferences > TPF Toolkit > TPF Code Coverage to open the Code Coverage preference page for TPF Toolkit.
  2. Specify the code coverage preferences on this page:
    Preference options Description
    Output directory for code coverage results

    Specifies the path on the internal host where code coverage results are stored. Click Browse to select the path.

    Notes:
    • To enable the web application to save the output file, you must grant write permission for the output directory to the user ID that will start the web application. Contact your administrator for help.
    • To have the permission to remove files from the output directory, the group bit must be set when the output directory is created on the Linux® system, for example:
      chmod 775 /home/user123/myCodeCovDir
chmod g+s /home/user123/myCodeCovDir
user123@linuxtpf:/home/user123/myCodeCovDir> ls -ld ./
drwxrwsr-x 2 user123 users 4096 May 28 13:21 ./
user123@linuxtpf:/home/user123/myCodeCovDir> ls -l
total 292
-rwxrwxr-- 1 tomcat users 140076 May 13 14:26 RESTCCV20210513142316.cczip

      Contact your administrator for help.
    Include source Toggles whether to include source files in code coverage results.
    Keep temporary files for troubleshooting Toggles whether to keep temporary files for troubleshooting.
    Format of code coverage results Sets one of the following formats for the code coverage results that will be generated in the output directory:
    • IBM
    • SonarQube
    • Cobertura

    If you want to generate code coverage results in SonarQube format, you must also apply support for code coverage results in SonarQube format to your z/TPF system. For more information, see Code coverage results in SonarQube format (APAR PJ45949).

    To view the results in IBM® format, use the Code Coverage Results view, which appears by default in the TPF Code Coverage perspective in TPF Toolkit.

    To view the results in SonarQube or Cobertura format, use a SonarQube instance that supports the language of your z/TPF system application.
    At a minimum, you must complete the Output directory for code coverage results field.
  3. Click OK to save your changes.