TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Control > Update Objects (Apex/Summit)

The Control > Update Objects command is used to propagate changes from source views to destination views. The command updates a list of destination objects to be

the latest versions, or
the latest versions in the current history, or
the same versions (if newer) as corresponding objects in another view, or
the latest versions in a specified history, or
the same versions (if newer) as objects associated with a set of tasks, or
the same versions as the corresponding objects in another view.

Versions of new objects and imports may also be copied into destination views.

When you choose this command, the Update Objects dialog box appears.

A complete description of Summit/CM version control can be found in the Using and Customizing Summit/CM.

Update Objects Dialog Box Fields:

Objects Field

This field contains the list of destination objects to be updated. Alternatively, it may contain the list of source objects (see Source/Destination Radio buttons below).

Use the Add input field to add object names. Use the Remove and Clear buttons to delete object names from the field.

Mode Radio Buttons

The Mode radio buttons in the Update Objects dialog box specify the operation. Additional dialog components are displayed below the buttons when certain operations are selected.

Views Field

This list identifies the source objects that provide versions to be accepted. Alternatively, it may be the list of destination objects (see Source/Destination Radio buttons below). Use the Add input field to add view names. Use the Remove and Clear buttons to delete view names from the field.

Use a subsystem-relative view name Field

This field provides a concise alternative to specifying full view names in the Views list. A simple view name must be specified (without a subsystem pathname). The effective Views list then contains all views with that simple name in all subsystems containing an object in the Objects list.

Source/Destination Radio Buttons

When a Mode is selected that requires source objects, these buttons are displayed and indicate whether the Objects or Views list is the source or destination for the update. By default, the Objects list contains the destination objects and the Views list contains the source objects.

Source History Field

The history from which source objects are selected when the Accept newer versions from source history mode is used.

Tasks Field (Rational Summit/TM only)

The Tasks field specifies tasks whose associated controlled object versions are to be accepted into the destinations identified by the Objects field at the top of the dialog.

The Navigator icon can be used to select a different set of tasks by activating the Select Tasks dialog. The Alternatives icon pops up a menu of tasks in the "to do" task list with their Summary fields.

When the versions associated with a task are accepted, the task is said to be "accepted". Since a task represents a unit of work, it is often important that tasks should either be completely accepted or not be accepted at all. The following check box options control the completeness of task acceptance:

It is possible that accepting a designated task will cause versions from other tasks to be accepted. The following mutually exclusive options determine how this is handled:

The following procedure determines which versions are used to update the destination files. All of the versions associated with the given tasks in the Tasks field are collected. If the Accept dependent tasks check box is also selected, then the versions associated the descendants of any accepted task are also collected. (The descendants of a task are its child tasks and their children, recursively.) If the Accept other tasks check box is selected, any additional tasks associated with the accepted versions are also accepted.

If an object has more than one version in the set, then all but the latest version are removed. The remaining versions are the source versions to be accepted. They are checked for conformance with the No incomplete tasks, and No task regression options.

Limit To Radio Buttons

Add New Objects Area

In some cases, new objects are specified in the source view. This toggle controls whether they will be accepted into the destination view if there are not already there. New objects will be accepted from the specified histories.

Adopt Different Histories

This option causes the update to change the history and contents of destination objects to match the source objects if they both exist and have different histories. Use with caution because this option causes views to be come more similar when the differences between them might have been intended.

Allow uncontrolled objects to be updated Check Box

This option allows a controlled source object to replace a corresponding uncontrolled destination object. A copy of any object so replaced is saved with the suffix ".saved" added to the original filename.

Copy Compilation Artifacts Check Box

This option specifies whether compilation artifacts should be accepted with the corresponding source files.

Expand Configurations Check Box

This option causes any configuration files (files with the extension .cfg) specified in the Objects or Views lists to be replaced by the lists of views that they contain. Otherwise, configuration files are treated as objects.

Show Effort Only

This option shows the actions which would be taken if the object update was executed with the current dialog box settings.

Imports

When accepting from source views into destination views, imports may optionally be copied. When copying only imports, system descriptions may be used as source objects. The Expand Configurations check box must be set when imports are to be copied.

Import Radio Buttons

Import from configuration Field

When the check box is selected, the views listed in the specified configuration file are included as candidate source views from which imports may be copied.

Additional Topics

For more information, click on a topic:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS