chstream

Modifies a UCM stream

APPLICABILITY

SYNOPSIS

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

[ -tar·get stream-selector | -nta·rget ] [ -gen·erate ]
[ -pol·icy policy-keyword[,... ] ] [ -npo·licy policy-keyword[,...] ]
[ -rec·ommended { baseline-selector[,...] | -def·ault } | -nre·commended ]
stream-selector ...

DESCRIPTION

The chstream command allows you to set stream policies, specify the default deliver target for integration streams, and set recommended baselines.

For information about changing the stream's name, see rename.

RESTRICTIONS

Identities: You must have one of the following identities:

• Project VOB owner

• Stream owner

• root (UNIX)

• Member of the ClearCase group (ClearCase on Windows only)

• Local administrator of the ClearCase LT server host (ClearCase LT on Windows only)

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

Mastership: (Replicated VOBs only) Your current replica must master the stream.

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 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.

SETTING THE DEFAULT DELIVER TARGET FOR INTEGRATION STREAMS ONLY. Default: None.

-tar·get stream-selector | -ntarget

Specifies the default deliver stream of an integration stream. The target must be a stream in a different project.

Using -ntarget clears the default deliver stream setting.

stream-selector is of the form: [stream:]stream-name[@vob-selector] where vob-selector is the project VOB of a different project.

UPDATING THE STREAM'S COPY OF THE CONFIG SPEC. Default: None.

-gen·erate

Forces an update of the stream's copy of the config spec. Use this option after renaming a baseline (or its label type) and after renaming a stream (or its branch type).

SETTING PROJECT POLICY. Default: None.

-pol·icy policy-keyword[,... ]

Enables the specified policy. For information about stream policies, see mkstream.

-npo·licy policy-keyword[,... ]

Disables the specified policy. For information about stream policies, see mkstream.

SETTING RECOMMENDED BASELINES. Default: None.

-rec·ommended { baseline-selector[,...] | -def·ault } | -nre·commended

Names a list of baselines that a stream recommends. You must always specify the full list of recommended baselines to change the list. With composite baselines, you may only need to name one baseline.

baseline-selector is of the form [baseline:]baseline-name[@vob-selector], where vob-selector specifies the baseline's project VOB.

Using the -default option sets the default recommended baselines. The default recommended baselines are dynamic; they are the latest baselines created in the stream at or above the specified promotion level for each component, or its foundation baseline if none has been created in the stream.

Using the -nrecommended option clears the list of recommended baselines previously set in a stream.

SPECIFYING THE STREAM. Default: None.

stream-selector ...

Specifies one or more streams to be modified.

stream-selector is of the form [stream:]stream-name[@vob-selector], where vob-selector specifies the stream's project VOB.

You can specify the stream as a simple name or as an object selector of the form [stream]:name@vob-selector, where vob-selector specifies a project VOB (see the cleartool reference page). If you specify a simple name and the current directory is not a project VOB, then this command assumes the stream resides in the project VOB associated with the current view. If the current directory is a project VOB, then that project VOB is the context for identifying the stream.

SEE ALSO

deliver, lsstream, mkstream, rebase, rename, rmstream