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 on page 5 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 must begin with a non-digit other than dot (.), and must not include either a slash (/) or a backslash (\).

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

•	Time keyword: now

•	Transaction number as a positive integer: e.g. 146 or 23965

•	Transaction number keyword: highest

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

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