C O P


Enhanced File Copy Utility

by

Jeff R. Fontanesi




Version 1.0
September, 1988

(C) Copyright Jeff R. Fontanesi, 1988





Table of Contents




About COP ............................................... 1

How To Use COP .......................................... 3

Command Line Options .................................... 4

Examples ................................................ 7

Registering COP ......................................... 9

COP Registration Form .................................. 11

COP Problems/Enhancements Form ......................... 12






































COP Version 1.0 - User's Guide page i





About COP



Why COP? What's wrong with the DOS COPY command? If all you
ever need to do is copy one file or copy all the files on a
disk from one place to another, COPY is fine. If you're tired
of seeing "Disk full" when copying from your hard disk to
floppies, if you've ever lost an important file by copying
over it with a file of the same name, if you hate the two step
process of copying and erasing when you want to move files or
if you just want to copy a few files that don't match any
obscure wildcard (* or ?) pattern, COP can help.

First of all, COP is fast. It's up to twice as fast as other
copy programs and unnoticeably slower than the DOS COPY
command. It's also small and takes up less than 20k on a
disk.

Before COP, if you wanted to copy all the files in a directory
on your hard disk to floppy disks, and there was not enough
space on one floppy disk, you had to use BACKUP. With COP you
can fill up as many floppies as you own. When one fills up,
COP will tell you, ask you to insert another diskette and
continue.

COP warns you before you copy over a file with the same name
and gives you the options of overwriting, renaming or skipping
the file. The sizes, dates and times of the files are
displayed to help you decide what to do. You can also turn
this feature off and COP will automatically overwrite, rename
or skip files with the same name without stopping to ask.

With COP you can move files quickly and easily. To move a
file with DOS you have to copy it and then erase the original.
COP does this for you in one step. If you move a file from
one directory to another on the same drive, COP simply renames
the file to put it in the new directory. Moving files this
way is very fast because no data has to actually be moved.
This also allows very large files to be moved without running
out of disk space.

Instead of copying each file individually when you have
several files to copy that don't match any wildcard pattern,
you can tell COP to prompt you for each file. COP will show
you the name, size, date and time of each file and ask you if
you want to copy it.

If you want to copy just the first few files or the last few
files or some in the middle of a directory, you can with COP.
COP lets you specify a first and last file to begin and end
copying with respectively.




COP Version 1.0 - User's Guide page 1





COP even lets you copy or move files based on their times and
dates. You can tell COP to copy files with dates and/or times
equal to, before, after or not equal to a specified date
and/or time.

COP also features on-line help. This means you don't have to
keep this manual on your desk. If you don't remember how to
use one of COP's options, help is available at any time. Just
type COP with no parameters at the DOS prompt, press return
and help will be displayed.

When COP completes a task, it displays the total number of
bytes copied or moved. If files are moved from one directory
to another on the same disk, the total number of bytes shown
will be zero. This is, as explained above, because no data
has actually been moved.

A file named MOV.BAT is provided with COP to make it a little
easier to move files. MOV just calls COP and adds the move
(/M) option to whatever you've told COP to do.

COP is not just short for COPY. COP is like a cop. COP will
be watching you and helping you to stay honest. COP will help
to protect you from making silly mistakes or doing anything
harmful or illegal. Well, that's what cops are supposed to do
anyway.






























COP Version 1.0 - User's Guide page 2





How To Use COP



If you've ever used the DOS COPY command, you already know how
to use COP. If you don't specify any command line options
(described in the next section) COP works just like COPY, but
with added safety.

The format is:

COP [d:][path]source [d:][path][target] [options]

Where:
[] Items in square brackets are optional.
d: Drive letter.
path DOS path name (directory name).
source The name of a file (or wildcard pattern) to be
copied from. If a drive and/or path is given
with no "source", *.* is assumed.
target The name of a file (or wildcard pattern) to be
copied to. If no drive or path is given, the
current directory is assumed.
options parameters that allow the extra features of COP
to be used (described in the next section).


Note that for the remainder of the document the word "process"
will be used to mean copy or move.



























COP Version 1.0 - User's Guide page 3





Command Line Options



There are two types of command line options; single letter
options and options that require a following parameter.
Options consist of a "/" character followed by the option
letter. Options can be separated by a space or can be stacked
(entered together) following a single "/".

For example, to use parameters A, O and P use:

COP source target /A /O /P
or
COP source target /AOP

