CopyMaster 1.12

Copyright 1988 by New-Ware


(tm)
MEMBER

Association of
Shareware
Professionals



This program is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that the
shareware principle works for you. If you are unable to resolve a
shareware-related problem with an ASP member by contacting the
member directly, ASP may be able to help. The ASP Ombudsman can
help you resolve a dispute or problem with an ASP member, but does
not provide technical support for members' products. Please write
to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a
Compuserve message via easyplex to ASP Ombudsman 70007,3536.


REGISTRATION

CopyMaster is sole property of New-Ware Shareware products.
The Shareware version may be freely copied and transferred to
individual parties for evaluation purposes. It may be posted on
Bulletin Board systems (BBS) for electronic access as long as NO
FEE is charged for its distribution. Computer information
services such as Compuserve (CIS), Genie, etc., are authorized to
post this product for subscriber access. CopyMaster may NOT be
distributed on diskette by any disk distributor/vendor who
charges more than $5.00 for the diskette upon which the program
and attendant files are recorded.

CopyMaster is a Shareware product. Shareware is a computer
program distribution/marketing method that permits potential
buyers to thoroughly try the program prior to purchase. It is
NOT free. If, after evaluating the program, you find it to be
useful enough to use it on a regular basis, you are expected to
pay for it by registering with New-Ware. The registration fee is
$30.00 and the registered version, which is NOT distributed as
Shareware, will not contain the opening Shareware screen nor the
closing messages.

You may register CopyMaster in one of three ways:

1) By mail with check or money order to:

New-Ware
6198 Agee Street #71
San Diego, CA 92122

2) By telephone with Visa/Mastercard to:

New-Ware
(619) 455-6225

3) Electronically through the New-Ware BBS:

(619) 455-5226

The New-Ware Shareware products BBS operates 24 hours per
day, 7 days per week at 1200/2400 baud and N71 or N81. Users
registering via the BBS receive access to the latest
registered version. Users who register by mail or phone may
also access the registered version by BBS. Just log on and
leave a comment to the sysop to the effect that you are a
registered user and desire access.

This Shareware version of CopyMaster may be freely copied and
passed on to other individual users. Disk
vendors/distributors that desire to distribute CopyMaster must
adhere to the guidlines presented in VENDOR.DOC.

Press Ctrl-R from the main CopyMaster Display to display the
registration window. Prompts will be issued for the pertinent
information and you will have the option of printing the
registration form when the form is completed.

CALIFORNIA RESIDENTS MUST INCLUDE 7% STATE SALES TAX!

I support my software. One of the great strengths of the
Shareware concept is the interaction between the program author
and the users. Many of the features contained in CopyMaster
are the result of user input. If you have a problem evaluating
this program or desire to make a suggestion or comment (or even
a complaint), please do not hesitate to contact me.


VERSION HISTORY

1.00 - First release.
1.01 - Minor bug fixes.
1.10 - Added capability to disk copy 1.2M and 1.4M disks.
1.11 - Added function to swap left and right windows (Ctrl-R).
Added drop to DOS shell function (Ctrl-F1).
1.12 - Add toggle for operations with 800K disks formatted with
FormatMaster. Added deletion of tagged files.

OPERATION OF COPYMASTER

I. Program Description.

CopyMaster can be executed from any directory on any
disk drive. It is initially configured for the left window
to display files in the directory from which it is executed
and for the right window to display files from the root
directory of the drive from which it is executed. These
default settings may be changed.

CopyMaster will simultaneously display files from two
directories in adjacent windows. The directories that will
be shown can be set and saved as defaults from within the
program or can be entered on the command line as in the
following example:

cm c:\util d:\dbase

The first DOS pathname determines the directory listing
in the LEFT (source) window and the second determines the
listing in the RIGHT (destination) window. If just one path
name is entered as a parameter, CopyMaster will use it for
the listing in the RIGHT (destination) window. This allows
specification of the destination directory from the command
line while CopyMaster uses its current default setting for
the LEFT (source) directory listing. A file mask may be
included in either path name as in this example:

cm c:\util\*.exe d:\dbase\*.dbf

If no mask is included, then CopyMaster will assume a mask
of "*.*". If no drive designator is included, CopyMaster
will assume the current active drive. If either path name
is invalid, CopyMaster will use the last saved default.

