rmcomp

Removes a UCM component

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

rmcomp [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery | -cqe·ach |

-nc·omment ] [ -f·orce ] component-selector ...

DESCRIPTION

The rmcomp command deletes a UCM component object. Elements of the component and the VOB associated with the component are not deleted.

The following restrictions apply:

• The component cannot be in use by a stream.
• There cannot be any baselines of the component other than the initial baseline
• The component's initial baseline cannot be in use as a foundation baseline for a stream.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the owner of the component, the VOB owner, or a member of the ClearCase group.

Locks: An error occurs if there are locks on any of the following objects: component, UCM project VOB.

Mastership: The component must be locally mastered.

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -nc). See CUSTOMIZING COMMENT HANDLING in the comments reference page. Comments can be edited with chevent.

-c·omment comment | -cfi·le comment-file-pname |-cq·uery | -cqe·ach | -nc·omment

Overrides the default with the option you specify. See the comments reference page.

-f·orce

By default, the rmcomp command prompts for confirmation before deleting a component. The -force option suppresses the confirmation step.

component-selector ...

Specifies one or more components to delete

component-selector is of the form: [component:]component-name[@vob-selector] and vob is the component's UCM project VOB.

EXAMPLES

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Remove a component that contains baselines.
  1. Issue the rmcomp command for a specified component:

cmd-context rmcomp parser@/usr1/tmp/foo_project
Remove component "parser@/usr1/tmp/foo_project"? [no] yes

cleartool: Error: Cannot remove component that has baselines other than the initial baseline.

cleartool: Error: Unable to remove component "parser@/usr1/tmp/foo_project".

1. Use the lsbl command to find the baselines associated with the component:

cmd-context lsbl -component parser@/usr1/tmp/foo_project
07-Sep-99.10:47:47 parser_INITIAL.109 bill "parser_INITIAL"
component: parser

07-Sep-99.10:49:06 START.109 bill "START"
component: parser

1. Remove the baseline:

cmd-context rmbl -f START.109@/usr1/tmp/foo_project
Removed baseline "START.109@/usr1/tmp/foo_project".

1. Reissue the rmcomp command:

cmd-context rmcomp -f parser@/usr1/tmp/foo_project
Removed component "parser@/usr1/tmp/foo_project".

SEE ALSO

lscomp, mkcomp, rmbl