Kwqacimport

kwqacimport is a tool that you can use to convert a Helix QAC project into valid Klocwork tables, which you can import into the Klocwork Portal.

General usage

A typical command to run the conversion is as follows:

kwqacimport -o <target-tables-directory> -D <QAC-project-directory> 

where:

  • <target-tables-directory> is the path to the tables directory that contains the project conversion results
  • <QAC-project-directory> is the path to the Helix QAC project you are converting.

The kwqacimport tool creates a new tables directory with a valid structure, containing the converted QAC diagnostic results as defect reports in it. The default behavior does not overwrite any existing tables directory. You can override this by specifying the --force command line switch.

In order to perform the conversion, kwqacimport also needs to use some tools from your Helix QAC installation. Unless the installation directory is specified by a switch, the common\bin subdirectory of the Helix QAC installation directory is assumed to be in your PATH environment variable.

Options

Name Short name Description
--help   Prints help message
--version   Prints version information
--license-host <host_name> -H specify the License Server host name
--license-port <port_number> -P specify the License Server port number
--tables-directory <dir> -o Specifies the output tables directory. This is a required option
--project-directory <dir> -D Specifies the QAC project directory being imported. This is a required option.
--qac-install-dir <dir> -i Specifies the QAC installation directory
--force -f Forces kwqacimport to overwrite the output tables directory (if it exists)

After execution, kwqacimport can have the following exit codes:

Exit CodeMeaning
0Success – conversion operation ran successfully.
1Bad arguments – unrecognized arguments or argument values have been supplied, or not all required arguments have been supplied.
2Failure – an error has occurred during the conversion process that prevented kwqacimport from generating valid tables.
3Possibly incomplete – the conversion operation has finished successfully, however, some problems have been encountered resulting in defects report that can possibly be incomplete.

A successfully run kwqacimport command produces tables directory that has QAC diagnostic reports converted to their corresponding Klocwork defects. For a QAC diagnostic #### in component COMPONENT, the generated Klocwork defect will have id HELIX-QAC.COMPONENT.####. For example:

  • Diagnostic qacpp-4.7.0-4043 is reported as Klocwork defect HELIX-QAC.QACPP.4043
  • Diagnostic rcma-2.3.0-1505 is reported as Klocwork defect HELIX-QAC.RCMA.1505
  • Diagnostic qac-9.9.0-2017 is reported as Klocwork defect HELIX-QAC.QAC.2017

All the subdiagnostics are converted into trace messages within their parent defects.