chstream

Modifies a UCM stream

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

chstream [ -c·omment comment | -cfi·le pname | -cq·uery | -cqe·ach| -nc·omment ]

[ -title title ] stream-selector ...

DESCRIPTION

The chstream command allows you to assign a new title to a stream. The stream's unique identifier is unchanged. See rename for related information.

PERMISSIONS AND LOCKS

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

Locks: An error occurs if there are locks on the following objects: the UCM project VOB, 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.

-title title

Specifies the new title for the stream. The title argument can be a character string of any length. Enclose a title with special characters in double quotes.

stream-selector ...

Specifies one or more streams to be modified.

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.

• Change the title of a stream.

cmd-context chstream -title "jamaica blue" java-int@vobs/javaprojvob

SEE ALSO

lsstream, mkstream, rename, rmstream