Use this dialog box to make a reserved or unreserved checkout of any resource that is under ClearCase control. A reserved checkout guarantees you the right to check in your modifications to the element as the successor version on the selected branch. If someone else has a reserved checkout on an element you want to modify, you can make an unreserved checkout, but you must merge your changes with changes made by the user who had the reserved checkout.
Checking out a resource that is not loaded implicitly creates a load rule for the resource and loads it into the view's copy area.
The following controls always appear in the dialog box:
| Control name | Control description |
|---|---|
| Show Details | Displays additional information and options. If you are using a UCM view, the UCM Activity settings also appear. |
| Hide Details | Conceals additional information and options. |
| Hijack Instead | Click to hijack the resource instead of checking it out. This option is only available when you begin to modify a file that is currently checked in to source control. |
| Include descendant artifacts of the selected directories | Click to mark all subdirectories and files below directories in the The selected resources list box for checkout. This option is active when the currently selected resource is a directory. |
| Checkout descendant artifacts only, do not checkout descendant directories | Click to mark only file elements below the current directory for checkout. This option is active when the Include descendant artifacts of the selected directories option is selected. |
| Include artifacts named | Click to apply a filter recursively to the files and directories in The selected resources list box. Only the files that meet the filter criteria appear in The selected resources list box. For example, if the filter criteria is *.java, only files with a .java file extension appear in The selected resources list box. |
| Exclude artifacts named | Click to apply a filter recursively to the files and directories in The selected resources list box. The files that meet this criteria are excluded from The selected resources list box. For example, if the filter criteria is *.txt, any files with a .txt file extension are removed from The selected resources list box. |
| Filter | Enter the criteria for a filter to include or exclude resources for checkout. |
| Apply Filter | Click to run the filter criteria against all resources in The selected resources list box. |
| The selected resources | Displays the artifact name, any associated comments,
and the directory path information of resources. If the resource is
a directory, you can click the plus sign (+) to the left of directory
to view any files or directories below your current location. The
check box next to a resource indicates whether the resource should
be checked out. To prevent the checkout of a resource, clear its associated
check box. If the resource is in a UCM view, the activity associated
with each resource also appears. Note: If you are using the Rational
ClearTeam Explorer UCM integration with Rational Team Concert, and
the For Task Provider integrations, display tasks instead
of activities in UCM views option on the ClearTeam
Explorer preference page is selected, Rational Team Concert
work items display in the Activity column.
|
| Check All | Click to select the check box for all elements in The selected resources list box and mark them for checkout. This option also applies to all files and subdirectories below any directories in the list box. |
| Check None | Click to clear the check box for all elements in The selected resources list box and prevent them from being checked out. This option also applies to all files and subdirectories below any directories in the list box. |
| Select All | Click to select all elements in The selected resources list box in order to apply a comment or activity to each element. This option also applies to all files and subdirectories below any directories in the list box. |
| Select None | Click to specify that no elements in The selected resources list box are selected. This option also applies to all files and subdirectories below any directories in the list box. |
| Select Activity | Displays the activity that is to be associated
with the checkout. Click to select another activity, or click New to
create a new activity, or click Find to select
an existing activity. This option only appears if you are using a
UCM view. Note: If you are using the Rational ClearTeam Explorer UCM
integration with Rational Team Concert, and the For Task
Provider integrations, display tasks instead of activities in UCM
views option on the ClearTeam Explorer preference
page is selected, Rational Team Concert work items display instead
of UCM activities.
|
| New | Click to generate a new UCM activity using the
Create New Activity dialog box. This option only appears if you are
using a UCM view. Note: If you are using the Rational ClearTeam Explorer
UCM integration with Rational Team Concert, clicking New invokes
the Create Work Item dialog box in Rational Team
Concert. When you click OK in the Create
Work Item dialog box, this action creates a new ClearTeam
Explorer UCM activity and associates it with the new Jazz Team Server
work item.
|
| Find | Click to specify an existing UCM activity in the Find
an activity dialog box. This option only appears if you
are using a UCM view. Note: If you are using the Rational ClearTeam
Explorer UCM integration with Rational Team Concert, clicking Find invokes
the Select Work Item dialog box in Rational Team
Concert. When you click OK in the Select
Work Item dialog box, this action associates the current
ClearTeam Explorer UCM activity with the selected Jazz Team Server
work item.
|
| Comment | Enter an optional comment (one that describes the reason for the checkout, for example.) |
| Reserved Checkout | Click this pull-down menu to specify a checkout status. A Reserved Checkout gives you the exclusive right to check in the element when you are finished. Click Prefer reserved, unreserved if necessary to attempt a reserved checkout, but to allow an unreserved checkout if the element is already checked out reserved in a different ClearCase view. If you select Unreserved Checkout, you may need to merge your changes at checkin time, if someone else checked in the same element before you did. |
| Preserve Time | When checking out a resource, select this option to specify that the time of last modification is preserved from the last time the resource was checked in to source control. When this option is not selected, the time of last modification is set to the current time when you check out the resource. |
| Current Activity after Checkout | Displays the activity that is to be in effect after
the checkout operation is complete. Click to specify a different activity.
This option only appears if you are using a UCM view. Note: If you
are using the Rational ClearTeam Explorer UCM integration with Rational
Team Concert, and the For Task Provider integrations, display
tasks instead of activities in UCM views option on the ClearTeam
Explorer preference page is selected, a Rational Team Concert
work item displays instead of a UCM activity.
|
| Request Branch Mastership | Click to request branch mastership if a checkout
operation fails because a branch is mastered remotely. Whenever a
reserved checkout operation fails due to mastership or an unreserved
checkout operation succeeds but the branch is remotely mastered, the
checkout fails and an information dialog box informs the user that
ClearCase mastership has been requested for the specific branches.
After mastership has been requested, the packets of information related
to the request must be imported from the server, either by automated
scripts or by a manual process. After the packets have been imported,
an information dialog box informs the user that mastership has been
granted for the specified branches. At that point, the user can successfully
perform the checkout operation. Note: You can specify that this option
is selected by default by setting the Request branch mastership
if necessary option on the IBM Rational ClearTeam
Explorer -> Dialogs -> Checkout preference page.
|
| Keep the hijack content | Click to checkout the hijacked version of a file instead of the latest version. This option is only active when you select a hijacked file for checkout. |
| OK | Confirms the operation and dismisses the window. |
| Cancel | Cancels the operation. |