Using the Plug-In for Eclipse › Check Out Files

Check Out Files

When you add files to your workspace, all files are checked out for browse in read-only mode or checked out for update in read/write mode. When you modify a file, CA Harvest SCM automatically checks out the file according to the check-out process specified in your context. If concurrent update is enabled ,the files are checked out to a branch; otherwise, they are checked out to a trunk.

Update Mode

Reserves the version on the trunk, thereby preventing other users from reserving the same resource.

Concurrent Update Mode

Reserves the version on the branch, allowing other users to work on the same resource concurrently.

When checking out files, the exact version is determined by the contents of your context package. If there is an open branch for that item in the context package, a branch version is checked out to continue the existing branch. If there is no open branch, the latest trunk version is checked out.

Important! If a file is renamed or moved in a CA Harvest SCM-managed project, then Team, Check Out is disabled for the file. If you want to check out a renamed or moved file, use the Replace With, Version in Repository action, and then check out on the version.

To check out a file

1. Right-click the file and select Team, Check Out.

   If a later version of the file exists, the Later Version Exists dialog appears.

2. Click OK to use the latest version.
3. Select whether to use the latest workspace or repository version, and click OK.

   If you select the Set preference to always Check Out latest version option in the Later Version Exists dialog, these prompts will not appear for subsequent check-out operations.

   The file is checked out.

Note: If you clear the Checkout files while refactoring option, refactor operations that cause changes to files will automatically make the affected files writable and mark the files as offline-edited. The affected files will be decorated with the “+” icon, indicating that changes were made. Subsequent synchronize operations will detect these files as offline changes and permit you to check out and release the changes.

Additionally, you can create a package if the Create Package process's initial state is the current check-out state. The Create Package process's initial state is defined in the CA Harvest SCM Administrator.

You can perform a recursive check-out by selecting an Eclipse project or folder. All files under this selection are checked out.