1 09/05/87  rename, rn
 2 
 3 Syntax as a command:  rn path1 name1 {...pathN nameN} {-control_args}
 4 
 5 
 6 Function:  replaces a specified segment, multisegment file (MSF), data
 7 management (DM) file, directory, link, or extended entry name by a
 8 specified new name, without affecting any other names the entry might
 9 have.
10 
11 
12 Arguments:
13 paths
14    is the pathname of a segment, MSF, DM file, directory, link, or
15    extended entry.  This argument can be "-name STR" to specify a
16    nonstandard name, such as one beginning with a minus sign or
17    containing * or <.  You can use the star convention, but it does not
18    apply to STR.
19 names
20    specifies the new name that replaces the storage system entryname
21    portion of paths.  This argument can be "-name STR".  You can use
22    the equal convention, but it does not apply to STR.
23 
24 
25 Control arguments:
26 -interpret_as_extended_entry, -inaee
27    interpret the selected entry as an extended entry type.
28 -interpret_as_standard_entry, -inase
29    interpret the selected entry as a standard entry type.
30 
31 
32 Access required:  You require modify permission on the containing
33 directory.
34 
35 
36 Notes:  Since two entries in a directory cannot have the same
37 entryname, rename takes special action if names already exists.  If the
38 entry having the entryname names has an alternate name, entryname names
39 is removed and you are informed of this action; renaming then occurs.
40 If the entry having the entryname names has only one name, the entry
41 must be deleted to remove the name.  You are asked whether you want the
42 deletion; if you answer "no," renaming does not happen.