DMU.HLB  —  RENAME  qualifiers  /VERSION
  Syntax:

      /VERSION
      /NOVERSION

  Use /VERSION to rename an object when an object  with  the  specified
  given  name  already exists.  For example, you would need /VERSION to
  rename TEST_REC;1 to SAMPLE_REC if the directory already contained an
  object  named  SAMPLE_REC.   Directories cannot have versions, so you
  cannot use this qualifier when renaming directories.

  Use /NOVERSION to guarantee that the directory does  not  contain  an
  object with the same given name as the one you specified.  /NOVERSION
  is the default.

  The results of using /VERSION vary depending on the way in which  you
  specify  the  objects  to  be  renamed.   For  more information about
  specifying versions, type "HELP specify versions".

   o  RENAME/VERSION successfully renames an object if:

       -  You do not specify the version number of the new name of  the
          object.   For  example,  you  want  to  rename  TEST_REC;1 to
          SAMPLE_REC.  If you do  not  specify  a  version  number  for
          SAMPLE_REC, DMU renames TEST_REC;1 to SAMPLE_REC and gives it
          a version  number  one  greater  than  the  highest  existing
          version of SAMPLE_REC.

       -  You specify the version  number  of  the  new  name  and  the
          version  number  is  higher  than  the  version number of any
          object  with  the  same  name.   For  example,   you   rename
          TEST_REC;1  to  SAMPLE_REC;2.  If the directory contains only
          SAMPLE_REC;1, DMU renames TEST_REC;1 and gives it the version
          number you specified, SAMPLE_REC;2.

   o  RENAME/VERSION renames an object and gives a warning  message  if
      you specify the version number of the new name of the object, and
      that version number is lower than the version number of any other
      version  of  the  object.   For example, you rename TEST_REC;1 to
      SAMPLE_REC;2  and  the  directory  already  contains  an   object
      SAMPLE_REC;3.   It  does  not  contain  an  object  SAMPLE_REC;2,
      however.  DMU renames the object, gives it the version number you
      specified, and issues a warning message.

   o  RENAME/VERSION  does  not  rename  an  object  if  the  directory
      contains  an object with the name and version number you specify.
      For example, you attempt to rename TEST_REC;1 to SAMPLE_REC;2 and
      an object SAMPLE_REC;2 already exists in that directory.

  When you rename an object, it retains the  access  control  list  and
  history list it had under its old name, even if the object becomes an
  additional version of another object.
Close Help