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

1  –  link

 Deletes an individual soft link and replaces it with a new soft link
 to redirect lookups from the original location to the new location.
 This command is useful when you need to redirect lookups only for a
 subset of a directory's contents.

 SYNOPSIS

      REPLACE LINK link-name [WITH] LINK newtree-name

 Arguments

 link-name

 The full name of the soft link in its old location.

 newtree-name

 The full name of the directory into which the soft link has moved.

 Description

 This command deletes a specified soft link and replaces it with
 a soft link whose link target is the corresponding entry in the
 specified newtree-name directory. This command is useful when
 you need to redirect lookups only for a subset of a directory's
 contents.

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

1.1  –  example

 The following command replaces the soft link .ceb.link1 with a soft
 link whose link target is the corresponding entry in the directory
 .pjl.

 dns> replace link .ceb.link1 with link .pjl

2  –  object

 Deletes a specified object entry and replaces it with a new soft
 link whose link target is the corresponding entry in a new location.
 This command is useful when you need to redirect lookups only for a
 subset of a directory's contents.

 SYNOPSIS

      REPLACE OBJECT object-name [WITH] LINK newtree-name

 Arguments

 object-name

 The full name of the object entry in its old location.

 newtree-name

 The full name of the directory to which the object entry was moved.

 Description

 This command deletes a specified object entry and replaces it with
 a soft link whose link target is the corresponding entry in the
 specified newtree-name directory. This command is useful when
 you need to redirect lookups only for a subset of a directory's
 contents.

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

2.1  –  example

 The following command replaces the object entry .ceb.obj2 with
 a soft link whose link target is the corresponding entry in the
 directory .pjl.

 dns> replace object .ceb.obj2 with link .pjl

3  –  subtree

 Deletes the contents of a subtree that has just been merged or
 appended to a new location and replaces the information with
 soft links whose targets are the corresponding entries in the new
 location.

 SYNOPSIS

      REPLACE SUBTREE tree-name[...] [WITH] LINK newtree-name

      [EXCLUDE entry-type]

 Arguments

 tree-name

 The full name of the topmost directory in the subtree.

 newtree-name

 The full name of the topmost directory in the target subtree.

 entry-type

 One or more of the following types of entries to exclude from the
 change: objects, links, or directories. Use any combination of the
 following entry-type specifiers, separating multiple arguments with
 commas:

 objects
 links
 directory directory name

 Description

 This command is useful after you have merged or appended a subtree
 that contains clearinghouse object entries. For all entries except
 clearinghouse object entries, this command deletes the entries in
 a directory specified in tree-name and replaces them with soft
 links. These soft links redirect lookups of the names from their
 old (source) locations to their new (target) locations. Using
 this command preserves both the clearinghouse object entry and
 its enclosing directory while deleting the directory's contents
 and replacing each name with an individual soft link. The optional
 recursion notation (...) also applies the delete and replace
 operation to the contents of all child directories of tree-name.

 ACCESS RIGHTS
 You must have read, write, and delete access to the directory you
 specify as well as the contents of the directory. If you use the
 command recursively, you also need read, write, and delete access
 to all child directories (and their contents) of the directory you
 specify.

3.1  –  example

 The following command deletes the entries in the directory
 .sales.quar1 and replaces them with soft links whose targets are
 their corresponding entries in .total.quar1 .

 dns> replace subtree .sales.quar1 with link .total.quar1
Close Help