1 03/31/83  l_rename, lren
 2 
 3 Syntax:  lren path1 name1 {pathN nameN}
 4 
 5 
 6 Function:  replaces specified ring 1 segment and multisegment file
 7 names by specified new names without affecting any other names the
 8 entry might have.
 9 
10 
11 Arguments:
12 path1
13    specifies the old name that is to be replaced; it can be a pathname
14    or an entryname.  The star convention is allowed.
15 name1
16    specifies the new name that replaces the storage system entryname
17    portion of path1.  The equal convention is allowed.
18 
19 
20 Notes:  Execute access to the installation_tools_ gate is required.
21 
22 The access mode of the user with respect to the directory specified by
23 path1 must contain the modify attribute.
24 
25 Since two entries in a directory cannot have the same entryname,
26 special action is taken by this command if name1 already exists in the
27 directory specified by path1.  If the entry having the entryname name1
28 has an alternate name, entryname name1 is removed and the user is
29 informed of this action; the renaming operation then takes place.  If
30 the entry having the entryname name1 has only one name, the entry must
31 be deleted in order to remove the name.  The user is asked if the
32 deletion should be done; if the user answers "no," the remaining
33 operation does not take place.