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 Code | Meaning |
---|---|
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. |
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.