rmstream

Remove a UCM stream

APPLICABILITY

ClearCase (cleartool subcommand),

SYNOPSIS

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

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

DESCRIPTION

The rmstream command deletes one or more UCM streams.

The following restrictions apply:

• The stream cannot contain activities.
• The stream can have no baselines other than the set of initial baselines associated with it.
• No views can be attached to the stream.

In addition, a project's integration stream cannot be removed while other project streams exist.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the stream 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 stream.

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

SPECIFY THE STREAM TO BE REMOVED.

stream-selector ..

Specifies one or more streams to delete.

stream-selector is of the form: [stream:]stream-name[@vob-selector] and vob is the stream'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 stream that has a view attached to it.
  1. Issue the rmstream command. You are told that the stream cannot be removed because a view is still attached to it:

cmd-context rmstream -f html_parser_int
cleartool: Error: Cannot remove stream that has a view ("html_parser_int_view") attached to it.

cleartool: Error: Unable to remove stream "html_parser_int".

1. Display a description of the stream to see what views are associated with it:

cmd-context describe stream:html_parser_int stream "html_parser_int"
created 11-Sep-99.11:27:01 by JFMuggs
owner: jfm
group: user
project: html_parser
title: html_parser_int
contains activities:
foundation baselines:
views:
html_parser_int_view

Guarding: brtype:html_parser_int@/usr1/tmp/foo_project

1. Remove the view:

cmd-context rmview -tag html_parser_int_view
Removing references from VOB "/usr1/tmp/foo_project" ...

Removed references to view "/net/propane/usr1/tmp/html_parser_int.vws" from VOB "/usr1/tmp/foo_project".

1. Reissue the rmstream command:

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

SEE ALSO

lsstream, mkstream