/RENAME
/RENAME, Fname1
, Ext1
, --
, Fname2
, Ext2
, --
, DistKey
Renames a file.
Fname1
The file to be renamed. You can also include an optional directory path as part of the specified file name; if not, the default file location is the working directory.
File name defaults to the current Jobname.
Ext1
Filename extension (eight-character maximum).
--
Unused field.
Fname2
The new name for the file. You can also include an optional directory path as part of the new file name; if not, the default is the working directory. A maximum of 248 characters is allowed for the file name (or combined file name and directory path, if both are specified).
Fname2
defaults toFname1
.Ext2
Filename extension (eight-character maximum).
Ext2
defaults toExt1
.--
Unused field.
DistKey
Key that specifies which rename operation is performed on all processes in distributed-memory parallel mode:
0 (OFF or NO)
—
The program performs the rename operation only on the master process (default).
1 (ON or YES)
—
The program performs the rename operation locally on each process.
2 or BOTH
—
The program performs the rename operation for
Fname
.Ext
on the master process and forFnameN
.Ext
on all processes.
Notes
Renames a file. Ex: /RENAME,A,,,B renames file A to B in the same directory. /RENAME,A,DAT,,,INP renames file A.DAT to A.INP. On all systems, this command will overwrite any existing file named B. See the Operations Guide for details. Only Mechanical APDL files should be renamed. Use /SYS and system renaming commands for other files.
In distributed-memory parallel (DMP) mode, only the master process will rename
Fname1
.Ext1
to
Fname2
.Ext2
by default. However, when
DistKey
is set to 1 (or ON, or YES) or 2 (or BOTH), the command is
executed by all processes. In this case, Fname1
and
Fname2
will automatically have the process rank appended to them.
This means Fname1N
.Ext1
will be renamed to
Fname2N
.Ext2
by all processes, where
N
is the DMP process rank. For more information see Differences in General Behavior in the Parallel Processing Guide.
Renaming across system partitions may be internally done by a copy and delete operation on some systems.
This command is valid only at the Begin level.