qacli cma

Configure CMA (Cross-Module Analysis) solutions.

Usage

cma  {-C <solution-name>|-M <solution-name>|-D <solution-name>|-L <solution-name>} [-P <directory>] [-K <config name>] [-a] [-r] [--] [-h]

Extended Description

Cross-Module Analysis can be performed on a single Perforce QAC project (see Single-Project CMA Analysis) or on several Perforce QAC projects (see Multi-Project CMA Solution Analysis). This command enables you to configure for Multi-Project CMA Analysis – also known as a CMA solution.

Many CMA solutions can be created with several Perforce QAC projects within them. You can also define which config to use in each Perforce QAC project.

Once created, the CMA solution can be specified with the qacli analyze and qacli view commands.

Options

Name, shorthand	Default	Description
`‑‑add‑project, ‑a`		Add a Perforce QAC project to an existing CMA solution.
`‑‑create, ‑C`		Create an empty CMA solution. It can subsequently be modified to add Perforce QAC projects using the 'add-project' option.
`‑‑config, ‑K`		For projects with multiple configurations, specify which configuration to use. If none specified, then the default will be used.
`‑‑delete, ‑D`		Delete a CMA solution. This does not delete any Perforce QAC projects that may be associated with it.
`‑‑help, ‑h`		Displays usage information and exits.
`‑‑ignore‑rest, ‑‑`		Ignores the rest of the labeled arguments following this flag.
`‑‑list, ‑L`		List the content of a CMA solution. Specify '*' to list all CMA solutions.
`‑‑modify, ‑M`		Modify the contents of a CMA solution. To be used with the `add-project` and `remove-project` options.
`‑‑qaf‑project, ‑P`	.	Specify a path to a valid Perforce QAC project.
`‑‑remove‑project, ‑r`		Remove a Perforce QAC project from an existing CMA solution.

The configuration data for CMA Solutions are stored within the UDL.

Examples

Create and Populate a CMA Solution

First, create the empty solution:

qacli cma --create FOO_SOLUTION

Then, populate it with Perforce QAC projects:

qacli cma --modify FOO_SOLUTION --qaf-project /home/trinity/foo_a --add-project
qacli cma --modify FOO_SOLUTION --qaf-project /home/trinity/foo_b  --config basic_config --add-project

This will add the foo_a project to the solution (it will use its default config associated with that Perforce QAC project). The subsequent command then adds the foo_b project to the solution, this time explicitly specifying the basic_config should be used.

This CMA solution can then be used for analysis, for example:

qacli analyze --file-based-analysis --cma-solution FOO_SOLUTION --qaf-project /home/trinity/foo_a

Displaying the Content of a Solution

The --list option can be used to list the content of a solution:

qacli cma --list FOO_SOLUTION

You can also list all solutions by using '*' as the solution name:

qacli cma --list '*'

Remove Projects and Solutions

To remove a Perforce QAC project from a solution, use the following:

qacli cma --modify FOO_SOLUTION --qaf-project /home/trinity/foo_a --remove-project

To remove an entire solution:

qacli cma --delete FOO_SOLUTION

This removes the solution, without affecting the underlying Perforce QAC projects.