DMU.HLB  —  RESTORE  qualifiers  /VERSION
  Syntax:

      /[NO]VERSION

  Use /VERSION to restore an object to a directory in which there is an
  object with the same name.  If you do not use the /VERSION qualifier,
  DMU will not restore an object whose name is the same as the name  of
  an already existing object.

  Use /NOVERSION to guarantee that you are not creating  an  additional
  version  of an object when you do not intend to do so.  /NOVERSION is
  the default.

  The results of using the /VERSION qualifier  vary  depending  on  the
  existing children of the destination directory.

   o  RESTORE/VERSION restores an object to a destination directory  if
      the destination directory does not already contain an object with
      the same name and same version number as the object in the backup
      file.   The  restored  object  has the same version number as the
      object in the backup file.

   o  RESTORE/VERSION restores an object to a destination directory and
      issues an informational message if the destination directory does
      not already contain an object with the same name and same version
      number  as  the object in the backup file, but it does contain an
      object with the same name  and  a  higher  version  number.   For
      example,  the backup file contains TEST_REC;2 and the destination
      directory contains only TEST_REC;3.   DMU  restores  the  object,
      giving  it  the same name and version number as the object in the
      backup file, and issues an informational message.

   o  RESTORE/VERSION does not restore an  object  if  the  destination
      directory  contains  an  object  with  the  same name and version
      number as an object in the backup file.  For  example,  DMU  does
      not  restore  TEST_REC;2  if  the  destination  directory already
      contains an object named TEST_REC;2.

  By default, a restored version of  an  object  has  the  same  access
  control  list and history list as the highest existing version of the
  object in the destination directory.  If the access control  list  is
  included  in  the backup file, it will be restored with the object if
  you have CONTROL privilege at the highest  existing  version  of  the
  object in the destination directory.
Close Help