Best Objectech Shareware Selections

home *** CD-ROM | disk | FTP | other *** search

/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / dos / 016 / pcopy.doc < prev next >

Wrap

Text File | 1990-07-03 | 78KB | 1,671 lines

Registered PCOPY 8.5c Order Form -------------------------------------------------------------------- VISA/Mastercard orders are only accepted through telephone orders. Call Public Software Library: 800-242-4775 or 713-665-7017 to order. -------------------------------------------------------------------- _____ Registration of all Patriquin Utilities with includes program disk and User's Guide...........@ $45.00 _____ Update Service -- in addition to above, send the next version automatically when it is available....@ +$15.00 -------------------------------------------------------------------- _____ PCOPY -- File Copy, Move, Backup, Update, more!...$20.00 _____ PSEARCH -- Locate files on your disk. Outstanding!..$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 _____ Update a registered set with new disk and manual - show proof of previous registration SER=_________....$15.00 _____ Shipping/Handling for orders outside USA, add ........$ 5.00 _______ Purchase Order Included. _______ Please invoice us. (Orders over $100 only) _______ Check or money Order (US FUNDS) included Total amount of my order is: $________ Disk Size (circle one)? 5 1/4 3 1/2 =================================================================== Name: __________________________________________________ Company: _______________________________________________ Address: _______________________________________________ _______________________________________________ City: ________________________ State: ________ Zip: __________ I learned about PCOPY from: _____________________________________ Send order to: Patri-Soft P.O. Box 8263 San Bernardino, CA 92412 P C O P Y ------------------------- Users Guide and Reference ------------------------- Version 8.5c July 1990 ┌─────────┐ ┌─────┴───┐ │ (tm) │ │o │────────────────── │ ┌─────┴╨──┐ │ Association of │ │ │─┘ Shareware └───│ o │ Professionals ────│ ║ │──────────────────── └────╨────┘ * Member * Patriquin's BBS 714-369-9766 Copyright 1986, 1987, 1988, 1989, 1990 by Patri-Soft PCOPY Users Guide/Reference Copyright 1990 Patri-Soft ---------------------------------------------------------------------- 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) . . . . . . . . . 19 PCOPY Command Examples . . . . . . . . . . . . . . . . . . . . . . 19 Program Maintenance: . . . . . . . . . . . . . . . . . . . . . . . 20 Registering The Utilities . . . . . . . . . . . . . . . . . . . . 28 VISA / Mastercard / Telephone Registration . . . . . . . . . . . . 29 Site Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . 29 PCOPY Order Form . . . . . . . . . . . . . . . . . . . . . . . . . 30 Reporting Problems . . . . . . . . . . . . . . . . . . . . . . . . 31 i PCOPY Users Guide/Reference Copyright 1990 Patri-Soft 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 1990 Patri-Soft 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 1990 Patri-Soft 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 1990 Patri-Soft 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. When a directory name is specified without a drive letter, all | hard disks connected to thye system will be searched to locate | the directory path. The current hard drive will be searched | first. (see also /DE parameter) | 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. When the /S parameter is | specified, an input filelist may only contain file names. It | may not contain directory names. | 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 1990 Patri-Soft 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. If a single level name is supplied as the last part of the | target file specification, PCOPY will search for a directory | that matches the specified name. If it does not exist, PCOPY | will prompt you to determine if the name is a filename or a | directory name. To avoid this prompt, append the name with a | \ if it is a directory name, or a . to indicate it is a file | name... | For example: PCOPY *.* C:\DIRNAME\ PCOPY *.* C:\FILENAME. | /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. If a target filename already exists when append is specified, | all source files copied will be appended to the target file. | To cause an already existing target file to be replaced by | the copied files, also specify the /R parameter. | To combine 3 files into one with /AP, use a command like the | following: | PCOPY FILE1,FILE2,FILE3 NEWFILE /AP/R | /AZ Append text files removing CTRL-Z characters. Like /AP except | ctrl-Z characters will be removed from the end of all but the | last file copied. | /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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 6 ---------------------------------------------------------------------- /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. 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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 7 ---------------------------------------------------------------------- /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 /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. The /D: parameter may be specified twice to select files between two dates (date ranges). /D:(1FEB90/D:)1MAR90 When two dates are specified, a file's date must qualify | selection based on both date parameters. Specify the /DO | parameter to indicate an OR condition between the dates. This | will allow any file meeting either date parameter to be | selected for processing. | 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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 8 ---------------------------------------------------------------------- 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 /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. /DE Disable multiple drive search for specified source directory. | /DC and /DCA | 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. Specify /DCA to copy all directories from source to target | drive, even when no files will be moved from a directory. | /DL Same as /DC except that only the Last node of the source directory is copied to the target pathname specified. /DO Specify when two /D: date parameters are used. Indicates | either date parameter may be met to qualify a file for | processing. See also the /D: parameter. | PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 9 ---------------------------------------------------------------------- /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. /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. /EQ Designed for batch file operation. Use this parameter to prevent PCOPY from requiring you to press a key to terminate processing (Exit Quick). Note: Previous versions of PCOPY supported this option using the /EX. Parameter. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 10 ---------------------------------------------------------------------- /EX Exclude files. The exclude facility allows you to provide a list of pathname and filename specifications that are to be excluded from PCOPY processing. Since searching through data on your hard disk requires extensive processing and disk read time, excluding files from the process will save you time, and will reduce the number of false matches displayed for your requests. The exclude facility is implemented with two actions. First, you will need to create an exclude specification file and place it in the same directory where PCOPY is installed on your hard disk. This file will contain the names of all the files and paths to be excluded. Name the file PCOPY.EXC. You may specify DOS pattern names to exclude groups of files with a single specification. Like DOS, use the '*' to indicate the last part of a filename or filename extension may be any set of characters. Also like DOS, use the '?' to indicate that any single position of a filename may be any character. In addition to DOS, two additional pattern features are available. You may place an '*' anywhere in the filename to indicate any set of characters may exist in this point in the name. For pathnames, you may place an '**' at the end of a directory path specification to indicate the specification applies to the specified directory and all subordinate directories. Using '**', you can exclude an entire path with a single specification. Following are examples: 1. *.EXE 2. *.COM 3. TEST*.* 4. *TEST*.* 5. DO?FIX.* 6. PC*XX.* 7. C:\DOS\*.* 8. \TEST\*.* 9. D:\GAMES**\*.* Explanations for the above examples: 1. Excludes all filenames with the extension .EXE from processing. 2. Excludes all filenames ending with extension .COM. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 11 ---------------------------------------------------------------------- 3. Excludes all filenames beginning with the letters "TEST" from processing. 4. Excludes all filenames having the characters "TEST" anywhere in the first portion of the filename. 5. Exclude files having 'DO' as the first 2 characters of the filename, and 'FIX' as the 4th, 5th, and 6th filename characters. The 3rd character of the filename may be any character. 6. Exclude files having a name beginning with the 2 characters PC and where the first portion of the filename ends with the characters 'XX'. Any 0 to 4 characters may exist between the 'PC' and 'XX' in the first portion of the filename. 7. Exclude all files from the DOS directory on drive C:. 8. Exclude all files from the TEST directory existing on any drive searched. 9. Exclude all files from the D:\GAMES\ directory and also exclude all files and directories subordinate to the GAMES directory. Activating exclude -- Exclude will only be functional when the /EX command parameter is specified. When /EX is specified, you must have a valid exclude file. PCOPY will not continue without one. If you wish exclude to be active during all executions, specify /EX as part of the PCOPY= DOS environment variable. See later in the documentation for a description of this feature. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 12 ---------------------------------------------------------------------- /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. /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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 13 ---------------------------------------------------------------------- /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). /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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 14 ---------------------------------------------------------------------- /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. /R Process all files and if duplicate files are ewncountered, replace them with the file from the source location regardless of their creation date. 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. If multiple hard disks are attached to the | system, each hard disk will be processed unless a drive letter | is specified. | PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 15 ---------------------------------------------------------------------- /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. /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 Users Guide/Reference Copyright 1990 Patri-Soft Page 16 ---------------------------------------------------------------------- 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. /SS:nnn | Terminate processing when the source drive's freespace reaches | the value specified by the /SS parameter. Use when moving | files from one drive to another using the /X parameter. The | command PCOPY C:*.* D: /X/SS:1000000 will cause PCOPY to | move files from drive C: to drive D: until the freespace on | source drive C: is greater than or equal to 1,000,000 | characters. | /ST:nnn | Terminate processing when the target drive's freespace becomes | less than or equal to the value specified by the /ST: | parameter. The command PCOPY C:*.* d: /ST:500000 will | cause PCOPY to copy files to target drive D: until drive D: | has less than or equal to 500,000 characters freespace. | PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 17 ---------------------------------------------------------------------- /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 1990 Patri-Soft Page 18 ---------------------------------------------------------------------- /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 1990 Patri-Soft Page 19 ---------------------------------------------------------------------- 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:*.WKS 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 1990 Patri-Soft Page 20 ---------------------------------------------------------------------- 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 1990 Patri-Soft Page 21 ---------------------------------------------------------------------- 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 1990 Patri-Soft Page 22 ---------------------------------------------------------------------- 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 1990 Patri-Soft Page 23 ---------------------------------------------------------------------- -- 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 Patri-Soft Page 24 ---------------------------------------------------------------------- -- 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 Patri-Soft Page 25 ---------------------------------------------------------------------- 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. -- 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. Version 8.3 Dec 14, 1989 -- When replacing a large file with a smaller duplicate named file, the file was copied successfully but the file length on the new file remained the same as the original file. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 26 ---------------------------------------------------------------------- Version 8.3b Dec 21, 1989 -- Reject improperly placed parameters on command line -- Corrected problem where PCOPY was unable to copy files to 2nd diskette when /DC directory copy parameter used. Version 8.3d Jan 20, 1990 -- F3 from help screen caused window error. Do not allow -- Abort of Abort/Retry/Cancel, loses cursor and messes scrn -- Insufficient free space on 40 meg drive with gt 30 meg free -- /FI with /DC caused dos err 2 reading file. The incorrect dir name was stored for files in filllist. -- DOS error 5 copying files. Directory extension caused insufficient space on drive error. -- Several fixes to fill parameter. Version 8.3e Feb 7, 1990 (maintenance only) -- /CD /CF command left empty file in simulate mode -- /CD command was ignoring /U /N /E command parms -- With /BA do not stop on error setting attribute msg Version 8.3f Feb 9, 1990 -- /D:()=date now can be specified 2 times to select files between 2 dates. -- Fix for create error 5 (permission denied) for directories on network drives. Version 8.4 Mar 14, 1990 -- Add /EX exclude command for PCOPY.EXC file -- Fix lockup by including fixed ltone problem long delay -- PCOPY xxxxxx.zzz \test/s full filename with no * and sys parameter. PCOPY would not search all dirs. -- PCOPY sounds were sometimes long and even locked up machines -- /EX parameter changed to /EQ. Exit Quick with no keypress -- Change window colors -- Corrected problem where only 1 file was forced to be split when /SP:555 offset was used. Now, all files will be split. -- Added msg when split input file used. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 27 ---------------------------------------------------------------------- Version 8.5 May 28, 1990 -- /DCA added to allow all directories to be copied to target drive. Even if no files are copied to them. -- Input file @list no longer ignored on all but first input disk -- Search all hard drives if /S specified and no drive indicated -- May specify trailing \ on dir to avoid question (dir or file?) -- May specify trailing . on filename with no extension to avoid question (directory name or filename). -- If a source directory is specified without a drive letter and it does not exist on the current hard drive, search other attached hard drives for the directory. -- Increased file and character display totals to 5/10 characters. -- Directory not created after /TF used. Now corrected. -- Filelist now works with /S and /MU parameters. -- /S does not allow drives/directories in filelist -- Cleaned up messages for restore of split files. -- Add /DO to support two dates with "OR" comparison -- When append specified. Allow /Repl optional not mandatory. When multiple input files specified Specify /R to replace existing file Do not specify /R to append to existing file -- Ignore check for copy file to itself with command /CD: parm. -- Added /SS: source drive freespace limit. -- Added /ST: target drive freespace limit. Version 8.5b May 31, 1990 -- Fixed bug when copying to A:\. Error attempting to find directory name A:\*.*\*.* -- Corrected window write error when copying split input files in no window mode. Version 8.5c July 3, 1990 -- Added /DE to disable Drive sEarch if desired -- When /CD:... specified, do not ask if ok to replace -- Corrected process to allow . as dir name PCOPY . \.. -- Updated elapsed time on display after last file copied -- FIX-Processing stops reading diskette after split file -- FIX copy of split files between diskettes -- Show volume label on display if they exist -- Added /AZ parm to allow append and remove ctrl-z -- Explained DOS critical errors encountered in messages PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 28 ---------------------------------------------------------------------- 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. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 29 ---------------------------------------------------------------------- Site Licenses ------------- I do welcome organizations to Site License one or more utilities at a reduced cost. Site Licenses allow you to be confident all users in your organization are using authorized versions of the utilities. Following is a schedule of site license fees at the time this document was created. These fees may change at any time. Site license fees -- 5 - 10 copies $150 51-100 copies $1000 11 - 30 copies $200 101-200 copies $2000 31 - 50 copies $600 201-400 copies $3500 Unlimited copy license $5000 A site is considered to be one individual company at a given location. Different departments located as the same address are considered to be part of the same site. To help companies avoid problems with software taken home for personal use, any employee having use of PCOPY as part of a site license agreement, also is allowed to use the software on any machine for their own personal use. This may be at the site location or any other location. Contact us through CompuServe, our support BBS or by mail for a site license agreement. Please state the number of copies you are interested in. Site license users will receive free telephone support and maintenance for one year on the product. Additional years of maintenance may be purchased at 20% of the original site license fee. 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 or 713-665-7017 The PSL supplies Shareware software at a nominal cost to its customers. Consider them for all your Shareware needs. PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 30 ---------------------------------------------------------------------- Registered PCOPY 8.5c Order Form -------------------------------------------------------------------- VISA/Mastercard orders are only accepted through telephone orders. Call Public Software Library: 800-242-4775 or 713-665-7017 to order. -------------------------------------------------------------------- _____ Registration of all Patriquin Utilities with includes program disk and User's Guide...........@ $45.00 _____ Update Service -- in addition to above, send the next version automatically when it is available....@ +$15.00 -------------------------------------------------------------------- _____ PCOPY -- File Copy, Move, Backup, Update, more!...$20.00 _____ PSEARCH -- Locate files on your disk. Outstanding!..$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 _____ Update a registered set with new disk and manual - show proof of previous registration SER=_________....$15.00 _____ Shipping/Handling for orders outside USA, add ........$ 5.00 _______ Purchase Order Included. _______ Please invoice us. (Orders over $100 only) _______ Check or money Order (US FUNDS) included Total amount of my order is: $________ Disk Size (circle one)? 5 1/4 3 1/2 =================================================================== Name: __________________________________________________ Company: _______________________________________________ Address: _______________________________________________ _______________________________________________ City: ________________________ State: ________ Zip: __________ I learned about PCOPY from: _____________________________________ Send order to: Patri-Soft P.O. Box 8263 San Bernardino, CA 92412 PCOPY Users Guide/Reference Copyright 1990 Patri-Soft Page 31 ---------------------------------------------------------------------- Reporting Problems (PCOPY 8.5c) 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: ________________________________________________________________ ________________________________________________________________