COPY

Comments

If all of the files on the command line (input and output) are in DevPPN-style syntax, the wildcards * and ? and [] may be used on both sides of the equals (e.g. COPY DSK1:*.X?[] = DSK2:*.D?[]).

COPY preserves the modification time and ownership of the source file.

COPY skips wildcarded source files that have more than one extension, and displays a warning message listing the filename. You can still copy such a files using quoted native filespecs.

Copying from read-only devices under Windows: In general, COPY will try to preserve the attributes of the source file, such as the last-modified time stamp, archive bit, etc. One notable exception is that when copying from a read-only device (like a CD), it will remove the read-only attribute from the output file. (Otherwise files copied from CD would typically need manual adjustment to remove the read-only attribute.) However, this feature only works for source devices that A-Shell can detect as being naturally read-only. If this is not the case, you can force A-Shell to recognize the device as read-only by adding the ,RO flag to the DEVICE definition in miame.ini.

COPY.LIT and MOVE.LIT are identical. Their behavior changes based on the name of the module. Both use MX_COPYFILE function to perform the operation, the only difference being that MOVE sets the CPYF_MOVE flag.

Native (quoted) filespecs may contain environment variables, e.g. "%miame%\ashlog.log"

 

Examples

The following example simply makes a copy of FILE1.NEW called FILE1.OLD, overwriting an existing FILE1.OLD if necessary.

.COPY FILE1.OLD=FILE1.NEW/D

This example copies the specified file from the SYS: directory to the current directory.

.COPY=SYS:ERSATZ.INI

This makes copy of all of the files with BAS extensions in all of the PPNs of the current device/logical unit, plus the file dsk1:direct.lst. The copies will all be in the current PPN and will all have SAV extensions.

.COPY *.SAV=*.BAS[],DSK1:DIRECT.LST

The following demonstrates the ability to create new directories as needed while copying files. It copies all of the files from DSK0:[50,*] to the corresponding PPN in DSK1:. Note that the ability to create new directories during the COPY operation is only available if you are currently logged into [1,2]. Furthermore, if the OPTIONS=STRICT setting is specified in miame.ini, then you may not create files during a COPY command outside of the current project.

.COPY DSK1:[]=DSK0:[50,*]

The following two examples illustrate the use of a quoted native operating system filespec. In the second case, it also illustrates the use of %ENV% variables.  (%MIAME% is an automatically created environment variable which points to the directory where miame.ini is located.)

.COPY "/tmp/backup of app.log" = OPR:APP.LOG

.COPY ASHELL.LST = "%MIAME%\ashlog.log"