/sys$common/syshlp/DNS$CPHELP.HLB  —  recreate

1  –  directory

 Re-creates a duplicate directory in the source subtree as a new
 directory in the target subtree.

 SYNOPSIS

      RECREATE DIRECTORY directory-name [AS] DIRECTORY newdirectory-name

 Arguments

 directory-name

 The full name of the directory.

 newdirectory-name

 The new name of the copy of the directory.

 Description

 This command re-creates a duplicate directory in the source subtree
 as a new directory in the target subtree. This is useful for
 resolving duplicate name conflicts that result from a merge of
 two subtrees. The command duplicates the directory only, not its
 contents. Its writable attribute values (DNS$ACS, DNS$Convergence,
 and DNS$UpgradeTo) are retained.

                                 NOTE

    Although all original ACEs are retained, the new directory also
    inherits all ACEs that may be propagated from the new parent
    directory in the target subtree. The principal executing the
    recreate directory command is granted full access to the new
    directory.

 The following attribute values are updated and do not match
 the values of the original directory: DNS$AllUpTo, DNS$CTS,
 DNS$DirectoryVersion, DNS$InCHName, DNS$ParentPointers,
 DNS$Replicas, and DNS$UTS. This command does not delete or modify
 the source directory.

 ACCESS RIGHTS
 You must have read, write, and delete access to the directory in
 which you intend to re-create the source directory.

1.1  –  example

 The following command re-creates the existing directory .sales.quar1
 as a new directory named .mkt.quar1.

 dns> recreate directory .sales.quar1 as directory .mkt.quar1

2  –  link

 Re-creates a duplicate soft link in the source subtree as a new soft
 link in the target subtree.

 SYNOPSIS

      RECREATE LINK link-name [AS] LINK newlink-name

 Arguments

 link-name

 The full name of the soft link.

 newlink-name

 The new name of the copy of the soft link. If you specify the name
 of an existing directory in the target subtree, the soft link is
 recreated in that directory with its original link name.

 Description

 This command creates a copy of a soft link with a new full name.
 This is useful for resolving duplicate name conflicts that result
 from a merge of two subtrees. The soft link's writable attribute
 values are retained, but DNS$CTS and DNS$UTS attribute values are
 not preserved.

                                 NOTE

    Although all origianl ACEs are retained, the new soft link also
    inherits all ACEs that may be propagated from the new parent
    directory in the target subtree. The principal executing the
    recreate link command is granted full access to the new soft
    link.

 Asterisk wildcards are acceptable in both arguments. This command
 does not modify or delete the source soft link.

 ACCESS RIGHTS
 You must have read, write, and delete access to the directory in
 which you intend to re-create the soft link.

2.1  –  example

 The following command re-creates all soft links that exist in the
 .sales directory as new soft links in the .mkt directory.

 dns> recreate link .sales.* as link .mkt.*

3  –  object

 Re-creates a duplicate object entry in the source subtree as a new
 object entry in the target subtree. Its writable attribute values
 are retained, but DNS$CTS and DNS$UTS attribute values are not
 preserved. Asterisk wildcards are acceptable in both arguments.
 This command does not modify or delete the source object entry.

 SYNOPSIS

      RECREATE OBJECT object-name [AS] OBJECT newobject-name

 Argument

 object-name

 The full name of the object entry.

 newobject-name

 The new name of the copy of the object entry. If you specify the
 name of an existing directory in the target subtree, the object is
 recreated in that directory with its original object name.

 Description

 This command creates a copy of an object entry with a new full
 name. This is useful for resolving duplicate name conflicts that
 result from a merge of two subtrees. The object's writable attribute
 values are retained, but DNS$CTS and DNS$UTS attribute values are
 not preserved.

                                 NOTE

    Although all origianl ACEs are retained, the new object also
    inherits all ACEs that may be propagated from the new parent
    directory in the target subtree. The principal executing the
    recreate object command is granted full access to the new
    object.

 Asterisk wildcards are acceptable in both arguments. This command
 does not modify or delete the source object entry.

 ACCESS RIGHTS
 You must have read, write, and delete access to the directory in
 which you intend to re-create the object entry.

3.1  –  example

 The following command re-creates the existing object entry .sth.obj2
 as a new object entry named .pjl.obj4.

 dns> recreate object .sth.obj2 as object .pjl.obj4
Close Help