DESQview aware file copy utility. Uses
floppies without slowing down. Complete
SHARE aware and compatible with 4DOS
built in copy command plus many other
features.
* A MAJOR RELEASE, MANY NEW FEATURES! *

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare































Version 2.00

DESQview and SHARE aware copy utility

(c) 1991-92, YossiWare Developments. All Rights Reserved.


























DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









OVERVIEW


DVCopy is a file copying utility, that is built to work under
DESQview. It combines many features which are handy to any
DESQview user. In fact, some of them are unique or revolutionary
ones, which were never seen in any other copy utility.

DVCopy's top feature is its ability to read/write floppy drives
without causing a complete slow-down on all other tasks. It does
this in several levels of "protection" (against slowness), so you
can find out what fits you best and balance the speed of copying
itself, with the speed DESQview will run during the copy.

Also, DVCopy is (optionally) fully share aware. It opens files at
the most flexible yet safe method. It recognizes when a specific
file is locked, and tries to open it for a definable amount of
time/retries until it skips it, and goes to the next file,
(optionally) adding it to the end of the "to-copy" queue, for a
later retry.

In addition to these DV-Specific features, DVCopy has dozens of
others, including 4DOS and NDOS compatibility, fast-move option,
progress-indicator display, full subdirectories copy, and more.

In fact, DVCopy has all 4DOS's (or NDOS's) copy features, in
addition to the special floppy handling routines, and its
advanced file sharing.

All these features, together with it's speed and size, makes
DVCopy probably the best utility for copying files under
DESQview, other multi-user or multi-tasking environments, and
even the "traditional" MS-DOS platform.


















- 2 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









LICENSING AND SHAREWARE INFORMATION


You may use DVCopy for 21 days on a trial basis, in order to
determine its suitability for your system. After this trial
period, you must register it. However, it will NOT stop working
then.

The shareware evaluation version of DVCopy lacks a few features,
which are available on the registered version. These features
are marked with a {+} in this document, and all executable
files. Once DVCopy is registered, all these features are enabled.

Registration entitles you to use DVCopy 2.00 and any future
versions of it for as long as you wish, subject to any special
licensing conditions attached to future versions. For more
information, please refer to DVCOPY.REG (included with the
distribution package), or to the registration form, which can be
printed from within DSETUP.EXE.

You are encouraged to distribute DVCopy provided no fee is
charged for its distribution, and that the distribution archive
is not modified in any way. Pay Bulletin Board Systems may
however charge their normal fee provided that no additional
charge for DVCopy is levied.

The author will not be held liable to you or anyone for any
direct, indirect, incidental or consequential damages, including
any lost profits, lost savings, which may result from the use or
inability to use DVCopy.





















- 3 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









INSTALLATION


This section discusses the complete installation of DVCopy, from
scratch. If you are upgrading from an earlier version, refer to
the "UPGRADING" chapter.

DVCopy will run on 80286, 80386 (SX/DX) and 80486 (SX/DX)
machines, and will not run on 8088/86 based machines. It requires
MS-DOS 3.1 or higher, or any equalivant operating system, and
about 180K of base (conventional) memory.

DVCopy installation consists of a few stages. Even if you are
already very experienced with this kind of software, please take
your time, and briefly browse the steps below, in order to
prevent inconvenience for both you and us.

1. Extract all executables from the original distribution
archive into your DESQview directory, utilities directory,
or a different directory, created especially for DVCopy. You
should have the following files:

DVCOPY.EXE The main executable file - DVCopy 2.00.
DSETUP.EXE The setup utility, for configuring DVCopy.
DUPGRADE.EXE The upgrade utility, for upgrading from
DVCopy 1.01 setup into DVCopy 2.00.


2. Run DSETUP.EXE, for configuring DVCopy. It will pop up its
main menu, with the following fields:


Sharing Under DESQview : Toggles whether or not DVCopy
will, on default, attempt to
share files when DESQview is
detected. DVCopy will avoid any
sharing if SHARE is not loaded.

