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.
cahscm140
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.
 
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.