CopyMaster is a full-featured file copy utility that
operates on IBM PC/XT/AT and compatible computers. It makes
file and disk copying fast, easy, and effective through the
use of the following powerful features:

- Dual directory viewing of files
- Batch tagging of files for copying
- Move files across drives
- Selectable date criteria for copying
- Selectable file overwrite protection
- CRC file copy verification
- CRC disk copy verification
- File encryption/decryption
- Fast file search
- Quick disk copying
- Repeatable disk copying
- Two-drive cyclic disk copying
- Extensive error checking
- File-by-file compare option
- Disk Compare on 360K/720K/1.2M/1.4M
- "Lotus" style command menu
- Pop-up data-entry windows

CopyMaster is written primarily in Turbo Pascal 5.0
supplemented with TurboPower Software's outstanding Turbo Pro
4.0 library package, which is HIGHLY recommended to all Turbo
Pascal programmers. The program, as distributed, occupies
approximately 150K of normal ram and utilizes expanded memory
conforming to the LIM 3.2/4.0 Expanded Memory Specification
(EMS), if available in the host machine.

CopyMaster will automatically adjust to monochrome or
color monitors. If you are using a composite or "two color"
monitor similar to those used in laptop portables or are
using a mono monitor with a color card, place an "m" or "M"
or the command line when you execute the program, as follows:

CM m

CopyMaster has also been designed to utilize the full
16 color text attribute capability of the Hercules InColor
Card.

CopyMaster supports the use of a 2 or 3 button mouse.
The button actions for a 3 button mouse are:

L = PgUp
R = PgDn
M = Space bar (tag/untag)
L+R = ENTER
M+R = End
M+L = Home
M+L+R = Alt-X (terminate)

The button actions for a 2 button mouse are:

L = PgUp
R = PgDn
L+R = Space bar (tag/untag)

II. CopyMaster Main Screen.

This is the main screen:

CopyMaster 1.12 - Shareware Evaluation Copy
Copyright 1988 by New-Ware
C:\CM\*.* C:\DEST\*.*
ARCOPS PAS 10/12/88 10,925* ARCOPS PAS 10/22/88 10,925*
ASPVAR PAS 08/20/88 6,841* CM EXE 10/22/88 92,592*
BACKUP BAT 10/23/88 118* CM PAS 10/22/88 2,862*
BINOBJ EXE 08/24/88 11,088* CONFIG MNU 10/22/88 740*
CM BAK 10/22/88 2,906* CPUTYPE OBJ 10/22/88 125*
CM EXE 10/23/88 92,800* CPYMASTR BAK 10/22/88 2,854*
CM PAS 10/22/88 2,867* CPYMASTR EXE 10/22/88 92,032*
CONFIG MNU 10/19/88 740*
CPUTYPE OBJ 01/20/88 125*
CPYMASTR BAK 10/20/88 2,854*
CPYMASTR EXE 10/22/88 92,032*
CRC ASM 10/22/88 1,927*
CRC BAK 10/22/88 4,277*
CRC EXE 10/22/88 7,984*
CRC OBJ 10/22/88 2,826*
Page 1 Page 1
Total Files = 134 Total Files = 7
Total Bytes = 2,600,960 Total Bytes = 210,944
Files Tagged = 0 Right drive = C:
Bytes Tagged = 0
Flex Tagged = 0
Left drive = C:

Note that there are two viewing windows, each dedicated to
displaying file information from separate directories. The left
window ALWAYS displays the source directory for file copying and
the right window is ALWAYS displays the destination directory.
The active window is distinguished by a solid cursor bar. The
user may switch from one window to the other with the TAB key or
the RIGHT and LEFT ARROW keys. The PGUP, PGDN, HOME, END, and
UP/DOWN ARROW keys are available for moving the cursor bar
through the file list in the active window. The top line of each
window shows the DOS path name and file mask currently in use for
that window. Pertinent file copy related data appears at the
bottom of each window. An asterisk ("*") next to a file name
indicates that the file has been created or changed since the
last backup.

Using the TAB key to switch windows results in vertical bar
markers being used on each end of the file name in the inactive
window to mark the place where the cursor bar was positioned
when the switch occurred. If the LEFT or RIGHT ARROW keys are
used to effect the switch, the cursor bar is left intact in the
inactive window.

Pressing the INS key results in displaying files in the
right window that match files in the left window but that differ
in file size or file date/time. These files are displayed in
the right window in high intensity on monochrome monitors and in
high intensity blue on color monitors.

The file statistics for each directory are shown just
below each directory window. As files are tagged, CopyMaster
keeps a running total of bytes tagged based not upon the sum
total of sizes of the files tagged, but on the space they
actually occupy on the default disk. The minimum file size is
dependant upon the active drive's cluster size. The cluster
size is always a multiple of the sector size. For example, any
DOS formatted hard disk under 10 megabytes in size will use a
cluster size of 4096 (8 sectors). A standard 360K floppy disk
will have a cluster size of 1024 bytes and a 3 1/2" 1.44M disk
has a cluster size of 512 bytes. Total bytes and bytes tagged
values are based upon the active disk cluster size. For
example, two 1-byte files on a disk with a cluster size of 2048
will occupy a total of 4096 bytes. The flex value is based upon
the cluster size of a 360K/720K disk, which is 1024 bytes.
Watching this value when tagging files for copying to a floppy
Disk will avoid trying to copy more files than the target disk
can contain.

When CopyMaster first loads, it does some checking against
the default path names for the left and right windows. If the
default left path name is invalid or contains no files or is the
root directory and contains no files and no directories,
CopyMaster will use the current directory to display files in the
left window.

The contents of the left (source) and right (destination)
windows may be swapped by pressing Ctrl-R. This action
reinitializes both windows so that the drive/directory/files
displayed in the right window are now displayed in the left
window and the drive/directory/files displayed in the left
window are now displayed in the right window.

III. Main Command Menu.

Pressing either slash key (backslash = \, or slash = /) will
display the main command menu as depicted below:

CopyMaster Commands
Go Copy Date DKopy Options Backup Reset Eval Sort Type Config


The cursor bar can be moved with the LEFT and RIGHT ARROW keys to
select the desired function or the function can be activated by
pressing the appropriate highlighted character. CopyMaster can
be exited at any time by pressing ALT-X or CTRL-X. The main menu
and all sub-menus may be exited by pressing the ESC key. The
following is a brief summary of each main menu item:

Go Copy - Initiate copying of tagged files from
the source directory to the destination
directory.
Date - Define date relations for selective copying.
DKopy - Initiate copying of 360K/720 diskettes.
Options - Set various program options.
Backup - Copies only files with the archive bit set.
Reset - Resets archive bits on all files in the
active directory.
Sort Type - Selects one of five file name sorts.
Eval - Disk compare operation.
Config - Save current configuration to disk.

Note that a help line for each menu item is displayed immediately
below the command menu.

IV. Copying Tagged Files.

Files are selected for copying by tagging them. Files may be
tagged by pressing the SPACE BAR or the PLUS key with the cursor
bar over a file. Pressing the SPACE BAR or the MINUS key will
untag a tagged file. Tagged files are so indicated by a diamond
character to the left of the file name. All files in the
directory may be tagged by pressing CTRL-T (or F6) and all tagged
files may be untagged by pressing CTRL-U (or F7). Move through
the file list with the cursor pad keys or by pressing a CHARACTER

KEY, i.e., a key in the set "A" to "Z". Pressing a CHARACTER KEY
will cause CopyMaster to seek the first file on the list that
starts with that character. If it finds it, the cursor bar will
be moved to that file. Alt-T will toggle between the normal
file viewing mode and a mode in which only tagged files are
displayed.

Once a group of files has been tagged, pressing either SLASH
key and selecting GO COPY from the menu will cause the tagged
files to be copied from the source directory (left window) to the
destination directory (right window). Files may not be tagged in
the right window. During the copy process, the following
information window will appear:

File Copy Window
Copied CM.BAK
Copied CM.EXE
Copied CM.PAS
Press any key to continue....











Buffer Size = 16384

The copy operation will be terminated if any errors occur during
copying. After performing a copy operation, ESC from the main
menu and press TAB or RIGHT/LEFT ARROW to refresh the destination
directory window.

Files may be copied across disk drives by changing the
default drive in either window. This is accomplished by pressing
CTRL-D (or F3) with the desired window active. A window will
appear that prompts for the DOS drive designator. If the drive
is valid and the drive is ready, the files in the current default
directory for the selected drive will be displayed. If not, an
error message will appear. The copy operation can be initiated
from the command menu. If no files are tagged, the file
currently highlighted by the cursor bar will be copied.

Files may be moved instead of copied. Moving a file involves
placing the file into the destination directory and removing it
from the source directory. In the case where both directories
are on the same drive, this is accomplished by simply renaming
the file if it does not exist in the destination directory. If

it does, and overwrite protection is not active, the file will be
copied to the destination directory and then deleted from the
source directory. If CRC verification is set to ON, then those
files that are actually copied will be verified. Files moved
via the rename process are not subject to CRC verification.

Either the source or the destination directory can be
changed. Pressing CTRL-S (or F2) will toggles back and forth
between file display of the current directory and the display of
all directories on the active drive. The first time this
function is used on a drive there will be a delay while
CopyMaster builds a list of directory names. After that, the
toggle is instantaneous. The cursor may be moved through the
list of directory names and a directory change can be effected by
pressing RETURN with the cursor bar highlighting the desired
directory. If no files exist in a selected directory, a message
to that effect will appear. Pressing a character key will move
the cursor to the first directory containing that character as
the first letter of the name, just as in the file viewing mode.

CopyMaster will overwrite all files unless the Overwrite
confirmation toggle is set to ON. This includes system, hidden,
and read-only files. CopyMaster will, however, preserve the
file attribute of the overwritten file. For example, suppose
you are copying MYDATA.DAT, which has a normal file attribute,
to a destination directory that contains a copy of MYDATA.DAT
that is marked hidden and read-only. Unless the confirmation
toggle is ON, CopyMaster will overwrite MYDATA.DAT but it will
leave MYDATA.DAT with the original hidden/read-only attribute.
Remember, if you don't want to overwrite special files, either
use the confirmation option or configure CopyMaster not to
display these files.

V. File Copying Options.

CopyMaster offers a rich variety of file copying functions.
Files may be copied selectively by date, overwrite protection may
be invoked, and CRC (Cyclic Redundancy Check) verification may be
used. Selecting DATE COPY from the main menu offers the
following options:

Date Copy
A - Equal
B - Before
C - After
D - On or Before
E - On or After
F - Any Date But
G - Enter Date


Each date relation on the menu is explained in a help line
that is displayed below the main menu. For example, to copy only
those files with a date On or Before a specified date, select
item D. The date may be specified by selecting item G to display
the following date entry window:

Time/Date Entry

Enter the month (1..12): 10

Enter the day (1..31): 23

Enter the year (80..99): 88

Is 10/23/88 correct (Y/N)? [Y]


Prompts are issued for entry of the month, day, and year and then
the resultant string is displayed for confirmation. Pressing ESC
at any time will abort the data entry and leave the date string
as it was prior to entering this window. Dates are only valid in
the DOS acceptable range of 01/01/80 and after. Once a date is
specified, date based copying is made active through selection
from the OPTIONS menu.

Option Settings
Retain File Date OFF
Overwrite Confirmation OFF
Date Range/Copy Date OFF
Include Hidden Files OFF
Set Archive Bits OFF
Current File Mask *.*
Move Files OFF
Beeps ON
CRC Verification OFF
Freshen OFF
Quick Disk Copy OFF
eXamine (COMP) files OFF
Editor Name EDIT
PathName Defaults
View System Memory
10 Sector Disk


The first option, Retain File Date, is an interesting one
that many will find useful. When a file is copied by DOS, the
date of the new file is always the same as the source file. With
CopyMaster you may elect to set the date of the new file to the
current system time/date.

Overwrite protection is a feature that prevents CopyMaster
from overwriting a file of the same name in the destination
directory. If this option is ON during a copy operation, a
prompt for overwrite confirmation is issued before the file is
copied or moved.

The Date Range/Copy toggle determines whether or not
CopyMaster uses the date relation criteria for copying files. If
this toggle is ON, the current date string will be be displayed.
The default, as distributed is 01/01/80.

File Copy Window
Overwrite ACKERM.BAK?
Overwrite CM.BAK?
Copied CM.BAK
Overwrite CPYMASTR.BAK?
Copied CRCFUNC.BAK
Press any key to continue....







Buffer Size = 16384

The File Copy Window above shows that 4 files were tagged with the
Overwrite confirm toggle set to ON. The first file was not
confirmed, the second file was confirmed, the third file was not
confirmed and the fourth file did not exist in the destination
directory and no confirmation was required.