Sharing Outside DESQview : Toggles whether or not DVCopy
will, on default, attempt to
share files when DESQview is not
detected. DVCopy will avoid any
sharing if SHARE is not loaded.
Usually, this is not needed, but
if you run a Local Network (LAN),
you may find it very handy.





- 4 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









Floppy Protection Level : Cycles the protection level which
DVCopy uses when handling
floppies.

4DOS/NDOS Descriptions : Toggles the support for 4DOS (and
{+} NDOS) descriptions. If enabled,
and 4DOS/NDOS is detected by
DVCopy, the description of files
will be moved/copied together
with the files.

Progress Indicator : Toggles the use of progress
{+} indicator. If enabled, DVCopy
displays the progress of copying,
in percent, on the right side of
the screen.

Overwrite files : Toggles DVCopy's acts, when the
the target file already exists.

Confirm Overwrites : Toggles DVCopy's interactive
{+} mode. If enabled, DVCopy will not
overwrite files before
confirming. Otherwise, it will
act according to [Overwrite
files] settings.

Allow appending of files : If enabled, DVCopy will support
appending of files, and will
append files, when several files
are copied into one target file.

Default copy is binary : If enabled, DVCopy will treat
files as binary, and will copy or
append complete files. Otherwise,
it will just copy or append until
it reaches a ^Z character.

Relocate locked files : If enabled, when DVCopy detects
a locked file, which could not
be opened after several retries,
it will move it to the end of
the queue, and retry opening it
after all others files are
finished.






- 5 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









Suppress Copyright Header : If enabled, DVCopy will not
{+} display the copyright notice and
settings. This is very handy when
replacing DOS's copy command with
DVCopy.

Seconds to retry locked : This is the number of seconds
DVCopy will try reopening a
locked file, before skipping to
the next one.

Print Registration Form : Prints the registration form
(either the US Registration form,
Israeli form, or global one) on
the printer.

Install Registration Key : Lets you install your personal
registration key, as you received
it from the registration site. If
your key is valid, DVCopy will
become registered to your name,
and let you use all
registered-only features.

Clone changes (Save) : Saves all current settings to the
executable file.

Return to DOS : Exit back to DOS.























- 6 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









UPGRADING


If you have used DVCopy 1.01 until now, you can transfer your
setup from DVCopy 1.01 to 2.00.

In order to do so, run DUPGRADE.EXE. You will be asked to type in
the name of your DVCOPY.EXE version 1.01, and the name of your
DVCOPY.EXE version 2.00.

Then, DUPGRADE will upgrade all settings on your DVCOPY.EXE
version 2.00. Replace the old executables with the new one, and
run the Setup utility, for setting up the new features.






































- 7 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









COMMAND LINE PARAMETERS


DVCopy is very simple to use. Running it with no command-line
parameters will cause it to display a brief help screen with all
acceptable parameters. Generally, the command line format is same
as 4DOS's built-in COPY command:

DVCOPY [d:][path]source_files... [[d:][path]target_path] [/A /B]
[/C /CFG /H /IMP /M /N /P /Q /R /S /U /V /{p}]


DVCopy allows you to copy several unrelated files to a target
directory with a single command. If there are two or more
arguments on the command line, DVCOPY assumes the last argument
is the target. If there is only one argument, the target is
assumed to be the current directory.

If you specify more than one source file, and the target is NOT a
directory, DVCOPY will automatically append the files to the
target. Unlike MS-DOS, DVCopy does NOT support (or need) the plus
(+) which can be inserted between file names, to indicate
appending is requested.

DVCopy parameters are:

/A Switches DVCopy to ASCII copy mode. In this mode,
DVCopy will only copy files until it reaches a ^Z
character, and will not copy it (the ^Z). At the end
of the target files, DVCopy will also place a ^Z.
This option overrides the settings as selected in
DSETUP.

/B Switches DVCopy back to BINARY copy mode. In this
mode, DVCopy will copy files until it reaches the
end of them. This option overrides the settings
as selected in DSETUP.

/C Copies only those files where the target exists,
and is older than the source.

/CFG Dumps the config, which is stored in DVCOPY.EXE, to
external readable (text) configuration file,
located in the same directory as the EXE file.

/H Copies files with HIDDEN and SYSTEM attributes as
well. Note: The target files will have the same
attribute as the source.



- 8 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









/IMP Reads the external config file, created by [/CFG],
and modifies the setup inside DVCOPY.EXE according
to it. Together with [/CFG], it can be used for
upgrading versions, without having to reconfigure
everything.

/M MOVEs files, instead of copying them. When moving
files between directories on the same drive, DVCopy
will do quick-move, by directly updating the FAT.

/Q Forces DVCopy not to prompt for keyboard
interference. When used, DVCopy also doesn't
display file-names as they are processed. This mode
overrides the [Confirm Overwrites] option in DSETUP.

/R Forces DVCopy to prompt before overwriting files.
{+} This option is the opposite of [/Q], and may
override the [Confirm Overwrites] option in DSETUP.
This feature is {+} Registered only.

/S Copies subdirectories - the target must be a
directory (DVCopy will create it if it doesn't
exist). DVCopy will copy each subdirectory to a
matching subdirectory of the target.

/U Copy only those source files that are newer than a
matching target file, or where a matching target
file doesn't exist.

/V Verify each disk write. This is the same as
executing the VERIFY ON command, but is only active
during DVCopy's action.

/{p} Sets the floppy protection level to {p}, provided
{p} is a number in the range of zero (0) to five
(5).


NOTE: Every option can be located everywhere in the command-line.
DVCopy first process the options, and only then starts
processing files. There is no importance to the order of
the parameters.









- 9 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









EXAMPLES:


DVCOPY FILE1 FILE2 FILE54 A:

Copy FILE1, FILE2 and FILE54 to the current directory on drive A.


DVCOPY \FD\INBOUND\0*.* \FD\BACKUP\PACKET.*

Copy all files from directory \FD\INBOUND\, which begin with 0,
to directory \FD\BACKUP, using file-name PACKET, keeping the
source extension. There are more complicated forms for
wildcarding, and DVCopy supports them all - just like MS-DOS
does.


DVCOPY FILE1 FILE2 FILE4 ALLFILES /A /2

Appends FILE1, FILE2 and FILE4 together as ALLFILES, using
ASCII-appending, and protection level 2.

DVCOPY C:\ /V D:\ /S /U

Copies files in directories of drive C to drive D (keeping the
directory-tree structure), provided the source files are either
newer than the target ones, or no target ones exist. All disk
writes will be verified.























- 10 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









THE FILE OVERWRITING MECHANISM


DVCopy is very flexible when it comes to overwriting files. The
main switch is [Overwrite files], which is set in DSETUP.

When [Confirm Overwrites] is disabled or [/Q] is specified on the
command line, DVCopy operates according to [Overwrite files].
When a target file already exists, it either overwrites it (if
[Overwrite files] is enabled), or skips it (if [Overwrite Files]
is disabled), but never waits for manual supervision.

When the [Confirm Overwrites] option is enabled, or the [/R]
command-line option is specified and a target file already
exists, DVCopy will prompt with the following line:

"File exists! Overwrite? [YNAQ]"

If the keyboard response is Y, DVCopy will overwrite this file,
and continue with others. If this situation occurs again, it
will prompt for supervision again.

If the keyboard response is N, DVCopy will skip this file, and
continue with others. If this situation occurs again, it will
prompt for supervision again.

If the keyboard response is A, DVCopy will act according to the
[Overwrite Files] switch in DSETUP, and will continue with all
other files. If this situation occurs again, it will NOT prompt
for supervision again, but will continue as if [Confirm
Overwrites] is disabled.

