The rmlabel command removes one or more version labels from versions of elements. Labels can be attached to versions by the mklabel command and by triggers (mktrtype –mklabel).
rmlabel deletes a reference to a label type object. To delete the label type object itself or the type object and all its instances, use the rmtype command.
You must have one of the following identities:
An error occurs if one or more of these objects are locked: VOB, element type, element, branch type, branch, label type.
(Replicated VOBs only) If the label type is unshared, your current replica must master the label type. If the label type is shared, your current replica must master the object whose label you are removing:
You cannot use this command to remove an instance of a UCM baseline label type.
If the label has been used only once in an element's version tree, you can specify the element itself or any of its branches or versions:
If the label has been used multiple times, you must specify either the version to which the label is attached, or the branch on which that version resides.
foo.c | Version selected by view |
foo.c@@\REL1 | Version specified by label |
foo.c@@\main\rel2_bugfix\3 | Version specified by version ID |
foo.c@@\main\rel2_bugfix | Branch on which version resides |
Using the –version option modifies the way in which this argument is interpreted.
The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.
Copyright© 2003 Rational Software. All Rights Reserved.