2. AccuRev® Command-Line Reference : mksnap

mksnap
create a new snapshot
Usage
accurev mksnap -s <snapshot> -b <existing-stream> -t <time-spec>
Description
The mksnap command creates a new snapshot, based on an existing stream. The snapshot contains the same set of element versions that the existing stream contained at a particular point in time. The existing stream on which a snapshot is based might change, through promotes. But the contents of a snapshot never change. See Entity Names for information on naming snapshots.
You can implement a “changeable snapshot” facility using a dynamic stream. See Using the -t Option in the mkstream reference page.
Options
-s <snapshot>
(required) Specify a name for the new snapshot. The name may begin with a digit (provided there is at least one non-digit in the name), must not begin with a dot (.), must not include either a slash (/) or a backslash (\) and must not be a name of digits only.
-b <backing-stream>
Specify an existing stream, on which the new snapshot will be based.
-t <time-spec>
Snapshot time. The snapshot will contain the versions that were in the stream at the specified time. If you specify a transaction number, the snapshot will include the versions that were in the stream at the time the transaction was completed.
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.
You cannot specify a time that is before the creation of the existing stream, or after the current time.
When using the –t option, take into account the possibility of a timewarp. The AC_SYNC environment variable (see AccuRev User Preferences) determines how a timewarp will be handled. See also section System Clock Synchronization of the AccuRev Administrator’s Guide.
Examples
Create a snapshot of the current state of the gizmo stream, calling it gizmo_s1:
> accurev mksnap -s gizmo_s1 -b gizmo -t now
Create a snapshot of the state of the gizmo stream on May 2nd, 2000 at 2:55pm, calling it gizmo_may2:
> accurev mksnap -s gizmo_may2 -b gizmo -t "2000/05/02 14:55:00"
See Also
mkstream, promote

Micro Focus