update command

You can update a specified directory, project object, or project grouping. Update uses the baseline and tasks of project groupings to find candidates and selection rules to select appropriate versions of the members. You can also specify a project grouping to be updated.

The update process stops if an individual operation within the update fails. For example, if the current version of an object has a work area conflict, the process stops and the new version is not automatically used. Stopping the update protects the work area data.

The default setting to stop the update can be changed by modifying your initialization file. Some users might want to continue with the update process, even though an individual failure has occurred. You can set update to continue by configuring the reconf_stop_on_fail option to False.

Use project groupings to perform a multiphase build, where the set of projects in a project grouping is not updated all at the same time. In such a case, all the projects are updated using the same baseline and tasks. A developer or build manager can update additional projects in the same project grouping, using the same baseline and tasks, without refreshing the baseline and tasks. Thus, it is necessary to calculate and save this baseline and tasks, and to specify that subsequent project updates use this saved baseline and tasks.

You might change the update properties of a project. The update properties determine whether a project is updated using tasks and a baseline or object status, and sets parameters that control which objects are selected. Here are some of the properties you might change, and the commands to use to change them:

You can also change update properties using the Rational Synergy GUI.

By default and for performance purposes, the update command does not provide parallel version notification when it encounters parallel object versions. You can set parallel version notification by configuring the reconfigure_parallel_check user option.

The update_members command supports these subcommands:


Feedback