/COPY
/COPY, Fname1, Ext1, --, Fname2, Ext2, --, DistKey
Copies a file.
Fname1File 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.
Ext1Filename extension (eight-character maximum).
--Unused field.
Fname2File 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.
Fname2defaults toFname1.Ext2Filename extension (eight-character maximum).
Ext2defaults toExt1.--Unused field.
DistKeyKey that specifies which copy operation is performed on all processes in distributed-memory parallel mode :
0 (OFF or NO)
—
The program performs the copy operation only on the master process (default).
1 (ON or YES)
—
The program performs the copy operation locally on each process.
2 or BOTH
—
The program performs the copy operation for
Fname.Exton the master process and forFnameN.Exton all processes.
Notes
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. Mechanical APDL binary and ASCII files can be copied.
In distributed-memory parallel (DMP) mode, only the master process will copy
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 copied 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.