The Include Hidden Files toggle determines if hidden files in
a directory will be displayed.

If the Set Archive Bits toggle is ON, then CopyMaster will
reset the Archive bit on each file that it copies. This provides
a means for later copying only those files that have the archive
bit set. The archive bit is set by DOS any time a file is
changed and written to disk. It is an indicator that the file
has been created or changed since the last time the bit was
cleared.

The DOS file mask determines which files will be displayed in
a window. For example, if the file mask is set to "*.*" then all

files will be displayed. If the mask is set to "*.WKS", then
only those files matching the mask will be displayed. The mask
for either window may be set by using this option. A window will
appear that prompts for entry of the new file mask. This mask
will affect the window that was active when the main menu was
accessed. The file mask can be set for each directory window.

File Mask Entry

Edit file mask (ESC to abort): *.WKS

Mask is now *.WKS

Accept it (Y/N)? [Y]



The Move Files toggle will determine whether CopyMaster moves
or copies tagged files. Moving a file entails either renaming
it so that it resides in the destination directory or, if the
file currently exists in the destination directory it will be
copied and then deleted from the source directory.

Program beeps may be turned off entirely with the Beeps
toggle set to OFF.

CRC (Cyclic Redundancy Check) Verification, when set to ON,
causes a sophisticated CRC algorithm to be applied to every byte
of the file as it passes through the file buffer. When the
copying is complete, CopyMaster opens the new file, reads it back
through the buffer to calculate a second CRC value. This value
is compared with the first and if the two are equal, the message
PASSED CRC will be displayed next to the file name in the File
Copy window. If the check fails, the message CRC FAILED is
displayed. Using the CRC verification approximately doubles the
time required to complete the copy, but ensures that the copy is
a verified exact copy of the source.

File Copy Window
Overwrite CRC.BAK?
Copied CRC.BAK PASSED CRC
Overwrite CRCFUNC.BAK?
Copied CRCFUNC.BAK PASSED CRC
Overwrite DECLARE.BAK?
Copied DECLARE.BAK PASSED CRC
Overwrite DISKCOPY.BAK?
Copied DISKCOPY.BAK PASSED CRC
Press any key to continue....






Buffer Size = 16384

Note that the results of the CRC check is reported for each file
copied when the CRC toggle is ON. If a file fails the check,
the copying is terminated because that usually always means the
destination media is the problem.

The Freshen option will copy files from the source to the
destination disk/directory only if the source file has a
date/time stamp that is newer than that of a file of the same
name residing in the destination directory. Overwrite
protection, if enabled, will be in effect coincident with the
Freshen option.

The eXamine option is a file-by-file compare function.
Note that this feature takes precedence and overrides any other
options that may be set. It will compare each file in the
source (left window) directory with an existing file of the same
name in the destination (right window) directory. This feature
uses the same CRC check algorithm used in file and disk copying
except that if the two files being compared are of a different
length, it will skip the reading of each file for a CRC check
and report that the compare FAILED. If the files are compared
and they are exactly the same, COMPARED will be reported in the
Compare File Mode window.

The PathName Default options permits setting CopyMaster to
show specified disk/directory combinations in the two file
viewing windows. A valid DOS path name (without the file mask)
may be entered for either window. Using the Config option will
save the entris to disk and thereafter CopyMaster will show the
two specified directories no matter from where it is executed.
If it is desired that the left window always show the files from
the directory in which it is executed, make a blank entry for
the left window when prompted. Entering a blank line for the
right window default will cause the right window to always
display files from the root directory of the active drive.

The 10 Sector Disk option is intended for use with those
systems that have problem with 10 sector formatting. New-Ware's
FormatMaster will format a 360K disk to 800K in a 1.2M drive, but
some BIOS/DOS variants have problems dealing with a 360K diskette
formatted with 10 sectors/track and 80 tracks. Toggling this
feature to ON will enable those systems to read/write from an 800K
disk. When the toggle is set to ON, a window will appear that
permits the setting of the disk controller data rate. The default
is set to 300 kilobits (Kb), which should suffice for most modern
AT/PS2 machines and clones. If you have an old AT or clone or you
are copying to a 400K disk formatted with FormatMaster on an old
PC/XT or clone, you may need to set the data rate to 250Kb in
order to read/write to a floppy disk.

