In this section:
Jtest DTP Engine is launched by running
jtestcli.exe located in the Jtest installation directory. In the typical workflow, the executable is run from the dedicated plug-ins for the supported build systems, such as Maven,Ant and Gradle, but it can also be run manually the from the command line.
jtestcli.exe runs on
jtest.data.json data files that are automatically generated by the build system plug-ins. If you run
jtestcli.exe from the command line, use the
-data option to point to the
.json data file that will be used for analysis.
Using Build System Plug-ins
jtestcli.exe is launched from a dedicated Jtest plug-in for Maven, Ant or Gradle. For details, including plugin configuration and troubleshooting, see the Jtest Plugins manual (plugins-manual.html) for build systems is located in the [INSTALL_DIR]/manuals directory.
Add the $XTEST_ITX=714 environment variable to show arguments passed to jtestcli.exe executed by plug-ins.
jtestcli from the Command Line
jtestcli.exe from the command line to launch Jtest DTP Engine. You must at the minimum include a test configuration and specify the data file location to analyze code. See Configuring Test Configurations and Specifying Test Data Location for more information.
Your command line may resemble the following:
Specifying Test Data Location
-data switch to point directly to a
*.json data file object generated by the build system plugin. The automatically-generated
*.json data file provides the same information as the workspace in a format specific to Jtest DTP Engine:
Build system plug-ins automatically add the data argument and include the value they generate, so there is no need to add it to the plug-in configuration.
Settings Property Pattern
The path to the data file can be configured with the
jtest.data option in the .properties file:
Data File Format
The data file (
jtest.data.json) is a stream of json objects automatically generated and formatted by Jtest build system plug-ins. It provides the same information about tested projects as the workspace. Each object in the file describes one project. Jtest currently supports the classpath_project common object type. See Configuring the Test Scope for an example.
Example Data File Object
Displaying Detailed Progress Information
-showdetails switch to display detailed progress information:
Alternatively, you can configure showing detailed information by setting the
console.verbosity option to
Ant and Maven Pattern
If you use Ant or Maven, use the following pattern:
About Error Codes
Jtest returns error exit codes (other than 0) when the following occurs:
- Jtest is executed without a license.
- A test process exits with an internal exception.
- Command-line is malformed or refers to a resource that does not exist. See Configuring the Test Scope.
You can also use the
-fail option to generate an exit code when the analysis reports static analysis findings.