![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
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
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.
- Update objects to the latest versions
Changes each controlled object to be the latest version in the same history.
- Update objects to latest versions and add new objects from current history
Adds new objects from the current histories to the view and changes each controlled object to be the latest version in the same history. If the switch VC_ACCEPTABLE_HISTORY_CHANGES is defined in the view, the history of each controlled object is changed to the highest history precedence, defined on the switch.
- Accept newer versions from source objects
Changes each destination object to be the same version as the corresponding source object, if the source object is newer than the destination object.
- Make objects identical to source objects
Makes each destination object be the same version as the corresponding source object, regardless of whether the source object has the same history or is newer.
- Accept newer versions from source history
Changes each object to be the latest version in the history specified in Source History, if that version is newer.
- Accept newer versions associated with tasks (Rational Summit/TM only)
Changes each destination object to be the newest version associated with the tasks listed in the Tasks field, if that version is in the same history and is newer.
- Only copy imports from source objects
Copies only the imports associated with source views to the corresponding destination views. Does not update any controlled objects. The import options described below also apply.
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:
- Accept descendent tasks
Accept tasks which are descendents of any accepted task.
- No incomplete tasks
Do not accept a task unless it is possible to accept all versions associated with it.
- No task regression
Do not allow history changes which cause a task regression (the loss of changes associated with a previously accepted task).
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:
- Accept other tasks
Accept any other tasks that are associated with accepted versions.
- Warn (and continue)
Do not accept the other tasks. Issue a warning and continue.
- Fail
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
- All Controlled Objects
Updates all controlled objects listed in the Objects field.
- Source Objects with History
Only objects with matching the specified history are updated.
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
- Do not copy imports
- Add new imports from source views
Add any new imports in the source views to the existing imports of the corresponding destination views.
- Add new imports and remove imports not present in source views
Make imports in the destination views identical to those of the corresponding source views.
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
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |