MPE/iX Commands Reference Manual (32650-90877)

410 Chapter11
Command List IX
Commands RECALL/=RECALL thru RUN
MPE Files To rename an MPE file, you must have DD access to the source MPE group
and CD access to the target MPE group. If you specify groupname or
acctname, you must have save access to the group or account. Users with
System Manager (SM) capability can rename any file to any location on
the system.
You can use RENAME to move native mode MPE files to HFS directories. You
cannot move compatability mode MPE files to HFS directories. For
example, you can use RENAME with KSAM/XL files, but you cannot use it
to rename MPE V/E KSAM files.
To successfuly rename a file across group or account boundaries, you must
move it within a single volume set and that volume set must be physically
mounted.
When you use RENAME to move a file that does not have an ACD to a
directory or to another account, an ACD is automatically created for the
file to ensure that it is protected by the appropriate file access matrix of its
new location.
HFS Files To rename a file in an HFS directory, you must have delete directory entry
access (DD) to the old directory and create directory entry access (CD) to
the new directory.
Files in HFS directories can be renamed to files in the MPE account group
structure, and they can be renamed to files in other HFS directories.
You cannot rename a directory. If either
oldfilereference or
newfilereference is actually a directory, you will get an error.
Spool Files If you have access to spoolfiles, you can rename them. In this case, the
name of the file changes, but the contents and links to the spooler remain
the same.
Use
This command may be issued from a session, a job, a program, or in BREAK. Pressing
Break has no effect on this command.
Examples
Since temporary files exist only for the duration of your current job or session, their fully
qualified file names correspond to your logon group and account. The following example
shows the command entry to change the name of a temporary file from OLDFILE to
NEWFILE, and reassign it to the group NEWG.
RENAME OLDFILE,NEWFILE.NEWG,TEMP
To change the lockword of the permanent file FILE2 from LOCKA to LOCKB, enter:
RENAME FILE2/LOCKA,FILE2/LOCKB
To transfer a file from one group to another within the same account, use the RENAME
command, simply naming the new group in the second parameter. You must have SAVE
access to GROUP2 and both groups must be in the system domain or reside on the same
volume set. For example, to move the file MYFILE from GROUP1 to GROUP2, enter: