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

Parameters

Argument Description

Configuration XML file

The XML file that specifies the CQConverter configuration parameters.

Option Description

/c[ommand]:Analyze

Analyze ClearQuest database.

/m[igrationsettings]:

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

Remarks

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

Note

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

Example

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

See Also

Tasks

Walkthrough: Migrating ClearQuest Work Items to Team Foundation