VI. Disk Copying.

CopyMaster offers several unique and useful disk copying
features. It will copy diskette (360K/1.2M/720K/1.4M) into a
buffer and then write the buffer back out to formatted disks. If
desired, CRC verification can also be used with disk copying.
When copying the diskette, CopyMaster will first determine which
kind of buffer can be used to hold the entire contents of the
disk. The first choice is to use normal RAM, if available.
Obviously, this won't be the case for a 720K disk. If there is
insufficient RAM available but expanded memory (EMS) is installed
and enough is available, CopyMaster will utilize EMS for the
buffer. If not, a virtual disk buffer will be used. Note that
this will only work on a hard drive system where there is
sufficient disk space for buffering when copying 720K, 1.2M or
1.44M disks.

An option that can be toggled from the Options menu is Quick
Copy. Quick Copy should ONLY be used when the source diskette
has been prepared so that its files are stored in contiguous
sectors on the disk. This can be accomplished by using
CopyMaster to copy files to a freshly formatted disk. Copying
to a newly formatted disk insures that DOS will store the files
contiguously and there will be no fragmentation. When Quick
Copy is in effect, CopyMaster copies only those clusters from the
source disk that are occupied by files. This can reduce the
amount of time required to perform each disk copy. For example,
suppose a 360K disk is prepared that contains contiguously stored
files that occupy 172 of the disk's 360 total clusters. Quick
Copy will copy only those occupied clusters, thus reducing
read/write time.

The Disk Copy control display offers several options.
Prompts are issued for the source drive and the target drive.
These can be the same drive and there will be a pause between
each write operation to allow for a disk change. The target disk
is read into the buffer and then the copying process commences
and will continue until terminated by the user. Disk copying may
be aborted at any time by pressing any key on the keyboard.

Disk Copy Setup

Enter SOURCE drive letter: A

Enter TARGET drive letter: A

Do you desire two-drive copy (Y/N)? [N] N

Using NORMAL RAM to buffer disk data.

ESC to abort, any other key to start copy




Cyclic, continuous, two-drive copying is also supported.
This feature allows selecting two drives as target drives and the
copying proceeds as before except that there is no pause between
drives. The user is expected to change disks in one drive while
the other is busy copying. With enough memory for a normal RAM
buffer and Quick Copy active, very rapid disk copying can be
effected.

Disk Copy

Reading from disk in drive A

Using NORMAL RAM buffer to read 14 15K blocks.

Reading block #14 - 215,040 bytes.

Disk sectors in memory - ready to copy (Y/N)? [Y]




Disk Copy

Writing to disk in drive A

Using NORMAL RAM buffer to write 8 15K blocks.

Writing block #8 - 0 bytes to go.

Copied 1 diskettes.

Copy to another diskette (Y/N)?



VII. Other Operations.

Files may be be deleted by tagging and then pressing Alt-D.
The following window and prompt will then be presented:

Delete Tagged Files

Are you CERTAIN (Y/N)? [Y]







Be CERTAIN you wish to delete the tagged files. If Y is
pressed, all the tagged files that can be deleted will be deleted.
After the deleting, a message will appear that shows the number of
files tagged and the number of files actually deleted. A
difference will occur if any of the tagged files cannot be deleted
because they are marked READ ONLY or HIDDEN.

CopyMaster will load and pass a file name to a specified
editor. Use the Editor Name option to enter the program file
name of the editor. The .COM/.EXE extension is not required.
The editor file MUST be in a directory that is listed in the DOS
PATH string!!! To edit a file, place the cursor bar over the
desired file name and press CTRL-E (or F10).

Vern Buerg's justly famous LIST.COM may also be invoked from
CopyMaster. Place the cursor bar over the file to LIST and press
CTRL-L or F9. Again, LIST.COM MUST reside in a directory that
appears in the DOS PATH string.

The directories which are viewed when CopyMaster is first
loaded may be changed with the Pathname Defaults option. A
window will open and prompts will be issued to enter the pathname
for each window. For example, suppose it is desired to view a
directory with a DOS path name of C:\WP\DOC in the left window
each time CopyMaster is initially loaded. Enter C:\WP\DOC for
the left window path name. Similarly, a default path name may be
specified for the right window. These path names are saved to
disk along with all other option defaults from the Config
function.

