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.