The New Stream and Change Stream Commands
(Stream Configuration dialog)
The New Stream and Change Stream commands open a dialog in which you specify/revise the configuration of a new/existing stream.
In the Stream Browser, right-click a stream to select it and display its context menu. Then,
Choose New Stream from the context menu to create a new stream below the selected stream.
Choose Change Stream from the context menu to revise the configuration of the selected stream.
Enter or revise the following specifications, then click Ok.
Name
No two streams in the same AccuRev repository can have the same name, even if they are in different depots. See User-Specified Names for AccuRev Entities.
Basis
The parent stream (backing stream, basis stream) The stream that is just above a given workspace or stream in a depot's stream hierarchy. The given workspace/stream inherits versions from the parent stream. of the stream you are reconfiguring. Changing this entry reparents The operation that changes the parent stream of a particular workspace or stream. the stream when you click Ok.
In a New Stream dialog, this field is not editable, because you selected the parent stream when you invoked the command.
Stream Type
The type of the stream:
Dynamic stream A stream whose configuration changes over time, with new versions promoted from child workspaces and/or from other dynamic streams. It also inherits versions from its parent stream.
Snapshot An immutable (frozen, static) stream that captures the configuration of another stream at a particular time. A snapshot cannot be renamed or modified in any way. [note ]
Pass-through stream When a version is nominally promoted to pass-through stream X, the version automatically 'passes through' X: it is actually promoted to X's parent stream.
In a Change Stream dialog, this field is not editable. You cannot change the type of an existing stream.
By default, a stream inherits the versions currently in its parent stream . If you assign a basis time A date-timestamp setting for a stream, affecting which versions the stream inherits from its parent stream: for each element, the version inherited is the one that was in the parent stream at the basis time. See snapshot. to a stream, it inherits the versions that were in the parent stream at a specified point in time.
None
(disabled for New Snapshot or if you select Snapshot as the stream type) No basis time; in the future, the stream will inherit the versions currently in its parent stream .
Now
The stream or snapshot will contain the versions that were in its parent stream at the time you clicked Ok in this dialog.
As of transaction #
Enter an integer transaction number. The stream or snapshot will contain the versions that were in its parent stream at the time the specified transaction was created.
Specified
Enter a specific time. The stream or snapshot will contain the versions that were in its parent stream at the specified time.
You can fill in the individual subfields manually, or use the Select Date button to display choices ("2 days ago", etc.) that fill in the subfields automatically. Once these subfields are filled in, you can revise them individually or by clicking the Select Date button again.
Notes (click to view):
Dynamic stream with basis time vs. Snapshot
Setting a basis time on a stream does make it like a snapshot of its parent stream -- initially. But after that, new versions can be promoted to such a "time-based stream" from child workspaces and from other streams; you cannot promote new versions to a snapshot. Since you can change the basis time of a time-based stream as often as you wish, it can serve as a "moving snapshot" of its parent stream.
Another way to control which versions are inherited from the parent stream
The basis-time facility includes versions based on when they were created. The include/exclude facility includes elements based on their pathnames.