If the keyboard response is Q, DVCopy will not overwrite the
file, but will stop everything and quit to DOS.

















- 11 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









FILE SHARING


When running several tasks (windows) at the same time, there is a
high possibility that two or more tasks will use the same file at
the same time. No harm is done if both tasks read the same file.
However, if any of them (or even both) modifies the file, there
are pretty good chances of having the file ruined.

The solution, is having a program which will manage this, and
maintain access to files. This program is supplied with MS-DOS,
and is called SHARE.EXE. In addition, programs should be "share
aware", and support advanced file sharing. DVCopy does.

It is highly recommended to load SHARE (prior to loading
DESQview, of course). In fact, DVCopy's will not try to use its
advanced file sharing if SHARE is not loaded.

If a task which is not share-aware is being used, and is trying
to write to any of the files DVCopy uses, DOS will deny its
write-request. Share-aware program would recognize the reason DOS
doesn't let it write into the file, and act accordingly (wait). A
non share-aware program would recognize the write-deny as error,
and warn you about this, or even abort (depends on the program).

DVCopy uses the following sharing-modes on the following files:


Source-File Reading : When DVCopy opens the source file, it
will open it for read purpose only, so
other programs, who needs to read-only
this file will be able to do so. If the
source file is already opened, and
access to it is denied, DVCopy will wait
until access is available, up to 15
seconds. If after a few seconds (the
exact number is defined in DSETUP) the
file is still locked, DVCopy will skip
to the next file.

If the option enabled, DVCopy will also
retry opening the file again, after
copying all other files.

Target-File Writing : When DVCopy opens the target file, it
will open it for write purpose only. It
will also make sure other programs will
not be able to access this file AT ALL.



- 12 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









FLOPPY PROTECTION LEVELS


This is probably the most appealing feature in DVCopy, its
ability to use floppy drives without causing DESQview to freeze.

DVCopy support 6 levels of protection, which provides you most
combinations you might want. The higher the protection level is,
the slower floppies will work, and the better DESQview will
perform. Here is a brief list of the protection levels, and
recommendations:

Protection Level 0 : Provides no protection to floppies. Use
this if, for any reason, you don't want
DVCopy ever protect DESQview from
hanging.

Protection Level 1 : Provides minimal protection. When the
processor is busy, speed will decrease
in approx 30%. DVCopy will not attempt
to keep DESQview active all time, but
will release some time-slices every once
in a while.

Protection Level 2 : Provides poor protection. When the
processor is busy, speed will decrease
in approx 50%. This is useful when the
computer runs unattended, and no
DESQview task need to be kept
synchronized.

Protection Level 3 : Provides standard protection. When the
processor is busy, speed will decrease
in approx 55%. This is useful when there
aren't many tasks running, and no
high-speed unbuffered communication is
done.

Protection Level 4 : Provides good protection. When the
processor is busy, speed will decrease
in approx 90%, but DESQview will be
kept active all time, and will almost
never hung.








- 13 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare








Protection Level 5 : Provides top-level protection. When the
processor is busy, speed will decrease
in approx 145%. Use this protection
level when many tasks are running,
and/or when a lot of speed-critical
communication is done (i.e., a BBS,
etc).













































- 14 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









DVCopy will use the protection level that is set using DSETUP, as
default. You may override this default by setting an environment
variable under the name DVCOPY, which will contain the new
protection level (I.E. SET DVCOPY=2 forces protection level 2).
An invalid (or no) value in the DVCOPY environment variable will
cause DVCopy to use the default protection level, as set in
DSETUP.

Using the command-line switch will override the default (DSETUP)
AND Environment variable (I.E. DVCOPY /0 ... would force no
floppy protection).

