HP 3000 Manuals

HP 3000 Series 9X8LX Computer Systems Commands Reference

RENAME 

The RENAME command changes the system identification for a file.  You can
use this command to change the name of a file, to move a file from one
group to another, or to change the lockword. 

Syntax 

RENAME oldfilereference,newfilereference[,TEMP]

Parameters 

oldfile- reference    Specifies the current name of the file.  The form
                      of oldfilereference consists of the following
                      elements:

                           filename[/lockword][.groupname[.acctname]]

                      If you specify acctname, the logon account must
                      belong to you; you must be the creator of the file
                      to rename it.

newfile- reference    Specifies the new name of the file in the same
                      format as oldfilereference.  If you specify
                      acctname, the logon account must belong to you.  If
                      you specify groupname, you must have SAVE access to
                      the group name.  If you omit acctname and/or
                      groupname, the logon account and/or group are
                      assumed.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break does not affect this command.

   *   Requirements 

       To rename a file, you must be the file's creator and must have
       exclusive access to the file.  You cannot rename files that exist
       in other accounts, unless you have system administrator
       capability.  This applies to both MPE and HFS files.  To copy
       files that exist in other accounts, use the FCOPY command.

   *   Restrictions 

       You cannot use this command for compatibility mode KSAM files,
       because there are internal linkages between the key information
       and the data files, however, you can use this command to rename
       KSAM MPE/iX files.

   *   Renaming spool files 

       The RENAME command renames spool files if you have access to them,
       but only for spool files that are not linked to the spooler print
       queues.

Examples 

   *   To change the name of a file named OLDFILE to a file named
       NEWFILE, enter:

            :RENAME OLDFILE,NEWFILE 

   *   To change the lockword of the file FILE2 from LOCKA to LOCKB,
       enter:

            :RENAME FILE2/LOCKA,FILE2/LOCKB 

   *   To move a file from GROUP1 to GROUP2 within the same account,
       enter:

            :RENAME MYFILE.GROUP1,MYFILE.GROUP2 

       To apply the command as shown above, you must have save access to
       the group named in the second parameter (GROUP2).  Also, both
       groups must reside in the system.

Related Commands 

     COPY
     LISTFILE
     LISTSPF
     PURGE

MPE/iX 5.0 Documentation