home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / 014r / pcopy5.zip / PCOPY.DOC next >
Text File  |  1986-10-12  |  26KB  |  683 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                             P M O V E   /   P C O P Y
  17.  
  18.                                        by
  19.  
  20.                                  Norm Patriquin
  21.  
  22.  
  23.  
  24.                                    Version 5.0
  25.                                   October 1986
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                        Copyright 1986 by Norm Patriquin
  34.  
  35.  
  36.  
  37.                         Table of Contents
  38.  
  39.  
  40.       What is PCOPY . . . . . . . . . . . . . . . . . . . . . .   1
  41.       What is PMOVE . . . . . . . . . . . . . . . . . . . . . .   1
  42.       About PCOPY . . . . . . . . . . . . . . . . . . . . . . .   2
  43.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   3
  44.       Command Mode Parameters . . . . . . . . . . . . . . . . .   5
  45.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .  11
  46.       Registering PCOPY . . . . . . . . . . . . . . . . . . . .  12
  47.       Registration Form . . . . . . . . . . . . . . . . . . . .  13
  48.       Problems and Maintenance. . . . . . . . . . . . . . . . .  14
  49.       Other Utilities . . . . . . . . . . . . . . . . . . . . .  16
  50.                                                                 Page  1
  51.  
  52.       What is PCOPY
  53.       -------------
  54.  
  55.       PCOPY is a DOS command utility used to copy files between disks
  56.       and directories on disks.  In addition to just copying files,
  57.       PCOPY also allows selection criteria to be specified to better
  58.       qualify the files to be copied.
  59.  
  60.       PCOPY provides a safer way to copy files than is provided by
  61.       the DOS COPY command.  It warns you if a file is about to be
  62.       overlayed and lets you have complete control over the copy
  63.       operation.
  64.  
  65.  
  66.       What is PMOVE
  67.       -------------
  68.  
  69.       PMOVE is a DOS command utility used to move files between
  70.       disks and directories on disks.  PMOVE combines the functions
  71.       of DOS COPY and DELETE commands to make make moving files
  72.       very easy.  In addition to just moving files, PMOVE also
  73.       allows selection criteria to be specified to better qualify
  74.       the files to be moved.
  75.  
  76.       PMOVE automatically determines the environment the move is
  77.       requested for and then determines if the data must be moved
  78.       or if the file can be moved by renaming.  Moving with rename
  79.       is allowed if the move is to another directory on the same
  80.       disk device.  If a rename move can be done, it is much faster
  81.       than moving the data, it helps to keep from fragmenting disk
  82.       free space, and allows very large files to be moved between
  83.       directories when they could not normally be moved with DOS
  84.       COPY because of insufficient space.
  85.  
  86.       In this implementation, PMOVE is implemented as a DOS batch
  87.       command file that uses PCOPY with the /X parameter.  If you
  88.       register PCOPY and ask for the complete utility disk you
  89.       will have two separate programs, PMOVE and PCOPY.  For the
  90.       remaining part of this documentation we will refer to the
  91.       program as PCOPY. Remember that the only difference between
  92.       PCOPY and PMOVE is that PMOVE removes the file from the
  93.       source location after it has been sucessfully copied to the
  94.       desired location.
  95.                                                                 Page  2
  96.  
  97.  
  98.       About PCOPY
  99.       -----------
  100.  
  101.       PCOPY is developed to allow standard DOS wildcard pathnames
  102.       in the source file specifications, and standard pathnames
  103.       for the target directory specification.  Wildcards are not
  104.       allowed for the target path specification.
  105.  
  106.       PCOPY attempts to anticipate your needs and help you accomplish
  107.       your task.  For instance, if PMOVE determines that the target
  108.       directory name does not exist, it will ask you if it is to be
  109.       created.  If you respond <YES>, the directory will be created
  110.       for you.  With the /SAve option,  if you are about to overlay
  111.       another file with a duplicate name, you will be asked if the
  112.       older duplicate file is to be renamed with a version number.
  113.  
  114.       PCOPY keeps you out of trouble.  If it saves you from
  115.       overlaying a needed file just once it has paid for itself.
  116.       Think of all the times it might have saved you in the past.
  117.  
  118.       I have tried to develop PCOPY with all the features normally
  119.       needed for this kind of utility.  I hope you find what you
  120.       need and that the utility is of use to you.
  121.  
  122.       For an immediate command summary, enter the PCOPY command without
  123.       any parameters.  Help panels will be displayed.
  124.  
  125.  
  126.                                                                 Page  3
  127.       Features:
  128.       ---------
  129.  
  130.         **  Copies files to and from any disk or directory.
  131.  
  132.         **  Allows you to save older versions of files with new
  133.             names before replacing them.
  134.  
  135.         **  Moves files by copying them or renaming them to the new
  136.             location.
  137.  
  138.         **  Deletes the original file if /X is specified.
  139.  
  140.         **  Creates target directorys if needed.
  141.  
  142.         **  Makes sure the DOS archive flag is set correctly for each
  143.             file as it is moved.
  144.  
  145.         **  Preserves the DOS date and time for each file moved.
  146.  
  147.         **  Allows user to pause processing at any time by pressing any
  148.             keyboard key.  Once stopped, the program can be terminated
  149.             by pressing <ESCAPE>.
  150.  
  151.         **  Provides file selection and processing control options
  152.             to tailor the move process to your own needs.
  153.  
  154.         **  Allows commands to be tested so you may be sure
  155.             that commands are specified as you desire.
  156.  
  157.         **  Copy updated files to a special disk or directory.
  158.  
  159.         **  If there is not sufficient space on the current target
  160.             disk, PMOVE will allow you to place another disk in the
  161.             drive and continue processing.  This allows you to easily
  162.             move groups of files larger than disk size to other
  163.             computers.
  164.  
  165.         **  Start with a specific file in a directory.
  166.  
  167.         **  End with a specific file in a directory.
  168.  
  169.         **  Process files based on the date stored in its directory
  170.             entry.
  171.                                                                 Page  4
  172.  
  173.         **  Warns you before overlaying a file unless specific
  174.             parameters indicating otherwise are specified.
  175.  
  176.         **  Checks target disk for available space before starting
  177.             to copy files.  This prevents time from being wasted
  178.             when the copy will not be able to complete.
  179.  
  180.         **  Gives you constant status of the progress of the
  181.             command.
  182.  
  183.         **  Runs with windows or using standard DOS screen output.
  184.  
  185.         **  Format new floppy disks as they are needed by pressing
  186.             <F3> at any prompt.
  187.  
  188.         **  Process one directory, a single directory subtree or
  189.             all directories on a disk (/S).
  190.  
  191.         **  Allows you to indicate that multiple input disks are
  192.             to be used and prompts for the next one after each
  193.             disk is processed.
  194.                                                                 Page  5
  195.  
  196.       Command Mode Parameters
  197.       -----------------------
  198.  
  199.       PCOPY allows several command parameter switches to be specified
  200.       to qualify the copy criteria.  All these parameters are
  201.       optional.  The PCOPY command is used like DOS COPY except for
  202.       these switches.  The command format and switch parameters are
  203.       described below.  A quick review of command parameters is always
  204.       available by entering the PCOPY command without any parameters.
  205.  
  206.  
  207.       COMMAND FORMAT:
  208.  
  209.       PCOPY from_file_spec [to_file_spec] [ (/ switches) ]
  210.  
  211.  
  212.       [from}    Enter the DOS file specification for the directory and
  213.                 file names to be moved.
  214.  
  215.                 The filename portion of the file specification may
  216.                 contain wildcard characters documented by DOS (* and
  217.                 ?).
  218.  
  219.  
  220.       [to]      Enter the DOS file specification for the directory and
  221.                 filename to be copied to.  If the "to" specification
  222.                 is not entered, files will be moved to the current
  223.                 directory.
  224.  
  225.  
  226.       /A        Archive - Selects only files that have been marked
  227.                 updated by DOS.  This flag is updated by DOS whenever
  228.                 a files is processed with an intent to change or
  229.                 create new data.
  230.  
  231.  
  232.       /B        BACKUP - When specified, the DOS Archive (Update)
  233.                 flag is reset after a file has been copied.
  234.  
  235.  
  236.       /C        Copy only.  Do not delete the file after it is copied.
  237.                 Only to be used with the PMOVE program.
  238.                                                                 Page  6
  239.  
  240.  
  241.       /D:[(]xxx Date.  Select files based on the relationship between
  242.          [)]    their last update date and the date specified.  This
  243.          [=]    parameter includes a date or number of days value.
  244.                 It may also contain a modifier that reverses or
  245.                 modifies the use of the date specified.
  246.  
  247.                 When xxx contains a date the date is compared to the
  248.                 last update date of the file.  The last update date
  249.                 of the file is the date contained in its directory
  250.                 entry.  The file is selected if the condition specified
  251.                 by the condition modifier is met.  The condition
  252.                 modifier meanings are:
  253.  
  254.                   '(' =  Select files whose date is older than the
  255.                          date specified.
  256.  
  257.                   ')' =  Select files whose date is newer than the
  258.                          date specified.
  259.  
  260.                   '=' =  Select files whose date is equal to the date
  261.                          specified.
  262.  
  263.                 If the condition modifier is not specified, ')' is
  264.                 assumed.
  265.  
  266.                 Date values may be specified in any of the following
  267.                 formats:
  268.  
  269.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  270.                     12/31/80   12-31-80   31DEC80
  271.  
  272.                 If xxx contains a numeric value, that positive number
  273.                 is used to calculate a date value a number of days
  274.                 prior to the current date.  Then that date is used
  275.                 as in the calculation above.
  276.  
  277.                 Example:
  278.  
  279.                 /D:(1JAN86  - Process files updated before 1JAN86
  280.                 /D:)1JAN86  - Process files updated after 1JAN86
  281.                 /D:=1JAN86  - Process files updated 1JAN86
  282.                 /D:(5  - Process files modified prior to 5 days ago
  283.                 /D:)5  - Process files modified within the last 5 days
  284.                 /D:=5  - Process files modified 5 days ago
  285.  
  286.  
  287.       /D-       Delete all files on target drive before starting copy.
  288.                                                                 Page  7
  289.  
  290.  
  291.       /DC       Directory Copy - When specified, the file is copied
  292.                 to a directory with the same name on the target disk
  293.                 volume.  Only use this parameter when copying data
  294.                 to a new disk drive.  See also the /S option.
  295.                 This is useful for copying all files and directories
  296.                 from one disk to another.
  297.  
  298.                 If the target directory does not exist it will
  299.                 automatically be created.
  300.  
  301.  
  302.       /E        Select and move only files that exist on both the "from"
  303.                 and "to" directories.  This causes all duplicate named
  304.                 files to be replaced.
  305.  
  306.  
  307.       /F:file   First.  Indicates that processing is not to start until
  308.                 the specified full filename is encountered in the
  309.                 scan of the directory.
  310.  
  311.                 This parameter is most useful in restarting a
  312.                 move or copy from a location where it had
  313.                 previously left off.
  314.  
  315.  
  316.       /L:file   Last.  Indicates that processing is to stop after
  317.                 the specified full filename is encountered in the
  318.                 scan of the directory. The file specified will be
  319.                 processed if it matches selection criteria.
  320.  
  321.  
  322.       /M        Stop screen from scrolling from scrolling past the end
  323.                 without user intervention (MORE).
  324.  
  325.  
  326.       /ME       MErge -- Works like using /U and /X parameter to move
  327.                 most current files from one directory into another.
  328.                 In addition, it deletes all the files that are not
  329.                 moved to the new location.  This has the effect of
  330.                 merging the most current files from two directories
  331.                 into a single directory.
  332.  
  333.  
  334.       /MU       MUltiple input disk are to be processed.  After
  335.                 the first input disk is processed the user is asked
  336.                 if another disk is to be processed.  If Yes is the
  337.                 response processing will continue like the first
  338.                 volume.
  339.  
  340.  
  341.       /N        Only move files that do not already exist on the target
  342.                 directory. (New files).  If the file already exists,
  343.                 no attempt will be made to move it and no warning
  344.                 message will be printed.
  345.                                                                 Page  8
  346.  
  347.  
  348.       /NW       No Windows - Do not use windows during processing.
  349.                 All screen output will be done through standard DOS
  350.                 facilities.
  351.  
  352.  
  353.       /O        Omit files from processing.  This option reverses the
  354.                 purpose of the source filespec in the command.  Instead
  355.                 if selecting those files, all files except those
  356.                 matching the filespec will be selected.
  357.  
  358.  
  359.       /P        Pause before each file is moved and ask for approval
  360.                 to process it.
  361.  
  362.  
  363.       /R        Replace any duplicate files on the target disk or
  364.                 directory regardless of their dates.
  365.  
  366.  
  367.       /RE       REgister the program.  Use this option to register
  368.                 your copy of the utility.  You will need to have
  369.                 the registration number and code that is sent to
  370.                 you when you ask to be registered.
  371.  
  372.                 Part of the registration screen also allows you
  373.                 to permanently modify the windows option.  If you
  374.                 do not want windows during processing use this
  375.                 option to change the windows program option.  You
  376.                 do not need to be registered to change this
  377.                 information.
  378.                                                                 Page  9
  379.  
  380.  
  381.       /RO       Read-Only.  Normally processing skips files marked
  382.                 with the DOS Read-Only attribute.  Using /RO causes
  383.                 Read-Only files to also be selected for processing.
  384.  
  385.  
  386.       /S        System -- If a source directory is supplied, that
  387.                 directory and all subordinate directories will be
  388.                 processed.  If no source directory is specified,
  389.                 all directories on the disk will be processed.
  390.  
  391.  
  392.       /SA       SAve -- Instead of overlaying already esisting files
  393.                 with duplicate names,  before the new file is copied,
  394.                 the file in the target directory is renamed with a
  395.                 version.  This insures that no data is possibly lost.
  396.  
  397.                 If the file has an extension name, the last two
  398.                 characters of the extension are replaced with a number
  399.                 from 01 to 99 depending on the next available
  400.                 number.  PCOPY determines the next available number
  401.                 by looking in the directory for other files with
  402.                 similar names.
  403.  
  404.                 This facility can be used to easily save versions of
  405.                 a file in a directory.
  406.  
  407.  
  408.       /SF       System Files.  Normally processing skips files marked
  409.                 with the DOS System attribute.  Using /SF causes
  410.                 System files to also be selected for processing.
  411.  
  412.  
  413.       /SZ: [(] [)]  nnn    Select a file based on its size.  The
  414.                 left paren indicates that files less than the
  415.                 indicated size are to be selected.  The right
  416.                 paren indicates to select files greater than the
  417.                 size.  If right or left paren are not specified,
  418.                 a left paren is assumed.  Following are examples.
  419.  
  420.                 /SZ:100    --  Select files less than 100 characters
  421.                 /SZ:(100   --  Select files less than 100 characters
  422.                 /SZ:)100   --  Select files greater than 100 characters
  423.  
  424.  
  425.       /T        Test the move process.  Use this switch when you
  426.                 would like to test the PMOVE command entered without
  427.                 actually moving any files or creating any directories.
  428.  
  429.                 Messages will indicate what will happen if the command
  430.                 is executed without the /T switch.
  431.                                                                 Page 10
  432.  
  433.  
  434.       /U        Only move files that do not exist on the target
  435.                 directory or duplicate filenames that are newer than
  436.                 their counterparts on the target directory or disk.
  437.  
  438.                 Use of this option results in the most current version
  439.                 of each selected file being at the target location.
  440.  
  441.  
  442.       /V        Verify -- Use the DOS verify option while copying
  443.                 data.  This causes all data to be reread after it
  444.                 is written to disk to insure it was written
  445.                 properly.
  446.  
  447.  
  448.       /X        Move the files.  Delete them after the copy is
  449.                 performed.  If the move is to another directory on the
  450.                 same disk the directory entry for the file is moved
  451.                 without having to move the data.  This provides for
  452.                 the fastest move possible.  Used for PCOPY only.
  453.                                                                 Page 11
  454.  
  455.  
  456.       Examples:
  457.  
  458.       1.  Copy all files in directory \GEN to directory \SAVE
  459.  
  460.              PCOPY \GEN \SAVE
  461.  
  462.  
  463.       2.  Copy all files in directory \GEN to directory \SAVE
  464.  
  465.              PCOPY \GEN \SAVE /C
  466.  
  467.  
  468.       3.  Copy all *.BAT files from current directory to \SAVE
  469.  
  470.              PCOPY *.BAT \SAVE
  471.                    or
  472.              PCOPY *.BAT \SAVE\*.*
  473.  
  474.  
  475.       4.  Move all files in current directory to disk in drive A:
  476.  
  477.              PMOVE *.* A:/X
  478.  
  479.  
  480.       5.  Update directory PAY with more current files from drive A:.
  481.           Save any old versions under generated version name.
  482.  
  483.              PCOPY A:*.* \PAY /R/SA
  484.  
  485.  
  486.       6.  Search hard disk C: for any files ending with .WKS and move
  487.           all the files to a new directory named \WKSDIR.
  488.  
  489.              PCOPY c:*.* c:\WKSDIR /X/S
  490.  
  491.  
  492.       7.  Copy all the files on the hard disk to multiple floppy disks
  493.           to be mounted in drive A:.
  494.  
  495.              PCOPY *.* a: /S
  496.  
  497.                                                                 Page 12
  498.  
  499.  
  500.       Registering PCOPY
  501.       -----------------
  502.  
  503.       PCOPY is distributed under the Shareware concept.  This makes it
  504.       available for anyone to try without obligation.  If you decide it
  505.       is useful and want to keep it, I ask that you register your use
  506.       of it.  This will allow for continued support and maintenance of
  507.       the program and will help to encourage that more quality software
  508.       be made available through this channel.   We require all
  509.       corporate and government users of this utility register their
  510.       copies.
  511.  
  512.       To simply register the program, $15 is requested.  If you would
  513.       like the newest program disk and a copy of the manual send
  514.       $30.  If you would like to register all the Patriquin utilities,
  515.       and receive programs on disk and manuals, send $45.
  516.  
  517.  
  518.       Send registration requests to:
  519.  
  520.                       Norm Patriquin
  521.                       P.O. Box 8308
  522.                       San Bernardino, CA   92412
  523.  
  524.  
  525.       The registration charge is a one time fee that entitles you to
  526.       all future versions of the product.  These may either be obtained
  527.       from normal Shareware sources or directly from me.  Any
  528.       organization ordering more than 100 copies is also entitled to
  529.       telephone support and will be given the technical support number.
  530.  
  531.       Following is a form that may be used to register PCOPY.
  532.  
  533.                                                                 Page 13
  534.  
  535.                               PCOPY Registration
  536.                                  Version 5.0
  537.  
  538.  
  539.       Please Register PCOPY to the following person.  We will use ____
  540.       copies  of  the program and have enclosed $____ for each copy to
  541.       be used.
  542.  
  543.       **************************************************************
  544.  
  545.       _____ Registration code and serial number............   $15.00
  546.  
  547.       _____ Registration, program disk and manual..........   $30.00
  548.  
  549.       _____ Registration of all Patriquin Utilities with
  550.                program disks and manuals...................   $45.00
  551.  
  552.       _____ Update of newest Patriquin Utility disk with
  553.                manual.  ...................................   $15.00
  554.  
  555.       **************************************************************
  556.  
  557.  
  558.       Name: __________________________________________________
  559.  
  560.       Company: _______________________________________________
  561.  
  562.       Address: _______________________________________________
  563.  
  564.                _______________________________________________
  565.  
  566.       City: ______________________________  State: ___________
  567.  
  568.       Zip:  ______________________
  569.  
  570.       I obtained my copy of PCOPY from: ____________________________
  571.  
  572.       If BBS indicate name and number please._________________________
  573.  
  574.       ________________________________________________________________
  575.  
  576.       Please register the software under the following name:
  577.  
  578.       ____________________________________________________
  579.  
  580.               Send to:
  581.                       Norm Patriquin
  582.                       P.O. Box 8308
  583.                       San Bernardino, CA  92412
  584.                                                                 Page 14
  585.                           P C O P Y
  586.  
  587.       Problems and Maintenance
  588.       ------------------------
  589.  
  590.       I welcome all comments or enhancement suggestions. Please
  591.       document each item clearly and provide printed examples if
  592.       possible.  Please be sure to include this form with all requests,
  593.       it will help to make sure we can provide you with the best
  594.       possible service.
  595.  
  596.  
  597.       Name: __________________________________________________________
  598.  
  599.       Company: _______________________________________________________
  600.  
  601.       Address: _______________________________________________________
  602.  
  603.                _______________________________________________________
  604.  
  605.       City: __________________________________  State: _______________
  606.  
  607.       Zip: ______________________________
  608.  
  609.       Telephone: _______ / ________________________ (Home / Work)
  610.  
  611.  
  612.       Date: _________________________
  613.  
  614.       Description of problem or enhancement:
  615.  
  616.       ________________________________________________________________
  617.  
  618.       ________________________________________________________________
  619.  
  620.       ________________________________________________________________
  621.  
  622.       ________________________________________________________________
  623.  
  624.  
  625.       Suggested solution:
  626.  
  627.       ________________________________________________________________
  628.  
  629.       ________________________________________________________________
  630.                                                                 Page 15
  631.  
  632.       Program Maintenance:
  633.  
  634.       Version 1.0
  635.          --  Multiple file move/copy utility with /U /N and /R
  636.              parameters.
  637.  
  638.  
  639.       Version 2.0     June 1986
  640.          --  Added ability to create directory and detect full disks.
  641.  
  642.  
  643.       Version 3.0     August 1986
  644.          --  Window operation added.
  645.  
  646.          --  Improved help.
  647.  
  648.          --  /B  /DC  /D-  /E  /RE  /S  /SA  /SF  /V
  649.  
  650.  
  651.       Version 4.0     August 18, 1986
  652.          --  /ME /SF /RO parameters added.
  653.  
  654.          --  Corrected problem with /DC parameter and directory
  655.              scanning.
  656.  
  657.  
  658.       Version 5.0     October 13, 1986
  659.          --  Corrected /B parameter to reset backup directory
  660.              indicator after file is processed.
  661.  
  662.          --  Added /MU parameter to process multiple input disk
  663.              volumes.
  664.  
  665.          --  Various documentation corrections.  Special thanks
  666.              to Edward Koch for technical editing of the document.
  667.  
  668.          --  Correct /ME parameter.  Merge was deleting the target
  669.              file, not the source.
  670.  
  671.          --  Added selection by size with /SZ:nnn
  672.  
  673.          --  Suspend and execute a DOS command from any question or
  674.              prompt.  Press <F3> to accomplish this.  This is
  675.              particularly useful to format new floppy disks when
  676.              new ones are needed.
  677.  
  678.          --  Process a directory tree if /S is specified and
  679.              a directory name is supplied in the source specification.
  680.              Previous releases would only process a single directory,
  681.              without /S, or the entire disk with the /S parm.
  682.  
  683.