The last item on the Options Menu will bring up a window in
which certain information about the host system is displayed.

System Memory Summary

Total RAM on board = 640K
System RAM in use = 101K
CopyMaster occupies = 148K
RAM available = 391K
File copy buffer = 32K
RAM copy buffer = 390K
Floppy Disks = 1
Fixed Disks = 2
Disk space avail = 3104K
EMS memory avail = 880K
EMS version = 4.1024



VIII. Backup and Reset.

The Backup and Reset functions work together to provide a
semi-automated method for backing up frequently updated files.
The Reset function clears the archive bit (bit 4 of the file
attribute byte) for each file. DOS will reset this bit any time
the file is accessed and rewritten to disk. If the archive bit
is set, then the file has been updated since the last time it was
cleared. The backup function will copy all those files that have
had the archive bit reset. If the Set Archive Bits option is ON,
CopyMaster will clear these bits as the files are copied. An
effective regular file backup method can be established for any
directory.

VIIII. Sort Type.

CopyMaster offers five different ways to sort files for
displaying. Files may be sorted by name, extension, date, and
size. There are actually two sorts that operate using the file
extension. The nested sort groups files by extension and then
sorts within each group by file name. The name sort ignores the
extension and sorts by name only. Whichever sort is selected at
the time the Config menu is used to save the defaults will become
the default at program run time.

Sorts
Unsorted
By Name
Nested
Date
Size
Extension
Order = UP


X. File Search

An extremely fast file search function is included in
CopyMaster. This function will search all the directories on
the drive currently active in the left window for a specified
file. If the directories of that disk have not been scanned and
read into memory, that will be accomplished before the actual
search is commenced. A window will appear with a prompt to
enter the DOS file name. DOS wild cards (* or ?) are
acceptable. The first line in the window will contain a message
as to the status of the directory array in memory. If the disk
hasn't been scanned to load the directory array into memory,
there will be a pause that is dependent upon the number of
directories that exist on the current drive.

Enter the name of the file to search for and CopyMaster will
swiftly search all directories on the current disk for the file.
If it finds a match, it will pause and ask whether or not to
continue the search. Any time the search is terminated after a
find, the search window will disappear and the cursor bar will
be highlighting the target file name. Three things about the
search mode are important to note. For maximum efficiencey, the
sort type is automatically changed to a file name sort. If a DOS
wild card mask is used in the target file name, the search mask
for the left directory window will be changed to that mask. And
thirdly, a search will pause at the first match found in any given
directory and will continue on to search the next directory if
not stopped.

XI. Disk Compare.

Copymaster will perform a disk comparison on the same drive
or on disks in two drives without needless swapping of disks.
The disk compare function supports all diskette formats. A CRC
algorithm similar to the one employed in file and disk copying is
used in the comparison. The source disk sectors are read in to a
buffer in blocks and a CRC value is computed for each block.
Then the target disk is similarly processed. The two computed
CRC values for each block of each disk are then compare. If even
1 bit of the target disk differs from that of the source disk,
the check will fail. If a disk passes this test, you can be
certain that it is a mirror image of the source disk. One
caution is in order. It is possible to format two disks, copy
the same files in the same order to each disk and then have a CRC
comparison between them fail. This is because some extraneous
bytes in the copy file buffer may be copied onto the disk at the
end of one or more of the files. The disk compare function is
most useful after performing a series of disk copies.

Diskette Compare

Enter FIRST drive letter: A

Enter SECOND drive letter: A

Reading disk A - track #39

Place SECOND disk in drive A and hit a key.



Detected a 360K disk.


XII. File Encryption/DeCryption.

CopyMaster will encrypt and decrypt any type of a file. To
encrypt a file or files, press Ctrl-Z at the file viewing
display. A window will appear to prompt you to enter your key.
The key you enter is like a password. The encryption algorithm
uses the entered key as a basis for encrypting the file
contents. The key may be up to 50 characters long and may
contain any character you can type from the keyboard. The
longer the key string, the more secure the key is. IMPORTANT!
DO NOT FORGET THE KEY THAT YOU ENTER OR YOU WILL NOT BE ABLE TO
DECRYPT THE ENCRYPTED FILE. The key is only saved during the
time the CopyMaster is running. Entry of an empty string will
turn encryption/decryption off.

