RENAME

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.

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.