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 : Yossi.Gottlieb@p75.f139.n403.z2.fidonet.org Support Boards: Europe: (Israel) The Black Universe 2:403/139.0@fidonet +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/123.0@fidonet +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/100@fidonet 2:512/304@fidonet +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/988.0@fidonet 50:5010/988.0@echonet +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 -