AccuRev® Command-Line Reference : chstream

chstream
change a stream
Usage
accurev chstream -s <stream> <new-name>
accurev chstream -s <stream> [ -b <new-backing-stream> ]
[ -t <time-spec> ]
accurev chstream -s <stream> [ -b <new-backing-stream> ]
[ -t <time-spec> ] <new-name>
Description
The chstream command can change any of these specifications of an existing stream:
the name of the stream (see Entity Names on page 6 for information on naming streams)
the basis time of the stream
the backing stream: the other stream on which the stream is based
Such changes apply only from the current time forward — it is impossible to change the past. Thus, queries that refer to the past will use the old characteristics of the stream.
Note: although chstream enables you to give a new name to a stream, you cannot then create a new stream with the old name. The old name remains associated with its stream. The only way to reuse a stream name is to completely remove the stream’s depot from the AccuRev repository, using the AccuRev administration utility, maintain. This utility is documented in the AccuRev Administrator’s Guide.
Options
-s <stream>
(required) Specify the stream to be changed.
-b <backing-stream>
Specify a new backing stream for the stream to be changed.
-t <time-spec>
Specify a new basis time for the stream. A time-spec can be any of the following:
Time in <YYYY/MM/DD HH:MM:SS> format: e.g. 2007/08/07 20:27:15. Note that you might need to use quotes in composing the argument following –t; the entire argument must be interpreted by the command shell as a single token.
Use the time keyword none to remove a stream’s basis time. You cannot set a basis time for a pass-through stream.
When using the –t option, take into account the possibility of a timewarp. The AC_SYNC environment variable (see AccuRev User Preferences on page 6) determines how a timewarp will be handled. See also section System Clock Synchronization on page 29 of the AccuRev Administrator’s Guide.
Examples
Rename a stream:
> accurev chstream -s tulip_dvt tulip_development
Change the backing stream of stream emergency_1017:
> accurev chstream -s emergency_1017 -b gizmo_beta
See Also
mkstream, remove stream, show streams

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com