Also, registered users of DVCopy, can change the protection
level WHILE COPYING. While DVCopy copies files, pressing any of
the numeric keys, in the range of 0 to 5, will cause DVCopy to
switch into that specific protection level. A small "beep" will
be sound, and a bar will pop up on top of the screen, informing
about the change of protection level, and the new protection
which is used.
































- 15 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare










REQUIREMENTS


DVCopy requires the at least following in order to run:

IBM PC/XT, based on a 80286, 80386 or 80486.
MS-DOS 3.1 to 5.00, or a compatible operating system.
About 180Kb of free base (conventional) memory.
4DOS or NDOS (optional, for description support)
SHARE (optional, and highly recommended, for file sharing)
DVCopy works on any version of DESQview or DESQview/X.


DVCopy was tested on 80286, 80386 and 80486 Microprocessors. It
was tested under DESQview 2.26 to 2.42, DESQview/X 1.03, QEMM-386
5.12 to 6.03, MS-DOS 3.30 to 5.00, 4DOS 3.02 to 4.01/Rev B and
HyperDisk 4.21 to 4.32 (SHAREWARE).


































- 16 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









CREDITS and TRADEMARKS


DVCopy was developed, debugged, tested, profiled, assembled
compiled and documented with the help of the following:

Borland Turbo Pascal 6.0
Borland Turbo Assembler 3.0
Borland Turbo Debugger 3.0
Borland Turbo Profiler 2.0
Enhanced Turbo Pascal++ & PDL-II Runtime Modules
QEdit 2.15
DESQview/386 (DV 2.42/QEMM 6.02)
MS-DOS 5.00
4DOS 4.01 Revision B

Also, all of these could be of no help, without the help of the
beta/support team: Saar Blitz, Roy Udassin, Dave Overton and
Reinier de Groot. Thanks!

The following are trademarks, registered trademarks and efforts
of their authors (alphabetical order):

4DOS Rex Conn, J.P. Software.
QEMM-386,
DESQview Quarterdeck Office Systems.
MS-DOS Microsoft Corp.
NDOS Symantec Corp.
HyperDisk HyperWare.
Turbo Pascal,
Turbo Debugger,
Turbo Profiler,
Turbo Assembler Borland International.
Enhanced Turbo-
Pascal++,
PDL-II Edwin Cleton, SaeSoft.
QEdit 2.15 SemWare.
DVCopy Yossi Gottlieb, YossiWare.













- 17 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare









CONTACTING/SUPPORT


FidoNet : Yossi Gottlieb, 2:403/139.75 (best method!)
DESQview International Echo (DESQVIEW).

Internet : [email protected]


Support Boards:

Europe:
(Israel) The Black Universe 2:403/[email protected]
+972-3-9665202, 14.4k v32b/v42b/MNP10
+972-3-9665257, 2400 MNP5
+972-3-9673803, 2400 MNP5
+972-3-9665039, 2400 MNP5
24 Hours a day.
Sysop: Saar Blitz.

(Israel) Triple D BBS 2:403/[email protected]
+972-8-476549, 14.4k HST/v32b/v42b
+972-8-474359, 2400 BPS
24 Hours a day.
Sysop: Roy Udassin.

(Holland) Multiline Paradise 2:512/[email protected]
2:512/[email protected]
+31-1749-48422, 14.4k HST/v32b/v42b
+31-1749-48384, 2400MNP5
24 Hours a day.
Sysop: Reinier De Groot.


USA:
Amber Shadow BBS 1:203/[email protected]
50:5010/[email protected]
+1-916-742-5501, 14.4k HST/v32b/v42b
24 Hours a day.
Sysop: Dave Overton

Fre'qable from all using magic name DVCOPY.
(All nodes support Bark/WaZOO File Requests).

Also, latest version will be available on DVNet.






- 18 -

DVCopy 2.00 DESQview Aware Copy Utility (c) 1991-92, YossiWare








SnailMail Yossi Gottlieb
YossiWare Developments
11 Armonim St.
Ramat-Gan 52587
ISRAEL















































- 19 -