An example of the type of option that requires a following
parameter is the date option. Its format is this:

COP source target /D A9-1-88
or
COP source target /DA9-1-88

When using both types together, the format is:

COP source target /A /O /P /D A9-1-88
or
COP source target /AOPDA9-1-88

Note that the last option above could not be followed
immediately by another option. For example, if you put the P
option at the end:

COP source target /AODA9-1-88P is incorrect
but
COP source target /AODA9-1-88 /P is OK



The following is a list of the options available with COP and
how to use them. All of the command line options can be
entered in either upper or lower case. You can use as many of
these options at a time as you want. The only limits are the
DOS limit of 128 characters on a command line and some of the
options are mutually exclusive.


/A The ASK option
Ask for confirmation to copy or move each file. Before
each file is processed, COP displays the message:
COPY (Y/N)?
If Y is pressed, the file is processed and if you press N,
obviously, the file is skipped.



COP Version 1.0 - User's Guide page 4






/D ABENmm-dd-yy The DATE option
Allows the selection of files based upon their date. When
you look at a directory of files, the date next to a file
is the date of the file's creation or last update. Select
one letter from A,B,E or N. They represent:
A = After
B = Before
E = Equal to
N = Not equal to
mm-dd-yy = month, day and year (the dashes are required)
For example:
/D A9-1-88 -- Select files dated after September 1, 1988
/DN3-12-87 -- Select files not dated March 12, 1987


/F filename FIRST file option
This tells COP to start processing when this "filename" is
found. The file "filename" will be included in the files
processed. This can be very handy when you want to copy
just the last few files in a directory.


/L filename LAST file option
This tells COP to stop processing after this file is
processed. The file "filename" will be included in the
files processed. This is useful when you want to copy just
the first few files in a directory. Used together with the
FIRST (/F) option, you can copy just the files in the
middle of a directory.


/M MOVE option
Tells COP to move the files. This means one of two things.
If the "source" and "target" are on different drives, the
source files are copied to target and then the source files
are deleted. If the source and target are on the same
drive, the files are simply renamed with the target path.
This allows for very fast moves because no data is moved.


/O OVERWRITE option
This option tells COP to overwrite files with the same name
without asking. Without this option, when a file of the
same name is about to be overwritten, you are asked whether
to overwrite, rename or skip the file.


/P PAUSE option
Causes COP to pause when the screen is full. This keeps
the output from scrolling off the screen before you've had
a chance to see it.




COP Version 1.0 - User's Guide page 5





/R RENAME option
Tells COP to rename files with the same name without
asking. Without this option, when a file of the same name
is about to be overwritten, you are asked whether to
overwrite, rename or skip the file. The target files are
renamed by changing the first character to a "#". If a
file with this new name exists, COP will keep trying with
different characters until the file is renamed.


/S SKIP option
This option tells COP to skip files with the same name
without asking. Without this option, when a file of the
same name is about to be overwritten, you are asked whether
to overwrite, rename or skip the file.


/T ABENhh:mmAP The TIME option
Allows the selection of files based upon their time. When
you look at a directory of files, the time next to a file
is the time of the file's creation or last update. Select
one letter from A,B,E or N and select A or P for AM or PM.
They represent:
A = After
B = Before
E = Equal to
N = Not equal to
hh:mm = hours and minutes (the colon is required)
A = AM
P = PM
For example:
/T A1:30P -- Select files with time after 1:30pm
/TN8:12A --- Select files with time not equal to 8:12am























COP Version 1.0 - User's Guide page 6





Examples



For the following examples, assume the current directory is
C:\DIR1\DIR2. If more than one example is shown for a given
task, the first shows the long way and the rest are shortcut
examples.


To get help:

COP


To copy a file from the current directory to drive A:

COP file.ext a:


To copy a file from drive A to the current directory:

COP a:file.ext


To copy all files from the current directory to drive A:

COP *.* a:
or
COP . a:


To copy all files from drive A to the current directory:

COP a:*.*
or
COP a:


To move a file from the parent directory to the current
directory:

COP c:\dir1\file.ext /M
or
COP ..\file.ext /M


To move files from the current directory to drive A with
prompting for each file:

COP *.* a: /M /A
or
COP . a: /MA



COP Version 1.0 - User's Guide page 7






To copy all files created or changed on September 12, 1988
before 3:00pm from the current directory to drive A:

