Using Check-In and Check-Out › Check-Out Process › Check Out Versions

Check Out Versions

The check-out process dialog lets you copy versions of items under CA Harvest SCM management to external directories.

Follow these steps:

1. Navigate the Workbench to the package you want to use to check out versions.
2. Right-click the package, and select check-out process from the shortcut menu.

   The check-out process dialog appears.

   Note: The lowercase italic text indicates the process dialog name by the process type, since the process execution dialog names differ to each site.

3. Select a Mode option:

   Update

   Copies selected versions to the destination client directory and creates a reserved version on each item's trunk, letting you check in the corresponding files. The permission on a read-only file is changed to normal (write access) when you use this mode of check-out.

   Browse

   Copies the items to the destination directory but does not let you check in the files. The read-only attribute is set on files that are checked out for browse mode.

   Synchronize

   Identifies the versions of the files in the client file system by using the signature file. Versions are checked out only if the signature file shows:

   • Client files that differ from their corresponding CA Harvest SCM versions.
   • Client files with timestamps that differ from their corresponding timestamps in the signature file.

   Items are checked out in a read-only mode.

   Note: The check-out for synchronize mode is useful in the build process. This option compares the version on the file system with the version in the database. If the database version contains a newer timestamp, the file is checked out.

   Concurrent Update

   Copies selected versions to the destination client directory and creates a reserved version on a branch for each item. All updates accumulate on this branch. The permission on a read-only file is changed to normal (write access) when you use this mode of check-out.

   Reserve Only

   Creates a reserved version with a reserved tag (R) on each item's trunk. You can check in corresponding files, but cannot move any data to external directories.

4. Select an option to specify the way for checking out items to client paths:

   Preserve View Path and Structure

   Checks out all selected items to corresponding client directories, if they exist. If the directories do not exist, an error message displays and the items are not checked out.

   Note: If you select a single file for check-out, the checkout is successful; in spite of the path not matching with the new view path.

   Preserve and Create Directory Structure

   Checks out all selected items to corresponding client directories and creates any client directories that do not currently exist.

   All Files to the Same Client Directory

   Places all selected items directly beneath the specified client directory, ignoring the path structure in the repository.

   Note: The options work with the Include subfolders option on the Find Version dialog.

5. Specify a view path in the repository from which items are checked out in the From field.
6. Specify the destination on the file system for the checked-out files in the To field.
   • If either of the preserve structure check-out options is selected, the check-out specifies a path and this specification is appended to the file system directory.
   • If the files being checked out include a directory specification, as in a recursive check-out, this directory specification is appended to the client path specified.

   Agent

   Displays the remote computer name if the client path is on a remote computer.

   Add Remote Agent Connection

   Lets you add the new remote agent connection whose values populate in the Agent name and To fields.

   For more information about adding a remote agent connection, see the Connect to a Remote Agent section.

   Note: When you connect to multiple agents on the same computer and check-out from the Workbench, CA Harvest SCM identifies the agent with a unique combination of agent name, port number, and the initial directory. This selection auto populates the To field with the initial directory of the agent computer.

7. Select versions to check out:

   Snapshot

   Specifies a snapshot from which you can select versions to check out. This field is enabled when a snapshot exists in the view in which you are executing the check-out process.

   Note: You can select versions from the snapshot and can return them to the check-out process execution dialog.

   Versions

   Lists the versions that you have selected for check-out. If you have selected a version before selecting the check-out process, the version appears in the list. If you have not selected a version before invoking the check-out process, you can add more than one version by clicking the Select Version.

8. (Optional) Select check-out options:

   Replace read-only files

   Controls whether the checked-out files must replace existing read-only files on the file system.

   Recursive

   Selects all versions in the selected folders and subfolders in the Versions list. The versions in the subfolders are checked out only if you select this option.

   Note: This check box is disabled if no folders are selected.

   Create empty directories

   Creates directories that contain no items during a recursive check-out. This option works with the Include subfolders option in the Find Version dialog.

   Include versions from package

   Selects the latest versions from the trunk and branch that are associated with the package context.

9. (Optional) Click Note to view information about the process.
10. Click OK.

    The versions are checked out.