IBM Support

CCRC supports the UCM integration with ClearQuest

Question & Answer


Question

What functionality is available and what limitations exist when using IBM® Rational® ClearCase® Remote Client (CCRC) to access a UCM project that has IBM Rational ClearQuest® enabled?

Answer



ClearCase Remote Client supports the ClearCase ClearQuest with UCM integration.

To enable the ClearQuest UCM integration with CCRC, the native ClearQuest 2003.06.14 or later client software must be installed on the same host as the ClearCase Web Server.

CCRC uses the SQUID integration on the ClearCase Web Server when performing ClearQuest-enabled operations. There is no requirement to have any ClearQuest software installed on the client desktops where CCRC is installed. However, some client-side operations will require access to ClearQuest native client, which ClearQuest Web will be sufficient.

There are some restrictions to the usage model of the initial CCRC release.
Below is a summary of the features and restrictions along with information on how to configure CCRC for use.

You can use any ClearQuest client you prefer, but performance may be a hindrance when working on a native ClearQuest client over a wide area network (WAN). The recommended ClearQuest client for working over a WAN environment is the ClearQuest Web client.

Note: If you are working within a local area network (LAN), then a better choice is to use your native ClearQuest or Eclipse ClearQuest client, if you have it installed. Otherwise, ClearQuest Web will suffice for any operations that cannot be performed from CCRC.


The main feature points for using CCRC with ClearCase ClearQuest UCM projects are:

  • In ClearCase versions prior to 7.1.0.0: When using UCM, operating in the context of a ClearQuest-enabled UCM project, you must create all UCM activities from your preferred ClearQuest client. However, when you are working in a non-ClearQuest-enabled UCM project, you will be able to create new activities from within CCRC.

  • You will be able to select a ClearQuest activity on checkout based on the standard ClearQuest UCM query, but will not be able to run any arbitrary ClearQuest query to select an activity. However, it is possible to customize the default query, UCMCustomQuery1, that is used by CCRC.


  • CCRC actions will fail on ClearQuest-enabled UCM projects if the actions cause state transitions for which there are mandatory fields:

    Examples:
    1. Doing a checkout to start work on a “submitted” activity thereby causing a transition to the Opened state, and there are mandatory fields which require information.
    2. A state transition caused by the Perform ClearQuest Action After Deliver action.
    3. A workon transition won't work from a Web client and must be performed from a thick client.



    WORKAROUNDS:
    1. Modify the schema to automatically set the values for these mandatory fields, or
    2. Manually transition the activity from the user's ClearQuest client, or
    3. Customize the UCMCustomQuery1 to only display activities that are in the correct state and, therefore, will not require any state transition.

    Refer to the IBM Rational ClearCase Product Family Release Notes for complete details on using ClearCase ClearQuest with UCM integration from CCRC.

    Note: Attempts to use CCRC with a non-UCM (or Base) ClearCase ClearQuest integration, errors will be reported for any ClearCase operations on VOBs that have been enabled with the integration. For more details, see technote 1194079.

    [{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;2003.06.16;7.0;7.0.0.1;7.0.0.2;7.0.0.3;7.0.0.4;7.0.0.5;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;7.0.1.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client (CCRC)","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

    Document Information

    Modified date:
    16 June 2018

    UID

    swg21221366