Testing the ClearQuest Synchronizer

After you finish all configuration tasks, test the ClearQuest® Synchronizer by creating a record in the Rational® ClearQuest client and then running a query in the IBM® Engineering Workflow Management (EWM) client to see that a work item that corresponds to the record has been created.


  1. Click Start > All Programs > IBM Rational > IBM Rational ClearQuest > ClearQuest to start the ClearQuest client.
  2. Click File > Database > Connect and select the schema repository and user database that are configured to use the ClearQuest Synchronizer. Login as a user who has a corresponding Jazz™ user account and is a team member of the project area with which you are synchronizing.
  3. Click File > New and select the appropriate record type. Enter values in at least the mandatory fields. If you are using a field, such as the Project field, to map to the EWM Category property, enter a value in that field. Click OK.
  4. Open the EWM client. In the Team Artifacts view of the Work Items perspective, expand the project area and navigate to the Work Items > Shared Queries > Predefined folder. Double-click the Recently Created query to run it. The work item that corresponds to the ClearQuest record should be listed on the Work Items tab.
  5. Double-click the work item to open it. Verify that the properties contain the same values as the corresponding fields in the record.
  6. Change the value of a property, such as Priority. Click Save to save the change.
  7. In the ClearQuest client, run a query to retrieve the record. Open the record and confirm that the field contains the new value that you specified in the work item.

What to do next

When you make a change to a ClearQuest record or work item, that change is not immediately propagated to other repository. The length of the delay depends on the setting of the pollingPeriod parameter in the cqconnector.properties file and the fixedTaskDelay property for the outgoing synchronization task in the Jazz Team Server.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki