Checking Out an Element

You must check out a file before you can modify it. You can check out an entire project or one or more files at a time.

If you modify an element without checking it out of a snapshot view, for example, you edit a file from the file system, this version of the file is hijacked. The hijacked file appears under Details of <scriptname> with the warning symbol (warning symbol) next to it. You can convert the hijacked files to check them out and work on the file when you check out an element.

To view detailed information about a script's supporting files, set the Rational Functional Tester ClearCase Preferences to display script details.

If you use ClearCase Multisite and want to modify or create a test asset, you must request mastership when you check out or check in a test asset. When you check out or check in a test asset, and you are using ClearCase multisite, Functional Tester displays the Request Mastership check box in the appropriate dialog box if a test element is not mastered locally.

Eclipse compiles projects when an element changes. If you are using a dynamic view, automatic compilation, might be time-consuming depending on the size of the project. To disable the Eclipse compile feature click Window > Preferences, and then clear the Build automatically check box.

To check out an element:

  1. From the Functional Tester Projects view, right-click one or more elements.

  1. From the shortcut menu, click Team > Check Out.

  2. In the Check Out column, clear the check box of any element you do not want to check out.

    If you see the not ready symbol (not ready symbol) in the State column, you cannot check out an element. When you select the element, you see an explanation of the problem.

  3. If an element is hijacked, under Some of the files in selection have been hijacked, take one of the following steps:

  1. If you use ClearCase in a Multisite situation and if one or more of the files associated with the selected scripts, shared maps, shared datapools, or Java files does not have mastership locally, click Request Mastership to request mastership of the file. For more information, see About Requesting Mastership.

  2. Select Reserved for a reserved checkout. Clear this check box to check out the element as unreserved.

    A reserved checkout gives you the exclusive right to check in the element when you are finished. With an unreserved checkout, you might be required to merge your changes at checkin, if someone else checked in the same element before you did.

  1. Click Finish.

Related Topics:

About Software Configuration Management

Check Out Dialog Box

Using ClearCase with Test Object Maps

About Requesting Mastership

Terms of use | Feedback
(C) Copyright IBM Corporation 2002, 2004. All Rights Reserved.