Creates a snapshot of the OpenVMS Registry database. That is,
the system writes all cached OpenVMS Registry keys or values and
makes a copy of the OpenVMS Registry database files.
The OpenVMS Registry server copies database files to the location
specified by /DESTINATION (SYS$REGISTRY by default), using the file
extension .RSS (Registry SnapShot). To restore the snapshot, shut
down all applications using the Registry, shut down the Registry
server, and copy the files to SYS$REGISTRY, renaming them with the
.REG file extension.
NOTE
When you restore the database from a snapshot, you
lose all modifications that were made to the database
since the last snapshot was taken.
By default the OpenVMS Registry server creates a snapshot
automatically every 24 hours and retains the five most
recent snapshot files.
This command requires the SYSPRV privilege.
Format:
CREATE SNAPSHOT
1 – Qualifiers
1.1 /DESTINATION
/DESTINATION=file-spec
Controls where the system will write the snapshot files. By
default, the system creates the snapshot in the location
specified by the SYS$REGISTRY logical.
If you specify the /DESTINATION qualifier but do not provide a
valid directory, the system creates the snapshot files in the
directory in which you started the OpenVMS Registry server.
1.2 /VERSIONS
/VERSIONS=number
Specifies how many previous versions of the snapshot files to
keep.
1.3 /WAIT
/WAIT=seconds (default = 90)
/NOWAIT
Specifies the maximum amount of time, in seconds, that you are
willing to wait for command completion. If the Registry server
does not complete the request in the specified interval, REG$CP
returns REG-F-NORESPONSE. The default interval is 90 seconds.
/NOWAIT is equivalent to specifying /WAIT=0, but there may still
be a short wait period.
2 – Example
REG> CREATE SNAPSHOT/DESTINATION=SYS$REGISTRY/VERSION=3
Creates a snapshot of the OpenVMS Registry database in the
SYS$REGISTRY directory. If more than three versions of the
OpenVMS Registry database snapshot files exist, the system
deletes the oldest version (the same as purge/keep=3 command).