1 10/07/88 rename, rn
 2 
 3 Syntax as a command:
 4 rn arguments {-control_args}
 5 
 6 
 7 Function:
 8 The  rename request lets you rename a file on a remote host.
 9 
10 
11 Arguments:
12 file
13   file indicates the name of  the  file to be renamed and must
14   be specified in a  form acceptable  to the host on which the
15   file resides.   It must be preceded by -name (or -nm) if the
16   file name begins  with  a  "-".  It must be followed by "-at
17   CORRESPONDENT"  where CORRESPONDENT must be  the  name given
18   in  the  NIT (Network Information Table) to  the remote  UFT
19   application.   It must be enclosed  in quotes if it contains
20   spaces or  special  characters.
21 
22 
23 Control arguments:
24 -at CORRESPONDENT
25   CORRESPONDENT  must be  the  name given  in the NIT (Network
26   Information Table) to the remote UFT application.    The NIT
27   associates  to  the  UFT correspondent name  its DSA network
28   address (session_id and mailbox).
29 -billing STR
30   specifies the  accounting identification used by  the remote
31   host (not Multics); there is no default.
32 -catalogue <file_name>, -cat <file_name>
33   for a non-Multics system,  <file_name> specifies a catalogue
34   file.  The -catalogue control argument is required only when
35   the  catalogue   file  for  the  file   description  is  not
36   implicitly known.  <file_name> must be specified in a syntax
37   acceptable to  the host on  which the file  will resides; it
38   must be enclosed  in quotes if it contain  spaces or special
39   characters.
40 -new_name STR, -nwnm STR
41   STR must be the file_name of the file being renamed and must
42   be specified in  a form acceptable to the host  on which the
43   file resides.  It must be  enclosed in quotes if it contains
44   spaces  or special  characters.  If  the remote  system is a
45   Multics, the file name is an entryname.
46 -no_password, -npw
47   if  the -no_password  control argument  is present  the user
48   will  not  be  prompted  for  a  password  with a mask.  The
49   password will not be used by the remote host to authenticate
50   the submitter.
51 -password, -pw
52   if the  -password control argument is present  the user will
53   be prompted for a password with a mask.  The password may be
54   used by the remote host  to authenticate the submitter.  For
55   a remote  Multics system, the -password  control argument is
56   mandatory.  (Default)
57 -person STR, -user STR
58   STR  specifies the  remote user  identification used  by the
59   remote host  on whose behalf  the delete is  to be executed.
60   This may  be used by  the remote host  for authentication of
61   the job  submitter.  The default  is the Multics  user_id of
62   the user who submitted the request.
63 -project STR, -pj STR
64   STR specifies the project  identification used by the remote
65   host on whose behalf the delete is to be executed.
66 
67 
68 Examples:
69   In the  following  example,  the  rename request is  used to
70   rename the file cr_1 to rn_1.
71 
72      rn uft_dest>cr_1 -at dsa.MUL1.FILETRAN -nwnm rn_1