This documentation is archived and is not being maintained.

Analyze Command (CQConverter)

Use the analyze command of the CQConverter command-line tool to analyze ClearQuest databases for migration to Team Foundation Server.

Required Permissions

To use the CQConverter tool, you must be a member of the Service Accounts security group. For more information, see Team Foundation Server Permissions. Also, you must have the Super User permission for the ClearQuest database. For more information, see the ClearQuest Administrator's Guide.

CQConverter /c[ommand]:Analyze /m[igrationsettings]:Configuration XML file


Argument Description

Configuration XML file

The XML file that specifies the CQConverter configuration parameters.

Option Description


Analyze ClearQuest database.


Specifies the configuration XML file that is used for analyzing the ClearQuest database. For example, cqconverterconfig.xml.

The CQConverter analysis parameters are specified in the configuration XML file. Specify this file at the command line using the command-line option /m: or /migrationsettings: as the expanded form. For example: /m:cqconverterconfig.xml


When CQConverter connects to ClearQuest the converter prompts you for a password. The converter connects to Team Foundation using the log on credentials.

In this example, the converter performs an analysis that uses the configuration parameters that are defined in the cqconverterconfig.xml file.

      >CQConverter /c:analyze /m:cqconverterconfig.xml