2. 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 5 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, "2007/08/07 20:27:15", for example. Note that you must use quotes when specifying time-spec as YYYY/MM/DD HH:MM:SS to ensure that the entire argument is 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 31 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)

Borland