home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / 014r / pdel12.zip / PDEL.DOC next >
Text File  |  1987-01-07  |  15KB  |  449 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                   P D E L E T E
  20.  
  21.                                        by
  22.  
  23.                                  Norm Patriquin
  24.  
  25.  
  26.  
  27.                                    Version 1.2
  28.                                    January 1987
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.        Questions and support --  Patriquin's BBS  714-369-9766 (data)
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                        Copyright 1986 by Norm Patriquin
  44.  
  45.  
  46.  
  47.                         Table of Contents
  48.  
  49.  
  50.       What is PDELETE . . . . . . . . . . . . . . . . . . . . .   1
  51.  
  52.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  53.  
  54.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  55.  
  56.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   7
  57.  
  58.       Registration. . . . . . . . . . . . . . . . . . . . . . .   8
  59.  
  60.       Problems and Maintenance. . . . . . . . . . . . . . . . .  10
  61.  
  62.       Version History . . . . . . . . . . . . . . . . . . . . .  11
  63.  
  64.                                                                 Page  1
  65.  
  66.  
  67.       What is PDELETE
  68.       ---------------
  69.  
  70.       PDELETE is an advanced Delete command to be used in DOS operating
  71.       systems.  It may be used in place of the DOS Erase and Delete
  72.       command or instead of it.  Like other Patriquin utilities, PDELETE
  73.       gives you more control of command processing and provides a much
  74.       safer way to process files.  PDELETE also provides several
  75.       features not found with the standard DOS command.
  76.  
  77.       Unlike other delete utilities, PDELETE does support DOS paths and
  78.       wildcards.  It keeps you aware of what files are being processed
  79.       and provides an emergency stop feature just in case you have
  80.       started something you feel is wrong.
  81.  
  82.       PDELETE's file selection parameters provide you with numerous
  83.       options for specifying the files to be deleted.  You may select by
  84.       directory, file, date, attribute, size, and even starting and
  85.       ending filename.
  86.  
  87.  
  88.                                                                 Page  2
  89.  
  90.  
  91.       Features:
  92.       ---------
  93.  
  94.         **  Advanced file selection
  95.  
  96.         **  Emergency STOP by pressing any key
  97.  
  98.         **  Delete entire directories and remove them from disk
  99.  
  100.         **  Optionally wipe file data from disk during delete to
  101.             prevent it from being recovered by unauthorized
  102.             person.
  103.  
  104.         **  Optional verify feature lets you approve each file
  105.             before it is deleted
  106.  
  107.         **  Optionally deletes HIDDEN / SYSTEM / READONLY files
  108.  
  109.         **  Delete files until specified freespace is available
  110.  
  111.                                                                 Page  3
  112.  
  113.  
  114.       Command Parameters
  115.       ------------------
  116.  
  117.       PDELETE allows several command parameter switches to be specified
  118.       to customize the process.  All these parameters are optional.
  119.       The command format and switch parameters are described below.  A
  120.       quick review of command parameters is always available by
  121.       entering the PDEL command with no parameters.
  122.  
  123.       COMMAND FORMAT:
  124.  
  125.       PDEL    filespec  [ (/ switches) ]
  126.  
  127.  
  128.       filespec  Enter a DOS file specification.  Pathnames and
  129.                 standard DOS wildcard characters are allowed.
  130.  
  131.  
  132.       /A        Archive - Selects only files that have been marked
  133.                 updated by DOS.  This flag is updated by DOS whenever
  134.                 a files is processed with an intent to change or
  135.                 create new data.
  136.  
  137.  
  138.                                                                 Page  4
  139.  
  140.  
  141.       /D:[(]xxx Date.  Select files based on the relationship between
  142.          [)]    their last update date and the date specified.  This
  143.          [=]    parameter includes a date or number of days value.
  144.                 It may also contain a modifier that reverses or
  145.                 modifies the use of the date specified.
  146.  
  147.                 When xxx contains a date the date is compared to the
  148.                 last update date of the file.  The last update date
  149.                 of the file is the date contained in its directory
  150.                 entry.  The file is selected if the condition specified
  151.                 by the condition modifier is met.  The condition
  152.                 modifier meanings are:
  153.  
  154.                   '(' =  Select files whose date is older than the
  155.                          date specified.
  156.  
  157.                   ')' =  Select files whose date is newer than the
  158.                          date specified.
  159.  
  160.                   '=' =  Select files whose date is equal to the date
  161.                          specified.
  162.  
  163.                 If the condition modifier is not specified, ')' is
  164.                 assumed.
  165.  
  166.                 Date values may be specified in any of the following
  167.                 formats:
  168.  
  169.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  170.                     12/31/80   12-31-80   31DEC80
  171.  
  172.                 If xxx contains a numeric value, that positive number
  173.                 is used to calculate a date value a number of days
  174.                 prior to the current date.  Then that date is used
  175.                 as in the calculation above.
  176.  
  177.                 Example:
  178.  
  179.                 /D:(1JAN86  - Process files updated before 1JAN86
  180.                 /D:)1JAN86  - Process files updated after 1JAN86
  181.                 /D:=1JAN86  - Process files updated 1JAN86
  182.                 /D:(5  - Process files modified prior to 5 days ago
  183.                 /D:)5  - Process files modified within the last 5 days
  184.                 /D:=5  - Process files modified 5 days ago
  185.                                                                 Page  5
  186.  
  187.  
  188.       /DI       Delete the disk DIrectory specified in the command.
  189.                 This will remove the directory, all files within
  190.                 it and all the directories and files subordinate
  191.                 to it.
  192.  
  193.                 Only use this as a stand alone parameter.  Use a
  194.                 command like the following one to remove a directory
  195.                 from your disk:
  196.  
  197.                    PDEL \OLDDIR /DI
  198.  
  199.                         --  or  --
  200.  
  201.                    PDEL \OLDDIR\*.* /DI
  202.  
  203.  
  204.       /F:file   First.  Indicates that processing is not to start until
  205.                 the specified full filename is encountered in the
  206.                 scan of the directory.
  207.  
  208.  
  209.       /FS:nnnn  Freespace.  PDELETE will delete files as long as
  210.                 there is less than nnnn thousand (nnnn * 000)
  211.                 of free space available on the disk.  This is very
  212.                 helpful for cleaning up disks but retaining as many
  213.                 files as possible.
  214.  
  215.       /L:file   Last.  Indicates that processing is to stop after
  216.                 the specified full filename is encountered in the
  217.                 scan of the directory. The file specified will be
  218.                 processed if it matches selection criteria.
  219.  
  220.  
  221.  
  222.       /M        Stop screen from scrolling from scrolling past the end
  223.                 without user intervention (MORE).
  224.  
  225.  
  226.       /O        Indicates that all filenames except those matching
  227.                 the filename specified on the input command are to
  228.                 be selected for processing.
  229.  
  230.  
  231.  
  232.       /P        Pause before each file is updated to allow user
  233.                 to approve or reject the action for each file.
  234.  
  235.  
  236.                                                                 Page  6
  237.  
  238.  
  239.       /RO       Include files marked with DOS readonly attribute.
  240.  
  241.  
  242.       /RE       If the file to be deleted has a DOS attribute of
  243.                 Hidden, System, or Readonly, REset it so proper
  244.                 delete may occur.
  245.  
  246.  
  247.       /SF       Include files marked with DOS System attribute.
  248.  
  249.  
  250.       /SZ: [(] [)]  nnn    Select a file based on its size.  The
  251.                 left paren indicates that files less than the
  252.                 indicated size are to be selected.  The right
  253.                 paren indicates to select files greater than the
  254.                 size.  If right or left paren are not specified,
  255.                 a left paren is assumed.  Following are examples.
  256.  
  257.                 /SZ:100    --  Select files less than 100 characters
  258.                 /SZ:(100   --  Select files less than 100 characters
  259.                 /SZ:)100   --  Select files greater than 100 characters
  260.  
  261.  
  262.       /T        Test the command.  Use this switch when you
  263.                 would like to test the command entered without
  264.                 actually updating any files.
  265.  
  266.                 Messages will indicate what will happen if the command
  267.                 is executed without the /T switch.
  268.  
  269.  
  270.       /W        For data security, erase all disk areas that
  271.                 contain the file when it is deleted.  This
  272.                 will prevent unauthorized users from
  273.                 recovering the file or examining its data
  274.                 by using special disk utilities.
  275.  
  276.  
  277.  
  278.                                                                 Page  7
  279.  
  280.  
  281.       Examples:
  282.  
  283.          Delete all *.BAK files on current default drive
  284.  
  285.              PDEL *.BAK /S
  286.  
  287.  
  288.  
  289.          Delete all *.BAK files over 30 days old
  290.  
  291.              PDEL *.BAK /S/D:(30
  292.  
  293.  
  294.  
  295.          Remove directory \ACCTING1 from drive a:
  296.  
  297.              PDEL A:\ACCTING1 /DI
  298.  
  299.                                                                 Page  8
  300.  
  301.  
  302.       Registering PDELETE
  303.       -------------------
  304.  
  305.       PDELETE is distributed under the Shareware concept.  This makes it
  306.       available for anyone to try without obligation.  If you decide it
  307.       is useful and want to keep it, I ask that you register your use
  308.       of it.  This will allow for continued support and maintenance of
  309.       the program and will help to encourage that more quality software
  310.       be made available through this channel.   We require all
  311.       corporate and government users of this utility register their
  312.       copies.
  313.  
  314.       To simply register the program, $15 is requested.  If you would
  315.       like the newest program disk and a copy of the manual send
  316.       $30.  If you would like to register all the Patriquin utilities,
  317.       and receive programs on disk and manuals, send $45.
  318.  
  319.  
  320.       Send registration requests to:
  321.  
  322.                       Norm Patriquin
  323.                       P.O. Box 8308
  324.                       San Bernardino, CA   92412
  325.  
  326.  
  327.       The registration charge is a one time fee that entitles you to
  328.       all future versions of the product.  These may either be obtained
  329.       from normal Shareware sources or directly from me.  Any
  330.       organization ordering more than 100 copies is also entitled to
  331.       telephone support and will be given the technical support number.
  332.  
  333.       Following is a form that may be used to register PDELETE.
  334.  
  335.                                                                 Page  9
  336.  
  337.                              PDELETE Registration
  338.                                  Version 1.2
  339.  
  340.  
  341.       Please Register PDELETE to the following person.  We will use ____
  342.       copies  of  the program and have enclosed $____ for each copy to
  343.       be used.
  344.  
  345.       **************************************************************
  346.  
  347.       _____ Registration only..............................   $15.00
  348.  
  349.       _____ Registration, program disk and manual..........   $30.00
  350.  
  351.       _____ Registration of all Patriquin Utilities with
  352.                program disks and manuals...................   $45.00
  353.  
  354.       _____ Update of newest Patriquin Utility disk with
  355.                manual.  ...................................   $15.00
  356.  
  357.       **************************************************************
  358.  
  359.  
  360.       Name: __________________________________________________
  361.  
  362.       Company: _______________________________________________
  363.  
  364.       Address: _______________________________________________
  365.  
  366.                _______________________________________________
  367.  
  368.       City: ______________________________  State: ___________
  369.  
  370.       Zip:  ______________________
  371.  
  372.       I obtained my copy of PDELETE from: ____________________________
  373.  
  374.       If BBS indicate name and number please._________________________
  375.  
  376.       ________________________________________________________________
  377.  
  378.       Please register the software under the following name:
  379.  
  380.       ____________________________________________________
  381.  
  382.               Send to:
  383.                       Norm Patriquin
  384.                       P.O. Box 8308
  385.                       San Bernardino, CA  92412
  386.                                                                 Page 10
  387.                           P D E L E T E
  388.  
  389.       Problems and Maintenance
  390.       ------------------------
  391.  
  392.       For online support -- Call Patriquin's BBS 714-369-9766
  393.  
  394.       I welcome all comments or enhancement suggestions. Please
  395.       document each item clearly and provide printed examples if
  396.       possible.  Please be sure to include this form with all requests,
  397.       it will help to make sure we can provide you with the best
  398.       possible service.
  399.  
  400.  
  401.       Name: __________________________________________________________
  402.  
  403.       Company: _______________________________________________________
  404.  
  405.       Address: _______________________________________________________
  406.  
  407.                _______________________________________________________
  408.  
  409.       City: __________________________________  State: _______________
  410.  
  411.       Zip: ______________________________
  412.  
  413.       Telephone: _______ / ________________________ (Home / Work)
  414.  
  415.  
  416.       Date: _________________________
  417.  
  418.       Description of problem or enhancement:
  419.  
  420.       ________________________________________________________________
  421.  
  422.       ________________________________________________________________
  423.  
  424.       ________________________________________________________________
  425.  
  426.       ________________________________________________________________
  427.  
  428.  
  429.       Suggested solution:
  430.  
  431.       ________________________________________________________________
  432.  
  433.       ________________________________________________________________
  434.                                                                 Page 11
  435.                           P D E L E T E
  436.  
  437.       Program Maintenance:
  438.       --------------------
  439.  
  440.       Version 1.0     October 10, 1986
  441.  
  442.       Version 1.2     January 6, 1987
  443.                    --  Corrected bug that sometimes incorrectly
  444.                        processed filenames without extension names.
  445.                    --  Added /FS parm to delete until spec freespace
  446.                        is available.
  447.  
  448.  
  449.