Previous Topic: Active View ApproachNext Topic: Check-Out Version Selection


hsync Item Selection Options

The hsync command creates an inventory of items and paths based on criteria specified by an item selection option. The item selection options are as follows:

All Items in View

Selects all items and paths under a given view path. You can use this option to initialize or refresh a reference directory at any time. Use this option in a stand-alone UDP or script.

Item List

Selects items and paths with names in the item list. Use this option after a CA Harvest SCM process uses a specific set of items.

Package List

Selects the items and paths in packages with names in the package list. The packages do not need to be located in the state where hsync is executed. Use this option after a CA Harvest SCM process uses specific set of packages.

All Packages in State

Selects items and paths in packages that are located in the state where hsync is executing. Use this option as an efficient alternative to the package list when the set of packages is large and all the packages are in the given state.

All Packages in View

Selects items and paths in packages that are located in any state that shares a view with the packages' current state. This option is an alternative to use when the packages are in states that share a view.

Item selection searches are always recursive and start at a given item path.

Renaming an item or item path creates a version of the same item or item path. The inventory includes the names and paths of all versions of the selected items. Therefore, if an item has been renamed in the current project, both the old and the new item name are in the inventory. If an item has been moved in the current project, both the old and the new path of the item are in the inventory.

To the item list will be added items that are not covered by the item selection option, but have a version with the same name and path as an item that is already in the inventory.