RADE

Source Code Manager

adl_rm_ws

Deleting workspaces

Quick Reference

Abstract

The adl_rm_ws command deletes workspaces.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_rm_ws workspace_name [-rec [-real] [-tree ws_tree_name ...]] [-h|-help|-?]

Usage

This command deletes a workspace in all its trees or a workspace and its child workspaces recursively in some trees or all its trees.

In recursive mode, if -real option is not defined, the workspace are not deleted but the workspaces list to delete is displayed.

Images are deleted but not their directories.

Promotions from the workspace to be deleted must have been collected.
Beware: local modifications are lost.
The workspace to be deleted cannot have any children left (they must have been deleted prior to deleting the workspace).

[Top]

Options

adl_rm_ws accepts the following options:

`-h\|-help\|-?`	Help of the command
`workspace_name`	Name of the workspace to be deleted
`-rec`	Remove all its child workspaces
`-real`	Remove really the workspaces
`-tree ws_tree_name...`	Removes all its child workspaces only in these specified trees

[Top]

Examples

Delete the workspace "MyWs":

adl_rm_ws MyWs
Removing the workspace "MyWs".
Command successful.

Simulate the deletion of the workspace "W1" and all its child workspace in tree Tree1:

adl_rm_ws W1 -rec -tree Tree1
Workspaces to delete for workspace tree Tree1. No rollback exists.

- W1                              created by nle on Tuesday, May 14, 2002 12:08:17 PM
     !
     +- W11                     created by nle on Tuesday, May 14, 2002 12:13:36 PM
     !      !
     !      +- W111             created by nle on Tuesday, June 18, 2002 06:03:50 PM
     !      !      !
     !      !      +- w1111     created by nle on Tuesday, August 12, 2003 06:58:09 PM
     !      !
     !      +- W112             created by nle on Tuesday, February 04, 2003 07:19:34 PM
     !      !
     !      +- W113             created by nle on Tuesday, February 04, 2003 07:23:59 PM
     !      !
     !      +- W1131           created by nle on Friday, April 11, 2003 03:45:39 PM
     !
    +- W12                      created by nle on Friday, April 11, 2003 03:46:10 PM

Delete the workspace "W1" and all its child workspace in tree Tree1:

adl_rm_ws W1 -rec -tree Tree1
Workspaces to delete for workspace tree Tree1. No rollback exists.

- W1                              created by nle on Tuesday, May 14, 2002 12:08:17 PM
     !
     +- W11                     created by nle on Tuesday, May 14, 2002 12:13:36 PM
     !      !
     !      +- W111             created by nle on Tuesday, June 18, 2002 06:03:50 PM
     !      !      !
     !      !      +- w1111     created by nle on Tuesday, August 12, 2003 06:58:09 PM
     !      !
     !      +- W112             created by nle on Tuesday, February 04, 2003 07:19:34 PM
     !      !
     !      +- W113             created by nle on Tuesday, February 04, 2003 07:23:59 PM
     !
    +- W12                      created by nle on Friday, April 11, 2003 03:46:10 PM

Removing the workspace "W1111".
Command successful.
Removing the workspace "W111".
Command successful.
Removing the workspace "W112".
Command successful.
Removing the workspace "W113".
Command successful.
Removing the workspace "W11".
Command successful.
Removing the workspace "W12".
Command successful.
Removing the workspace "W1".
Command successful.

Delete the non existing workspace "MyWrongWs":

adl_rm_ws MyWrongWs
Looking for the workspace "MyWrongWs"
#ERR# ADLCMD - 0421: No workspace "MyWrongWs" found
Run adl_ls_ws and choose a workspace

##### THE COMMAND ENTIRELY OR PARTIALLY FAILED #####

[Top]

References

[1]	adl_ch_ws: Changing workspace
[2]	adl_mk_ws: Creating workspace

[Top]

History

Version: 2 [Oct 2003]	New options -rec, -real and -tree
Version: 1 [Mar 2001]	Document created

[Top]