COP *.* a: /D E9-12-88 /T B3:00P
or
COP . a: /DE9-12-88 /TB3:00P


To move files from the parent directory to the current
directory, automatically renaming files with the same name in
the current directory, starting with the file FILE1.EXT,
ending with the file FILE2.EXT and pausing when the screen is
full:

COP c:\dir1\*.* /M /R /F file1.ext /L file2.ext /P
or
COP .. /MRFfile1.ext /Lfile2.ext /P
or
COP .. /MRPFfile1.ext /Lfile2.ext




































COP Version 1.0 - User's Guide page 8





Registering COP



COP is made available to you as SHAREWARE. SHAREWARE is not
public domain software, nor is it free software. It's more
like try-before-you-buy software.

As a nonregistered user, you are granted a limited license to
make an evaluation copy of COP for trial use on a private,
noncommercial basis for the purpose of determining whether COP
is suitable for your needs. At the end of this trial period,
you should either register your copy of COP or discontinue
using it.

What all this means is I'm asking you to be honest. If you
like this program and use it on a regular basis, then you
should pay for your copy. This helps us both. With your
financial support, I can stay in business and provide you with
support, future enhancements and updates.

Registering COP entitles you to use the program on any and all
computers available to you with the restriction that if other
people have access to this program, you should purchase a site
license. The cost of a site license will be based upon the
number of users and must be arranged by contacting me. Please
write for details.

This license does not include distribution or copying of this
software package:
1. In connection with any other product or service.
2. For general use within a company or institution.
3. For any consideration or fee.
4. Distribution in modified form. That is, the files
included in this package:
COP.COM --- The COP enhanced copy utility.
COP.DOC --- This documentation.
MOV.BAT --- Batch file for quick file moves.
must not be altered in any way.

Operators of electronic bulletin board systems (sysops) are
encouraged to post COP for downloading by their users as long
as the above conditions are met.

If you are a distributor of a public domain or user-supported
software library, you may be eligible to distribute copies of
COP. You must meet all of the above conditions and acquire
written permission from me before doing so. Please write for
details.

To register the program, $10.00 is requested. If you would
like the latest version of COP on disk and a printed manual,
send $20.00.



COP Version 1.0 - User's Guide page 9





Send registration requests to:

Jeff R. Fontanesi
1770 Sherry Ln., #89
Santa Ana, CA 92701


If you have questions, comments or suggestions, I can also be
contacted on:

Compuserve - 74017,1650
Genie - FONTJR
Various Southern California BBS's



DISCLAIMER

Use of this program acknowledges this disclaimer of warranty:

This program is supplied as-is. I, Jeff R. Fontanesi,
disclaim all warranties, expressed or implied, including,
without limitation, the warranties of merchantability and of
fitness of this program for any purpose. I assume no
liability for damages direct or consequential, which may
result from the use of this program.






























COP Version 1.0 - User's Guide page 10





COP Registration Form


**************************************************************

Registration only ..................... ___ Copies @ $10.00

Registration with disk and manual ..... ___ Copies @ $20.00

Site license .............................. Write for details

Total ___________

**************************************************************

Name _________________________________________________________

Company ______________________________________________________

Address ______________________________________________________

______________________________________________________________

City ________________________________ State ____ Zip _________

Telephone (____) ____________________ (Work Home)

**************************************************************


I obtained my copy of COP from:

______________________________________________________________

If BBS, please indicate name and number:

______________________________________________________________


Send this form to:

Jeff R. Fontanesi
1770 Sherry Ln., #89
Santa Ana, CA 92701


Thank you for your support.









COP Version 1.0 - User's Guide page 11





COP Problems/Enhancements Form


If you have a problem using this program or if you have any
comments or suggestions, I would appreciate your telling me
about them. I welcome feedback of any kind. With your
suggestions, you can help to make COP a better, more useful
program.


Name _________________________________________________________

Company ______________________________________________________

Address ______________________________________________________

______________________________________________________________

City ________________________________ State ____ Zip _________

Telephone (____) ____________________ (Work Home)


Description of problem, comment or suggestion:

______________________________________________________________

______________________________________________________________

______________________________________________________________

______________________________________________________________


Suggested solution:

______________________________________________________________

______________________________________________________________

______________________________________________________________

______________________________________________________________


Send this form to:

Jeff R. Fontanesi
1770 Sherry Ln., #89
Santa Ana, CA 92701






COP Version 1.0 - User's Guide page 12