After entering a key, ALL FILES that are copied will be
encrypted. This means that the files copied to the destination
directory (right window) will be encrypted and unreadable until
decrypted. Encryption/decryption is turned off after each copy
operation. A message will appear below the right window
whenever encryption is ON. To decrypt files, change the left
window directory to the directory containing the encrypted files
and change the right window directory to where you wish to place
the decrypted files. Press Ctrl-Z and enter the proper key. IT
MUST BE THE SAME KEY AS THAT USED FOR ENCRYPTION! Tag the
encrypted files and initiate the copy function. The encrypted
files will be decrypted while being copied from the source (left
window) directory to the destination (right window) directory.

The encryption algorithm employed is a sophisticated key
transposition technique that operates on the target file in 16
bit increments. No claims are made regarding the degree of
security this method offers, but it would take an experienced
cryptologist a good deal of time and access to many encrypted
files to decipher the encryption routine. Suffice it to say
that the contents of encrypted files are denied to everyone
except possibly a dedicated professional cyptography expert who
has access to your encrypted files.

If you send encrypted files to someone else for use, be sure
the recipient has a copy of this version of CopyMaster and to
provide the proper key. Subsequent versions of CopyMaster will
not change in regard to the encryption algorithm employed.

XIII. Configuration.

All current settings/toggles may be saved to disk by
selecting the Config item from the main command menu. CM.EXE
MUST BE IN ONE OF THREE PLACES! The CopyMaster program file must
either reside in the current directory, the root directory, or as
specified in the DOS environment. Use the DOS SET command to
enter the following string into the environment (preferably
placed in the AUTOEXEC.BAT file):

CMLOC=PATHNAME

Where PATHNAME is the DOS path name of the directory where CM.EXE
resides. For example, suppose CM.EXE is located in a directory
named D:\UTIL\CM. Place the following command in the
AUTOEXEC.BAT file to place the string in the environment each
time the machine is booted:

SET CMLOC=D:\UTIL\CM

When attempting to save defaults to disk, CopyMaster will first
look in the current directory for CM.EXE. If not found there, it
will look in the root directory of the active drive. If not
found there, it will look in the environment for the string
mentioned above. If not found there, the defaults will not be
saved.

Two other default settings are available from the Config
menu. CopyMaster uses 23 bytes of memory for each file record
stored in memory and 65 bytes for each directory name stored. In
order to conserve memory and make as much RAM available for disk
copying, the maximum files and directory values may be configured
and saved. The maximum value that can be entered for files is
999 and the maximum for directories is 200. If you set the
default for files to a value that is less than the actual number
of files in a particular directory, CopyMaster will only display
up to the selected value and the remainder of the files will NOT
be displayed. The same holds true for the directory maximum.

Configuration
File Limit 400
Directory Limit 50
Save to Disk


XIV. Function Keys.

Ten CopyMaster commands may be activated without going
through the main command window. Each of these is activated
either by a control key combination (e.g., Ctrl-E) or a function
key. Here are the control and function key assignments:

Command Keys

Key Function Ctrl Key
F1 - Help (Ctrl-H)
F2 - Show directories (Ctrl-S)
F3 - Change active drive (Ctrl-D)
F4 - Commence normal copy (Ctrl-G)
F5 - Commence disk copy (Ctrl-C)
F6 - Tag all files (Ctrl-T)
F7 - Untag all files (Ctrl-U)
F8 - Search disk for a file (Alt-S)
F9 - Call LIST.COM (Ctrl-L)
F0 - Call favorite EDITOR (Ctrl-E)
Tab - Switch viewing windows
Space bar - alternate tag/untag (+ -)
Ctrl-Z - Encrypt/Decrypt files
\ or / - Activate command bar menu
INS - Highlight matching files
- View file date/time & attr
Ctrl-R - Switch Left/Right Windows
Ctrl-F1 - Shell to DOS level
Alt-D - Delete tagged files


Pressing Ctrl-K when not in the command menu structure will
display a window that displays these key assignments.

XV. Miscellaneous.

Cyclic functions like batch copying, disk copying, etc. may
terminated at any time by pressing any key on the keyboard.

Many of the features contained in CopyMaster are the result
user input. Comments, suggestions, and even complaints are awlays
welcome.


Thank you very much for evaluating CopyMaster.


John Newlin
New-Ware