home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Phoenix CD 2.0
/
Phoenix_CD.cdr
/
02a
/
pcopy82d.zip
/
PCOPY.DOC
next >
Wrap
Text File
|
1989-12-13
|
62KB
|
1,379 lines
PCOPY 8.2d Registration Request
Thank you for your registration. It is sincerely appreciated!
--------------------------------------------------------------------
VISA/Mastercard orders are only accepted through telephone orders.
Call the Public (Software) Library at 800-242-4775 to order NOW!
--------------------------------------------------------------------
_____ Registration of all Patriquin Utilities with
program disk and User's Guide........................$45.00
When you register the below versions, you will receive registration
codes along with the latest version of the utility.
_____ PCOPY -- Advanced windowed DOS COPY alternative...$20.00
_____ PALERT -- Warns you of low disk space..............$15.00
_____ PATTR -- Manage attributes of DOS files...........$10.00
_____ PDAILY -- Automatically execute commands once/day..$10.00
_____ PDELETE -- Save space with automatic disk cleanup...$15.00
_____ PPRINT -- Advanced file print w/special formats....$15.00
_____ PSEARCH -- Advanced find files with text............$15.00
_____ PTOUCH -- Change date and time on DOS files........N/C
_____ Update a registered set with new disk and manual.
Registered users only Ser: __________ ........... $15.00
****************************************************************
Name: __________________________________________________
Company: _______________________________________________
Address: _______________________________________________
_______________________________________________
City: ________________________ State: ________ Zip: __________
I learned about the utilities from: ____________________________
If BBS indicate name and number please._________________________
________________________________________________________________
Please register the software under the following name:
____________________________________________________________
Send to: Norm Patriquin
P.O. Box 8263
San Bernardino, CA 92412
P C O P Y
-------------------------
Users Guide and Reference
-------------------------
Version 8.2d
December 1989
┌─────────┐
┌─────┴───┐ │ (tm)
│ │o │──────────────────
│ ┌─────┴╨──┐ │ Association of
│ │ │─┘ Shareware
└───│ o │ Professionals
────│ ║ │────────────────────
└────╨────┘ * Member *
Patriquin's BBS 714-369-9766
Copyright 1986, 1987, 1988, 1989 by Norm Patriquin
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin
----------------------------------------------------------------------
Table of Contents
PCOPY -- Advanced replacement for DOS COPY . . . . . . . . . . . . 1
About PCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Features: . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Command Mode Parameters . . . . . . . . . . . . . . . . . . . . 4
Setting of default parameters (DOS Environment) . . . . . . . . . 16
PCOPY Command Examples . . . . . . . . . . . . . . . . . . . . . . 16
Program Maintenance: . . . . . . . . . . . . . . . . . . . . . . . 17
Registering The Utilities . . . . . . . . . . . . . . . . . . . . 23
VISA / Mastercard / Telephone Registration . . . . . . . . . . . . 23
PCOPY Registration Request . . . . . . . . . . . . . . . . . . . . 24
Reporting Problems .............. . . . . . . . . . . . . . . . . 25
i
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 1
----------------------------------------------------------------------
PCOPY -- Advanced replacement for DOS COPY
------------------------------------------
The DOS COPY command is one of DOSs most used commands.
Unfortunately, its abilities are very limited and are not
sufficient for many disk maintenance chores performed by users.
PCOPY is similar to the DOS COPY command in that it copies file
data between disks and hard disk directories. In addition, PCOPY
is greatly superior to DOS copy in that it provides intelligent
file selection and processing options. PCOPY options allow you to
use a single PCOPY command to perform a function that would require
many DOS copy commands and much thought.
In addition to superior file copy functions, PCOPY provides a safer
way to copy files than is provided by the DOS COPY command. It
allows you to copy only newer files or update a directory with the
contents of another. PCOPY will never overlay a file accidently.
PMOVE is an option of the PCOPY command used to move files between
disks and directories on disks. PMOVE combines the functions of
DOS COPY and DELETE commands to make moving files very easy. In
addition to just moving files, PMOVE also allows selection criteria
to be specified to better qualify the files to be moved.
PMOVE automatically determines the environment the move is
requested for and then determines if the data must be moved or if
the file can be moved by renaming. Moving with rename is allowed
if the move is to another directory on the same disk device. If a
rename move can be done, it is much faster than moving the data, it
helps to keep from fragmenting disk free space, and allows very
large files to be moved between directories when they could not
normally be moved with DOS COPY because of insufficient space.
For the remaining part of this documentation we will refer to the
program as PCOPY. Remember that the only difference between PCOPY
and PMOVE is that PMOVE removes the file from the source location
after it has been successfully copied to the desired location.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 2
----------------------------------------------------------------------
About PCOPY
------------
PCOPY is developed to allow standard DOS wild card pathnames in the
source file specifications, and standard pathnames for the target
directory specification.
PCOPY attempts to anticipate your needs and help you accomplish
your task. For instance, if PCOPY determines that the target
directory name does not exist, it will ask you if it is to be
created. If you respond <YES>, the directory will be created for
you. With the /SAve option, if you are about to overlay another
file with a duplicate name, you will be asked if the older
duplicate file is to be renamed with a version number.
PCOPY keeps you out of trouble. If it saves you from overlaying a
needed file just once, it has paid for itself. Think of all the
times it might have saved you in the past.
For an immediate command summary, enter the PCOPY command without
any parameters. Help panels will be displayed.
Features:
---------
** Copies files to and from any disk or directory.
** Allows you to save older versions of files with new names
before replacing them.
** Moves files by copying them or renaming them to the new
location.
** Deletes the original file if /X is specified.
** Creates target directories if needed.
** Makes sure the DOS archive flag is set correctly for each file
as it is moved.
** Preserves the DOS date and time for each file moved.
** Allows user to pause processing at any time by pressing any
keyboard key. Once stopped, the program can be terminated by
pressing <ESCAPE>.
** Provides file selection and processing control options to
tailor the move process to your own needs.
** Allows commands to be tested so you may be sure that commands
are specified as you desire.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 3
----------------------------------------------------------------------
** Copy updated files to a special disk or directory.
** If there is not sufficient space on the current target disk,
PCOPY will allow you to place another disk in the drive and
continue processing. This allows you to easily copy groups of
files larger than disk size to other computers.
** Start with a specific file in a directory.
** End with a specific file in a directory.
** Process files based on the date stored in its directory
entry.
** Warns you before overlaying a file unless specific parameters
indicating otherwise are specified.
** Checks target disk for available space before starting to
copy files. This prevents time from being wasted when the
copy will not be able to complete.
** Gives you constant status of the progress of the command.
** Runs with windows or using standard DOS screen output.
** Format new floppy disks as they are needed by pressing <F3>
at any prompt.
** Process one directory, a single directory subtree or all
directories on a disk (/S).
** Allows you to indicate that multiple input disks are to be
used and prompts for the next one after each disk is
processed.
** Create a series of output disks filled efficiently with files
from the source location.
** DOS ERRORLEVEL set to indicate error conditions. PCOPY may be
used in .BAT files to copy files and you may confirm results
are good.
** Special Wildcard matching *DISK*.* allows you to select all
files with specific text in filename.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 4
----------------------------------------------------------------------
Command Mode Parameters
-------------------------
PCOPY allows several command parameter switches to be specified to
qualify the copy criteria. All these parameters are optional. If
no parameters are specified, PCOPY will act similar to the DOS COPY
command except that it will prompt you before overlaying any files.
The PCOPY command is used like DOS COPY except for these switches.
The command format and switch parameters are described below. A
quick review of command parameters is always available by entering
the PCOPY command without any parameters.
COMMAND FORMAT:
PCOPY from_file_spec [to_file_spec] [ (/ switches) ]
[from]
Enter the DOS file specification for the directory and file
names to be moved.
The filename portion of the file specification may contain
wild card characters documented by DOS (* and ?).
Special pattern selection of *DISK*.* may be specified.
*DISK*.* would select all files that have the chars 'DISK'
anywhere in the first portion of the filename. *DI*S*K*.*
type specification also works.
As an alternative, a file containing a list of input files may
be supplied. Create a file containing lines with a filename
or complete pathname on each line. Provide this filename as
the source filename to PCOPY and add an @ character before the
name. The list of files will be processed as if they were all
specified on the input command line.
For file list processing, PCOPY understands the output of the
DOS DIR command. You may use the DOS redirection feature to
direct DIR output to a file, edit the file to add or remove
entries, and then provide this to PCOPY as input. For
example:
DIR A: >DIRLIST
(edit dirlist)
PCOPY @DIRLIST B:
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 5
----------------------------------------------------------------------
[to]
Enter the DOS file specification for the directory and
filename to be copied to. If the "to" specification is not
entered, files will be moved to the current directory.
/A Archive - Selects only files that have been marked updated by
DOS. This flag is updated by DOS whenever a file is
processed with an intent to change or create new data.
/AP Append. All source files selected will be concatenated and
placed together in a single output file. The output file will
be given the name of the first, or only selected input file, or
the target filename specified.
/B BACKUP - When specified, the DOS Archive (Update) flag is
reset after a file has been copied.
/BA BAtch file processing. PCOPY always checks to determine if the
user has pressed a key to pause PCOPY processing. This check
can interfere with programs that store keystrokes in the
keyboard buffer for subsequent activity. The /BA parameter
sets "no-windows" mode and disables the "key press" check to
leave stored keystrokes undisturbed.
/BW Forces PCOPY to use monochrome colors even when it detects a
color display environment.
/CD:xxx
A special parameter that allows you to use the advanced
selection criteria offered by PCOPY to select files for
processing by any command of your choice. Users have
indicated they would like to select files by date, and archive
them into a file for saving. This parameter allows PCOPY to
invoke any command of your choice for each file PCOPY selects.
With this parameter, PCOPY will not copy your data, it is
simply a file selection utility.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 6
----------------------------------------------------------------------
To use this parameter you must supply the command PCOPY is to
execute. To be compatible with DOS command line option
specifications, you use special substitution characters to
build a command to your specifications. The following special
characters are used:
# -- Is replaced with the full pathname of the file to be
processed.
$ -- Is replaced with the filename of the file selected.
@ -- Is replaced with the target filename PCOPY would have
copied the file to, if the copy operation was active.
[ -- Is replaced with a single space character.
] -- Is replaced with a backslash character (\).
} -- Is replaced with a slash (/) characters. This must be
used to allow a command to include / parameters, since
PCOPY will interpret a / as one of its own parameters.
The following example shows how PCOPY can be used to drive an
EDIT command with variable parameters:
PCOPY *.c/d:)1jan89/cd:EDIT[#[}F[}pf:]log
Assuming file C:\COMP\TEST.C was selected, the following
command would result:
EDIT C:\COMP\TEST.C /F /PF:\LOG
To execute the command, PCOPY invokes a second copy of the DOS
command processor. When the /CD parameter is used, PCOPY
forces operation without windows to eliminate screen flashing
between commands.
/CF:pth
This parameter alters the meaning of the /CD parameter. When
specified with a full DOS pathname (including the filename),
it indicates that PCOPY is to write all generated commands to
the specified file. The commands will not be executed by
PCOPY. This allows you to generate a .BAT file that can be
modified and executed at a mater time.
The following sample will generate commands and place them in
batch file DOIT.BAT.
PCOPY *.c/d:)1jan89/cd:EDIT[#[}F[}pf:]log /CF:DOIT.BAT
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 7
----------------------------------------------------------------------
/C2 /C3
Specify /C2 or /C3 to use different colors when PCOPY is used
with windows operation. To make this color change permanent,
specify the parameter in the DOS environment variable.
/D: [(] [)] [=] xxx Date.
Select files based on the relationship between their last
update date and the date specified. This parameter includes a
date or number of days value.
It may also contain a operator that reverses or modifies the
use of the date specified.
When xxx contains a date, the date is compared to the last
update date of the file. The last update date of the file is
the date contained in its directory entry. The file is
selected if the condition specified by the condition modifier
is met. The condition modifier meanings are:
'(' Select files whose date is older than the date
specified.
')' Select files whose date is newer than the date
specified.
'=' Select files whose date is equal to the date specified.
If the condition operator is not specified, ')' is assumed.
Date values may be specified in any of the following formats:
MM/DD/YY MM-DD-YY DDMMMYY
/D:)12/31/80 /D:(12-31-80 /D:=31DEC80
If xxx contains a numeric value, that positive number is used
to generate a date value a number of days prior to the
current date. That date is used as in the calculation above.
Example:
/D:(1JAN86 - Process files updated prior to 1JAN86
/D:)1JAN86 - Process files updated after 1JAN86
/D:=1JAN86 - Process files updated 1JAN86
/D:(5 - Process files modified prior to 5 days ago
/D:)5 - Process files modified within the last 5 days
/D:=5 - Process files modified 5 days ago
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 8
----------------------------------------------------------------------
/D- Delete all files on target drive before starting copy.
/D2 Add files to the files already on the first output disk. Then,
delete all files from subsequent disks provided before
copying to them. Use /D2 when you want to append files to
a set of already existing disks. This parameter allows you
to continue backing up to a partially used disk and then reuse
disks already containing old unwanted backup files.
/DC Directory Copy - Causes PCOPY to create a duplicate directory
on the output disk for every directory processed on the source
disk. Directories are only created when files are processed
from them. See also the /S option. This is useful for copying
all files, and directories, from one disk to another.
/DL Same as /DC except that only the Last node of the source
directory is copied to the target pathname specified.
/DR:xxx
Use to process multiple disk drives. /DR assumes the presence
of the /S parameter causing all directories on the source disks
to be processed. For those using PCOPY for backup, this allows
PCOPY to process all disk drives with a single command.
The following command will copy all modified files from hard
drives C:, D:, and E:, to the floppy disk in drive A:. The
/D2 parameter will insure each new output disk is cleared of
all files before it is written to.
PCOPY *.* A: /DR:CDE/A/D2
/DS Same as /DC except that only the current directory level, and
all its subordinate levels, are copied to the target
directory. The target directory may contain a pathname with
multiple directory levels. In this way, you can copy one
directory structure below another directory structure.
/DX When target names are single level names with no extensions, |
PCOPY must ask if the name refers to a directory or to a new |
file to be created. This parameter indicates PCOPY is to |
assume names without extensions are new directory names. |
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 9
----------------------------------------------------------------------
/DY Sychronize source and target directory files. Before copying |
the first file to any directory, PCOPY will find any files |
existing on the target directory, but not on the source |
directory. These files will be removed from the target |
directory. Use when you want to update one directory/disk to |
be exactly like another. For example, copying one disk to |
another.
/E Select and move only files that exist on both the "from" and
"to" directories. This causes all duplicate named files to be
replaced.
/EX Designed for batch file operation. Use this parameter to
prevent PCOPY from requiring you to press a key to terminate
processing.
/F:file
First. Indicates that processing is not to start until the
specified filename is encountered in the source directory.
This parameter is most useful in restarting a move or copy
from a location where it had previously terminated.
You may specify DOS pattern name characters * and ? to
identify the file to begin processing.
/FI Fill output disks as efficiently as possible. Normally files
are copied in the sequence they are found in the source
directory. If a large file cannot be copied onto the output
disk, a new disk is requested even though there may be enough
space left on the output disk to hold other smaller files
to be copied.
The /FI parameter causes files to be copied in descending size
sequence. When a file cannot fit on the output disk, before
requesting a new output disk, PCOPY searches for another file
that will fit on the disk. When a new disk is placed in the
drive, PCOPY begins processing the larger files again.
Eventually, all files requested will be copied.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 10
----------------------------------------------------------------------
/IFA:pathname
Check to determine that the source file does not already exist
in an alternate directory before processing it. If it does
not exist, processing will continue.
Use just like IFP specified below.
/IFP:pathname
Determine the source file to be copied already exists in the
pathname specified by IFP. If it does exist, process the file.
If it does not exist skip the file.
I.E. PCOPY *.BAT \newdir/IFP:\testdir
Copies files from the current directory to \NEWDIR only if
each file already exists in \TESTDIR.
/L:file
Last. Processing is to stop after the specified filename is
encountered in the scan of the directory. The file specified
will be processed if it matches selection criteria.
You may specify DOS pattern name characters * and ? to
identify the file to begin processing.
/LG LoG PCOPY activities. PCOPY will create a disk log of all
actions it takes. Provided for those users using PCOPY as a
backup system. The log will aid the user in later locating
the disk a file has been backed up to.
The log file will be named PCOPY.LOG. For DOS versions 3.0 or
later, the log will be automatically created in the same
directory PCOPY is executed from. Other DOS versions will put
the log in the current directory.
PCOPY will create the log if it does not exist. If it already
exists, it will be added to. To begin a new log, delete
PCOPY.LOG before running PCOPY.
/M Stop screen from scrolling past the end without user
intervention (MORE).
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 11
----------------------------------------------------------------------
/ME MErge -- Works like using /U and /X parameter to move the
most current files from one directory into another. In
addition, it deletes all the files that are not moved to the
new location. This has the effect of merging the most current
files from two directories into a single directory.
/MU MUltiple input disk are to be processed. After the first
input disk is processed, the user is prompted for additional
disks. You may indicate yes to process more disks or no to
conclude processing.
/N Only move files that do not already exist on the target
directory (New files). If the file already exists, no attempt
will be made to move it.
/NA No-Archive. Only process files that do not have the DOS
BACKUP indicator set in the directory entry. This has the
affect of only processing those files that have already been
backed up. Files not backed up will not be processed.
/NP No Pause. Use when you have placed the /P parameter in the
DOS environment with the SET PCOPY=/P command, and want to
override it with no pause.
/NW No Windows - Do not use windows during processing. All screen
output will be done through standard DOS facilities.
/O:filename-list Specify a list of filename patterns that are to |
be Omitted (excluded) from PCOPY processing. If multiple |
filename patterns are specified, separate them with commas. |
For example: /O:*.BAK,*.EXE,TEST*.* |
/P Pause before each file is moved and ask for approval to
process it.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 12
----------------------------------------------------------------------
/R Replace any duplicate files on the target disk or directory.
PCOPY will replace files regardless of file dates and times.
/RD Reset Date. Normally PCOPY retains the files original date |
and time when copying it. /RD causes the new copied file to |
have the current date. |
/RE REgister the program. Use this option to register your copy
of the utility. You will need to have the registration number
and code that is sent to after you request registration.
Part of the registration screen also allows you to permanently
modify the windows option. If you do not want windows during
processing, use this option to change the windows program
option. You do not need to be registered to change this
information.
/RO Read-Only. Normally processing skips files marked with the
DOS Read-Only attribute. Using /RO causes Read-Only files to
also be selected for processing.
/S System -- If a source directory is supplied, that directory
and all subordinate directories will be processed. If no
source directory is specified, all directories on the disk
will be processed.
/SA SAve -- Instead of overlaying already existing files with
duplicate names, before the new file is copied, the file in
the target directory is renamed with a version. This insures
that no data is lost.
If the file has an extension name, the last two characters of
the extension are replaced with a number from 01 to 99
depending on the next available number. PCOPY determines the
next available number by looking in the directory for other
files with similar names.
This facility can be used to easily save versions of a file in
a directory.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 13
----------------------------------------------------------------------
/SF System Files. Normally processing skips files marked with the
DOS System attribute. Using /SF causes System files to also
be selected for processing.
/SHx File sharing options. |
Specify /SHA to ignore file sharing and copy all files. |
/SHR to allow files opened for read to be copied. |
/SHN to disallow all file sharing |
/SP Split files. /SP indicates PCOPY is to split a file between |
multiple disks if there is insufficient room on a disk to |
copy a file. |
Split file processing |
--------------------- |
You may split a file into two or more parts with PCOPY. This |
can be useful for copying files larger than individual |
diskettes will hold, or for spliting files into smaller parts |
for editing. |
PCOPY splits files and identifies the parts by placing a |
number in the 2nd character of the files extension name. |
PCOPY.EXE could be split into PCOPY.E1E and PCOPY.E2E. The |
time field of the first part of a split file holds the |
replaced extension character. For this reason, PCOPY can only |
automatically rejoin an unmodified split file. |
PCOPY will automatically join split files if they are left |
unmodified before the copy. Just reference the first part of |
the split file and the rest will be copied. You may also |
rejoin files using DOS COPY or PCOPY explicit commands on each |
part of a split file. For example: |
DOS --> |
COPY /B FILENAME.E1E+FILENAME+E2E FILENAME.EXE |
PCOPY --> |
PCOPY A:\\FILENAME.E1E,A:\\FILENAME.E2E C:\\FILENAME.EXE /AP |
/SP:nnn |
Force a file to be split at offset nnn characters into the |
file. If disk space permits, both parts of the split file |
will remain in the target directory. |
/SPL:nnn |
Force the text file to be copied to be split at line number |
nnn. See information about the /SP parameter for split file |
processing. This can be useful for breaking a file into |
parts for editing. |
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 14
----------------------------------------------------------------------
/SZ: [(] [)] nnn
Select a file based on its size. The left paren indicates
that files less than the indicated size are to be selected.
The right paren indicates to select files greater than the
size. If right or left paren are not specified, a left paren
is assumed. Following are examples.
/SZ:100 -- Select files less than 100 characters
/SZ:(100 -- Select files less than 100 characters
/SZ:)100 -- Select files greater than 100 characters
/T Test the copy process. Use this switch when you would like to
verify the PCOPY command entered is correct or to confirm the
action that will be taken by your command. No files will be
copied or changed.
/T: [(] [)] [=] xxx Time.
Select files based on the relationship between their last
update time and the time specified in the command.
The /T parameter may also contain a operator that reverses or
modifies the meaning of the date specified. This parameter
works exactly like the /D:xxx date parameter. See the
documentation for the /D parameter for a better idea of how
time is specified.
Examples:
/T:(11:20a - Process files updated before 11:20 AM
/T:(11:20 - Same as 11:20a
/T:(11:20p - Process files updated before 11:20 PM
/T:(23:20 - Same as 11:20p (military time)
/T:)11:20p - Process files updated after 11:20 PM
/T:=11:21p - Process files updated at 11:21 PM
(within the 60 second period)
/T:)1:20 - Leading zeros in hour may be omitted
/TF Test First. Works similar to the /T parameter but after test
processing is complete, PCOPY will ask you if the command is
to be executed as if the /T parameter were not present. If Y
is responded, the command will be executed and files will
actually be processed.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 15
----------------------------------------------------------------------
/U Update files. Only copy files that do not exist on the target
directory or duplicate filenames that are newer than their
counterparts on the target directory or disk.
Use of this option results in the most current version of each
selected file being at the target location.
/V Verify -- Use the DOS verify option while copying data. This
causes all data to be reread after it is written to disk to
insure it was written properly.
/WH Indicates WHy files are not selected for processing. Normally
PCOPY will not show file names not selected for processing.
/WH causes each filename not processed to be displayed with a
message indicating why it was not processed.
/WT WaiT for proper disks to be mounted before beginning
processing. This parameter is intended primarily for floppy
disk system users. Before beginning the copy process, PCOPY
will ask you to place the proper disks in the drives. This
Allows you to have PCOPY on a different disk than the disks
being processed.
/X Move files. Changes PCOPY's function to move files. It will
Delete each file from the source location after the copy is
performed. If the move is to another directory on the same
disk the directory entry for the file is moved without having
to move the data. This provides for the fastest move possible.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 16
----------------------------------------------------------------------
Setting of default parameters (DOS Environment)
-----------------------------------------------
Default parameters are parameters that do not need to be specified
each time PCOPY is started. Any PCOPY parameter may be specified
as a default parameter.
Use the DOS SET command to specify the parameter name and contents
to be used by PCOPY each time it is started. The following example
indicates that PCOPY is always to assume /U and /NW are specified:
SET PCOPY=/U/NW
Once this DOS command is issued, each subsequent use of PCOPY will
operate as if these parameters have been specified on the command
line. The SET command is most commonly placed in the AUTOEXEC.BAT
file so it may be in effect every time your machine is started.
PCOPY Example commands
----------------------
1. Copy all files in directory \GEN to directory \SAVE. Do not
overlay any file without first asking.
C> PCOPY \GEN \SAVE
2. Copy all files in directory \GEN to directory \SAVE. Replace
any already existing file with newer files only.
C> PCOPY \GEN \SAVE/U
3. Copy all *.BAT files from current directory to \SAVE
C> PCOPY *.BAT \SAVE or PCOPY *.BAT \SAVE\*.*
4. Move all files in current directory to disk in drive A:
C> PMOVE *.* A:/X
5. Search hard disk C: for any files ending with .WKS and move
all the files to a new directory named \WKSDIR.
C> PCOPY c:*.* c:\WKSDIR /X/S
5. Backup all files on hard disk C: to multiple floppy disks on
drive A:.
C> PCOPY *.* a: /S/A/B/DC
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 17
----------------------------------------------------------------------
Program Maintenance:
--------------------
Version 1.0 May 1986
-- Multiple file move/copy utility with /U /N and /R parameters.
Version 2.0 June 1986
-- Added ability to create directory and detect full disks.
Version 3.0 August 1986
-- Window operation added.
-- Improved help.
-- /B /DC /D- /E /RE /S /SA /SF /V
Version 4.0 August 18, 1986
-- /ME /SF /RO parameters added.
Version 5.0 October 13, 1986
-- Added /MU parameter to process multiple input disk volumes.
-- Various documentation corrections. Special thanks to Edward
Koch for technical editing of the document.
-- Added selection by size with /SZ:nnn
-- Suspend and execute a DOS command from any question or prompt.
Press <F3> to accomplish this. This is particularly useful to
format new floppy disks when new ones are needed.
-- Process a directory tree if /S is specified and a directory
name is supplied in the source specification. Previous
releases would only process a single directory, without /S, or
the entire disk with the /S parm.
Version 5.1 November 5, 1986
-- Added complete capability to rename files using DOS global
characters ? and * in source and target specification
-- Extended ability to copy and create new directories.
-- Allow to copy a directory structure below another structure.
-- If directory copy specified /DC and the target directory also
has a pathname, the source path is added to the target path.
-- Ability to copy a single directory node below an already
existing directory structure. Use /DL.
-- Ability to copy a complete directory substructure with a
single command.
-- When /R (replace) specified, print messages indicating if
processed files are newer, older or duplicates of overlaid
files.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 18
----------------------------------------------------------------------
Version 6.1 June 27, 1987
-- Added /IFP and IFA command line parms to control file
selection based on a duplicate filename being present or
absent in another directory.
-- Added /WHy parameter to cause PCOPY to show why files were not
copied.
-- Added /NS to allow PCOPY to run with No Sounds (Beeps)
-- Added /BA to allow PCOPY to be used without intervention in
DOS .BAT files. The keyboard buffer is not checked for a key
to stop processing so keyfake can be used and a no windows
mode is used.
-- A SET PCOPY= environment specification may be specified with
command parameter variables to allow you to have parameters
active during every use of PCOPY without having to specify
them.
Example:SET PCOPY=/WH/U/NW
-- When large files are being copied PCOPY will now show the
number of characters copied as the file is processed. This is
in window mode only.
-- Shows date and time for each file copied
-- No window mode now shows count of files processed
Version 6.5 September 14, 1987
-- /NP parameter added so users coupe put the /Pause parameter in
their environment variable and still override it when needed.
/NP = No Pause
-- When in windows mode, intercept the DOS interrupt handler to
neatly display a window with
RETRY CANCEL FAIL ABORT
failed I/O attempt.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 19
----------------------------------------------------------------------
Version 6.7 October 26, 1987
-- F3 key to exit to DOS was locking up the system when used in
non-windows mode. Corrected.
Version 7.0 February 22, 1988
-- /FI parameter added to FIll output disks most efficiently.
This process moves largest files first, followed by smaller
files until a disk is full or no files remain to be copied
that can fit on the output disk.
-- /DS added. Like /DC, only the directory and all its
subordinates are copied below the specified target directory
specification. This allows directory structures to be moved
below other directory structures.
-- /TF command parameter added. This causes PCOPY to ask if the
live command is to be started after a test is completed. Good
for .BAT files.
-- PCOPY locked the system if a command was entered that
contained an error.
-- Border color is no longer set as it caused CGA users problems.
-- /D- parm to delete all files on target drive did not work when
target drive letter is larger than B:
Version 7.1 March 16, 1988
-- FIX - /Omit parameter did not work when /S was also used
Version 7.2 March 25, 1988
-- Added capability to process a list of files by specifying an
input filename as a list file. Precede with @.
Version 7.3 April 20, 1988
-- If file to be copied has Hidden or System attribute, make sure
the resulting target file also has the same attribute.
Version 7.4 May 15, 1988
-- Allow multiple input file specifications to be processed with
the @filename option.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 20
----------------------------------------------------------------------
-- Add /AP (append) option to allow multiple files to be copied
to a single output file.
Version 7.5 May 29, 1988
-- /F: and /L: parameter modified to accept DOS wild card
characters.
Version 7.6 September 2, 1988
-- Support replacement of DOS read only files
-- Turn off NOVELL share attribute when creating files. It was
causing a create error when creating a file.
Version 7.7 November 6, 1988
-- /NA parameter added to allow files with the DOS archive bit on
to be bypassed for processing.
-- When /S /DC /MU specified and source dir of A:\ was also
specified, PCOPY attempted to process the incorrect directory
on the second disk and failed.
-- Add /LG parameter to create PCOPY log file. See /LG parameter
for more details.
-- Added /WT parameter for floppy disk systems to cause PCOPY to
wait for proper disks to be placed in drives before beginning
processing.
-- Removed limit of the number of directories that PCOPY is able
to process.
-- Added PCOPY command text to bottom window of processing
screen.
-- Added /EX command parameter to cause PCOPY to end without
requiring the user to press a key. Designed for PCOPY .BAT
file usage.
-- Added /C2 and /C3 command parameters to provide alternative
color screen displays.
Version 7.72 January 1, 1989
-- Directory search error corrected When dir is empty dir
B:\*.*\DIRNAME\*.* returned Corrected
-- Filelist can contain wildcards that are fully processed.
-- Add ability to select files by time of day last updated. See
/T: parameter documentation
Version 7.8 February 14, 1989
-- Added ERRORLEVEL condition setting. May be tested when PCOPY
completes to determine if an error occurred during PCOPY
processing.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 21
----------------------------------------------------------------------
-- Special wildcard pattern matching capability added. *DISK*.*
will select all files that have the chars 'DISK' in the
primary part of the filename. *DI*S*K*.* also works.
-- /DS parm corrections. Did not work without /S also specified.
-- Command line shown on screen was incorrect after /TF
specified.
-- /D2 parm added. Append to first output disk and clean all
subsequent output disks. Good for backup.
Version 7.81 February 20, 1989
-- Corrected OMIT /O feature. It did not work in 7.8.
-- Added /BW parameter to support black and white on color
screens.
-- When /tf (test first) is used, only prompt to continue if test
processing found files to process.
-- Added message to indicate PCOPY was deleting files from the
target disk as a result of the /D-or /D2 parameters
Version 7.83 April 1989
-- print a message when @ input file list entry has no matching
filenames to process.
-- Correct display of filenames that have special characters in
them.
-- Allow F3 to exit to DOS from the HELP screens
-- NEW! /DR:xxx parameter to allow multiple input drives to be
processed.
-- NEW! /CD:xxx parameter to allow PCOPY selection criteria to be
used to select files for processing by another command.
Version 7.84 May 11, 1989
-- Correct system lockup problem when /DR:ddd specified
-- Attributes in window were sometimes incorrect
Version 7.85 July 4, 1989
-- @ filename input filelist processing was getting errors
when attempting to process directories that contained
subdirectories.
Version 7.86 July 8, 1989
-- Error moving readonly files over other readonly files
-- When /NW and /TF specified, window still flashed on screen.
Version 7.87 July 23, 1989
-- Do not print banner for registered users.
-- Support special chars such as ä for international users
-- Revised help panels work faster and provide options to restore
original screen on exit or leave help screen on display when
exiting.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 22
----------------------------------------------------------------------
Version 8.0 November 26, 1989
-- PCOPY was ported to the TURBOC compiler.
-- /RD parameter to allow files to have current date after copy.
-- /SP /SPL parameters added to support splitting large files
into multiple parts.
-- /DX parameter added to force PCOPY to assume names without
extensions are directory names.
-- /DY added to sychronize source and target directories.
-- PCOPY will automatically attempt to begin formatting target
disks that are not formatted.
-- Code change to support specification of directory names with
extensions.
-- Other maintenance and corrections/improvements.
-- /Omit /SAve /MErge changed from bonus to normal features.
-- /SP /SPL /DY implemented as bonus features.
-- Registration fee increased from $15 to $20.
Version 8.0b November 27, 1989
-- Restore cursor after x exit from help
-- Correct help border in monochrome
Version 8.1 November 29, 1989
-- Auto format start removed
-- Added /SHN /SHA /SHR file sharing options
Version 8.2 December 5, 1989
-- Stop processing if insufficient memory
-- Fix split file processing to disks.
-- Correct window error in /NW mode
-- Other smaller corrections
Version 8.2c December 10, 1989
-- fix-deleting readonly file after move
-- fix-DOS command screen to keep command for next use
-- fix-screen attributes on DOS command execution
-- fix-log, garbage in command request message
-- fix-log, disk count is off
-- fix-/More to stop at end of each page
-- Change /O omit feature to accept a list of filename patterns
Version 8.2d Dec 13, 1989
-- Move to existing dir on another drive left the current
directory on the target drive incorrectly set.
-- Move of file to itself caused deleted file.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 23
----------------------------------------------------------------------
Registering The Utilities
-------------------------
PCOPY is distributed under the Shareware concept. This allows users
to evaluate software for a short time to determine if it is useful
to them. If you decide the software is of value to you, you are
required to register it.
This concept allows for quality software to be distributed at a
reasonable cost. Hundreds of hours of my time has been invested in
PCOPY. Continued registration will justify the continued upgrading
of this utility to insure it remains up to date with current
technology. In any case, I do greatly appreciate all users that
care enough to register. I try to provide the best possible
software for all you faithful supporting users.
You may use the order form on the next page when registering PCOPY.
Send registration requests to:
Norm Patriquin
P.O. Box 8263
San Bernardino, CA 92412
The registration charge is a one time fee that entitles you to all
future versions of the product. These may either be obtained from
normal Shareware sources or from me. I do not automatically send
product updates to registered users. It is impossible to provide
automatic upgrades at the low costs of these utilities.
Site Licenses
-------------
I do welcome organizations to Site License one or more utilities at
a reduced cost. Site Licenses allow you to be confident that all
users in your organization are using authorized versions of the
utilities. If you are interested in site licensing, indicate your
interest on the registration form.
VISA / Mastercard / Telephone Registration
------------------------------------------
You may place a telephone order for the utilities using your credit
card by calling Nelson Ford's Public (Software) Library.
Telephone orders: 800-242-4775
The PSL supplies Shareware software at a nominal cost to its
customers. Consider them for all your Shareware needs.
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 24
----------------------------------------------------------------------
PCOPY 8.2d Registration Request
Thank you for your registration. It is sincerely appreciated!
VISA/Mastercard orders are only accepted through telephone orders.
Call the Public (Software) Library at 800-242-4775 to order NOW!
_____ Registration of all Patriquin Utilities with
program disk and User's Guide........................$45.00
When you register the below versions, you will receive registration
codes along with the latest version of the utility.
_____ PCOPY -- Advanced windowed DOS COPY alternative...$20.00
_____ PALERT -- Warns you of low disk space..............$15.00
_____ PATTR -- Manage attributes of DOS files...........$10.00
_____ PDAILY -- Automatically execute commands once/day..$10.00
_____ PDELETE -- Save space with automatic disk cleanup...$15.00
_____ PPRINT -- Advanced file print w/special formats....$15.00
_____ PSEARCH -- Advanced find files with text............$15.00
_____ PTOUCH -- Change date and time on DOS files........N/C
_____ Update a registered set with new disk and manual.
Registered users only Ser: __________ ........... $15.00
****************************************************************
Name: __________________________________________________
Company: _______________________________________________
Address: _______________________________________________
_______________________________________________
City: ________________________ State: ________ Zip: __________
I learned about the utilities from: ____________________________
If BBS indicate name and number please._________________________
________________________________________________________________
Please register the software under the following name:
____________________________________________________________
Send to: Norm Patriquin
P.O. Box 8263
San Bernardino, CA 92412
PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 25
----------------------------------------------------------------------
Reporting Problems (PCOPY 8.2d)
I welcome all comments or enhancement suggestions. Please document
each item clearly and provide printed examples, if possible. Please
be sure to include this form with all requests. It will help to
make sure we can provide you with the best possible service.
Name: __________________________________________________________
Company: _______________________________________________________
Address: _______________________________________________________
_______________________________________________________
City: __________________________________ State: _______________
Zip: ______________________________
Telephone: _______ / ________________________ (Home / Work)
Date: _________________________ Machine Type:_______________
Name of Utility: _______________________ DOS Level: ____________
Description of problem or enhancement:
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
Suggested solution:
________________________________________________________________
________________________________________________________________
