Kwqacimport
kwqacimport is a tool that you can use to convert a Perforce QAC project into valid Klocwork tables, which you can import into the Validate 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 Perforce 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 Perforce QAC installation. Unless the installation directory is specified by a switch, the common\bin subdirectory of the Perforce 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 a 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 COMPONENT.####. For example:
- Diagnostic qacpp-4.7.0-4043 is reported as Klocwork defect QACPP.4043
- Diagnostic rcma-2.3.0-1505 is reported as Klocwork defect RCMA.1505
- Diagnostic qac-9.9.0-2017 is reported as Klocwork defect QAC.2017
All the subdiagnostics are converted into trace messages within their parent defects.