![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
File > Delete ObjectThe File > Delete Object command removes an object from anywhere, including a directory or subsystem. When you invoke this command, the Delete Object dialog box appears.
You can delete subsystems, views, files, directories, and objects.
For Apex/Summit., export sets are a view property. To delete export sets, use Control > View Properties. Version family histories are a subsystem property. To delete histories use Control > Subsystem Properties.
Delete Object Dialog Box Fields:
Objects to Delete Field
The objects to be deleted are shown in the list field. Add or remove objects to be deleted by typing the name in the input field and using the add and remove buttons. Click on OK or Apply to delete the object(s).
Delete Check Boxes
- Delete non-empty directories.
Deletes a directory and recursively deletes subcomponents. If this option is not selected and non-empty directories are specified, the operation fails.
- Delete read-only files (Apex/ClearCase)
- Leave objects inconsistent, if necessary (Apex/Summit)
Deletes objects even if there are Summit/CM errors.
- Delete the RCI target directory of each view. (Apex/Summit, Ada only)
This option deletes the RCI directory of a view.
- Set attribute on controlled objects (Apex/Summit)
Set an extended version attribute on deleted versions of controlled objects. Two additional fields, Set Attribute and To Value, will appear. These are described below.
Delete Radio Buttons
These radio buttons apply to controlled objects.
- Delete from view only. (Apex/Summit)
Uncontrol the file in the view and then delete it. The version history of the controlled object is not affected. Thus, when Control > Update Objects (Apex/Summit) is run, the file will reappear.
- Create `Deleted Version' in version history. (Apex/Summit)
Create a deleted version of the controlled object in the version history and remove the file from the view. The deletion will propagate by deleting the object(s) when Control > Update Objects (Apex/Summit) is run.
- Remove entry (Uses rmname) (Apex/ClearCase)
Removes the name of an element from the directory version. Uses the cleartool rmname command. Orphaned elements are automatically moved to the VOB's lost+ found directory.
- Delete element (Uses rmelem) (Apex/ClearCase)
Complete destroys the element in the VOB, irretrievably. Use extreme caution. Uses the cleartool rmelem command. Orphaned elements are automatically moved to the VOB's lost+ found directory.
Deleting Controlled Files
No matter how you use Apex to delete a controlled file, the file is never removed permanently from the CMVC database. There will always be a way to retrieve it. To delete a file, always use File > Delete Object. There are two options for deleting controlled files, each has distinctly different effects:
- 1 . When the Delete from view only option in the Delete Object dialog box is selected, the file is deleted only from the view where the operation is performed. Any other views will not be affected by this operation. To recover this file into the view from another view, simply run Control > Update Objects with the selected option ... and add new objects from the current histories. To recover this file into the view, without using a source view or file, create an empty file with the same name and run Control > Change Object Properties with place under cmvc control and accept from latest version.
- 2. . By selecting the Create `Deleted Version' in version history option (default option), the file is removed from the view as it was in the previous case and also a `deleted' mark is attached to the file in the version history of the file. For Apex, this means the file has been deleted. In effect no other view can make changes to the file (e.g. check out). Running the Control > Update Objects function in the other views will remove the file from the views. But still it is possible to recover the file by running the Control:Recover function that simply removes the `deleted' mark from the version history.
For Apex 3.0.0b, the second option is named Delete in version history instead of Create `Deleted Version' in version history.
For Apex.2.4.6 or older, the name of the first option is Make objects uncontrolled and the second option is default. By selecting the first option, the second option is deselected.
Checked Out Radio Buttons
These radio buttons determine what happens when an object to be deleted is checked-out.
- Fail (the default)
Deletion will be abandoned if the object to be deleted is checked-out.
- Check In before delete
Checks in any checked-out objects before deletion. The option applies to the deletion of views and controlled files within a view.
- Fail unless check-out is private (Apex/Summit)
Uncontrol the file in the view and then delete it. The version history of the controlled object is not affected. Thus, when Control > Update Objects (Apex/Summit) is run, the file will reappear.
- Abandon check-out (Apex/Summit)
Abandon deletion if the object to be deleted is checked-out. If the object is privately checked out in this view, do not fail, but create a deleted version of the object. It is illegal to delete a private check out from only the view, hence the Delete from view only will fail if the object is privately checked-out in the view.
- Uncheckout before delete (Apex/ClearCase)
Uncheckout any checked-out files or directories before deletion. T
Tasks to Associate with Controlled Objects (Rational Summit/TM)
Specifies the tasks to be associated with any controlled objects deleted. It is initialized with the current task list. The Navigate icon can be used to select a different set of tasks by activating the Select Tasks dialog. The Alternatives icon displays tasks in your "to do" task list.
Set Attribute (Apex/Summit)
The name of the extended attribute to be set in the deleted versions. The Alternatives icon displays the extended attributes defined for the enclosing subsystem.
To Value (Apex/Summit)
The value to be assigned to the specified extended attribute in the deleted versions. For list attributes, values are appended. The Alternatives icon displays possible values for enumeration attributes.
Command Line Interface > discard
Additional Topics
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |