Synchronize Reference Directories

The Reference Directory Synchronization Utility (RDSU) lets you keep directories up-to-date in a reliable and efficient manner. This utility uses the hrefresh and hsync command-line utilities to populate (synchronize) reference directories with appropriate versions of items from project views.
cahscm101
The
CA Harvest SCM
Reference Directory Synchronization Utility (RDSU) lets you keep directories up-to-date in a reliable and efficient manner. This utility uses the hrefresh and hsync command-line utilities to populate (synchronize) reference directories with appropriate versions of items from project views.
RDSU lets you do the following:
  • Minimize disk space requirements for read-only source code directories with the active view approach.
  • Manage reference directories on multiple operating systems.
  • Allow development teams in different geographical locations to have a synchronized copy of the shared source code managed through the RDSU reference directories. This synchronization is useful for common libraries and reusable code.
For more information about the command-line utility syntax for hsync and hrefresh, see SDK Reference.
 
Terminology
The following terms will help you understand RDSU:
  • active item
    An
    active item
    is a
    CA Harvest SCM
    item that has a version in a package located in a state that shares the working view with the specified state.
  • active reference directory
    An
    active reference directory
    contains the latest version of active items in a particular
    CA Harvest SCM
    view.
  • active view approach
    An
    active view approach
    manages the synchronization of the source versions based on package promotion and demotion. Your inventory is active items only.
  • browse mode
    Browse mode
    checks out items to the destination directory but does not reserve the items and does not allow you to check the files back in. The read-only attribute is set on files checked out in browse mode.
  • full reference directory
    A
    full reference directory
    contains the latest version of all items in a particular
    CA Harvest SCM
    view.
  • full view approach
    A
    full view approach
    manages the synchronization of the source versions based on the latest versions of all items in a particular working view, or all versions in a snapshot view.
  • reference computer
    A
    reference computer
    is usually a remote computer hosting one or more reference directories.
  • reference definition
    A
    reference definition
    is a record (line) in an hrefresh configuration file that establishes a relationship between a
    CA Harvest SCM
    context (project and state) and a reference directory (host and client path).
  • reference directory
    A
    reference directory
    is a file system directory (UNIX directory, Windows folder, or MVS library). It is populated with files from the
    CA Harvest SCM
    configuration management system.