REGCP$HELP.HLB  —  CREATE  SNAPSHOT
    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).
Close Help