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.
A typical command to run the conversion is as follows:
kwqacimport -o <target-tables-directory> -D <QAC-project-directory>
- <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.
|--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)|
|0||Success – conversion operation ran successfully.|
|1||Bad arguments – unrecognized arguments or argument values have been supplied, or not all required arguments have been supplied.|
|2||Failure – an error has occurred during the conversion process that prevented kwqacimport from generating valid tables.|
|3||Possibly incomplete – the conversion operation has finished successfully, however, some problems have been encountered resulting in defects report that can possibly be incomplete.|
- 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.