/COPY, Fname1
, Ext1
, --
, Fname2
, Ext2
, --
, DistKey
Copies a file.
Fname1
File name to be copied and its directory path (248 characters maximum for both file name and directory). If you do not specify a directory path, it will default to your working directory and you can use all 248 characters for the file name.
The file name defaults to the current Jobname.
Ext1
Filename extension (eight-character maximum).
--
Unused field.
Fname2
File name to be created and its directory path (248 characters maximum for both file name and directory). If you do not specify a directory path, it will default to your working directory and you can use all 248 characters for the file name.
Fname2
defaults to Fname1
.
Ext2
Filename extension (eight-character maximum).
Ext2
defaults
to Ext1
.
--
Unused field.
DistKey
Key that specifies whether the copy operation is performed on all processes in distributed parallel mode (Distributed ANSYS):
1 (ON or YES) | — | The program performs the copy operation locally on each process. |
0 (OFF or NO) | — | The program performs the copy operation only on the master process (default). |
The original file is untouched. Ex: /COPY,A,,,B copies file A to B in the same directory. /COPY,A,DAT,,,INP copies the file A.DAT to A.INP. See the Operations Guide for details. ANSYS binary and ASCII files can be copied.
In distributed parallel mode (Distributed ANSYS),
only the master process will copy Fname1
.Ext1
to Fname2
.Ext2
by default. However, when DistKey
is set to 1 (or ON or YES), 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 copied to Fname2N
.Ext2
by all processes, where N
is the Distributed ANSYS process rank. For more information
see Differences in General Behavior in
the Parallel Processing Guide.