DMU.HLB  —  COPY  qualifiers  /VERSION
  Syntax:
      /[NO]VERSION

  Use /VERSION to copy objects to a directory where an object with  the
  same  name  already  exists.   The  new  objects  in  the destination
  directory have the same version numbers as the original objects  from
  which  they  were copied, regardless of whether you specified version
  numbers in the source path names.  Unless there is an object  in  the
  destination  directory  with  the  same  name  as  an  object you are
  copying, there is no need to use /VERSION.

  Use /NOVERSION to guarantee that the destination directory  does  not
  already  contain  an  object with the same name as the object you are
  copying.  /NOVERSION is the default.

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

   o  COPY/VERSION copies 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 source object.  In  this
      case,  DMU  copies  the  specified  version  of the object in the
      source path name to the destination directory.   The  new  object
      has the same version number as the source object.

   o  COPY/VERSION copies an object  to  a  destination  directory  and
      issues  an  informational  message  if  the destination directory
      already contains an object  with  the  same  name  and  a  higher
      version  number.   For  example,  you  specify TEST_REC;2 and the
      destination directory contains  TEST_REC;3.   In  this  case  DMU
      creates  the  object with the same name and version number as the
      source object, then issues the informational message.

   o  COPY/VERSION does not copy an object if the destination directory
      contains  an  object with the same name and version number as the
      source object.  For  example,  you  specify  TEST_REC;2  and  the
      destination directory already contains TEST_REC;2.

  By default, a new 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.  You can copy the access  control  list
  from the source by using the /PROTECTION qualifier with /VERSION.  To
  copy the access control list, you must have CONTROL (C) privilege  at
  the  highest  existing  version  of  the  object  in  the destination
  directory.  You can copy the history list from the  source  by  using
  /HISTORY with /VERSION.
Close Help