rmproject

Removes a UCM project

APPLICABILITY

ClearCase UCM (cleartool subcommand),

SYNOPSIS

rmproject [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery | -nc·omment ]

[ -f·orce ] project-selector ...

DESCRIPTION

The rmproject command deletes one or more UCM projects.

You cannot delete a project that contains a stream.

ClearQuest-Enabled Projects

When you delete a project that uses the UCM-ClearQuest integration, the project is unlinked from its associated ClearQuest record, but the ClearQuest record is not deleted.

PERMISSIONS AND LOCKS

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

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

Mastership: The project 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 rmproject command prompts for confirmation before deleting a project. The -force option suppresses the confirmation step.

project-selector ...

Specifies one or more projects to delete.

project-selector is of the form: [project:]project-name[@vob-selector] and vob is the project'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 project that contains a stream.
  1. Issue the rmproject command:

cmd-context rmproject html_parser
Remove project "html_parser"? [no] yes
cleartool: Error: Cannot remove project that has streams.
cleartool: Error: Unable to remove project "html_parser".

1. Use lsproject -long to see a detailed description of the project, including a list of any streams contained by the project:

cmd-context lsproject -long html_parser
cleartool lsproject -l html_parser
project "html_parser"
07-Sep-99.11:24:27 by Bsmith
owner: bsmith
group: user
folder: parsers
title: html_parser
integration stream: html_parser_int
development streams:
html_parser_int
modifiable components:
default rebase promotion level: INITIAL
recommended baselines:

1. Remove the stream. The -force option bypasses the confirmation step.

cmd-context rmstream -force html_parser_int
Removed stream "html_parser_int".

1. Reissue the rmproject command:

cmd-context rmproject -force html_parser
Removed project "html_parser".

SEE ALSO

lsproject, lsstream, mkproject, rmstream