home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / arc_lbr / arcfdat3.arc / ARCFDATE.DOC < prev    next >
Text File  |  1987-11-28  |  12KB  |  368 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       P A T R I Q U I N ' S
  8.  
  9.                        Hard Disk Utilities
  10.  
  11.  
  12.                                by
  13.  
  14.  
  15.                         Norm J. Patriquin
  16.  
  17.  
  18.               ARCFDATE  -- Change archive file date
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                           User's Guide
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                          November  1987
  39.  
  40.  
  41.  
  42.  
  43.                 Copyright 1987 by Norm Patriquin
  44.  
  45.  
  46. ARCFDATE  --  Correct file dates for archive files  . . . . .    1
  47.      Command Parameters . . . . . . . . . . . . . . . . . . .    2
  48.      Examples:  . . . . . . . . . . . . . . . . . . . . . . .    5
  49.      Program Maintenance: . . . . . . . . . . . . . . . . . .    5
  50.  
  51. Registering The Utilities . . . . . . . . . . . . . . . . . .    6
  52.  
  53. Registration  . . . . . . . . . . . . . . . . . . . . . . . .    7
  54.  
  55. Reporting Problems  . . . . . . . . . . . . . . . . . . . . .    9
  56.  
  57.  
  58. ARCFDATE  --  Correct file dates for archive files
  59.  
  60. ARCFDATE was created to help you keep meaningful dates on .ARC
  61. files on your disks.  Often the date on .ARC files are incorrect
  62. and examining them with the DOS directory command does not reveal
  63. how current the file really is.  This utility will set the archive
  64. file date to be equal to the date of the newest file found in the
  65. archive.
  66.  
  67. This can be especially helpful to bulletin board SYSOPS as it can
  68. help then to determine what are the current files in the boards
  69. download directory.
  70.  
  71.  
  72. Command Parameters
  73.  
  74. ARCFDATE allows several command parameter switches to be specified
  75. to customize the process.  All these parameters are optional. The
  76. command format and switch parameters are described below.  A quick
  77. review of command parameters is always available by entering the
  78. ARCFDATE command with no parameters.
  79.  
  80.      COMMAND FORMAT:
  81.  
  82.      ARCFDATE  filespec  [ (/ switches) ]
  83.  
  84.      filespec  Enter a DOS file specification.  Pathnames and
  85.                standard DOS wildcard characters are allowed.
  86.  
  87.  
  88.      /A        Archive - Selects only files that have been marked
  89.                updated by DOS.  This flag is updated by DOS
  90.                whenever a files is processed with an intent to
  91.                change or create new data.
  92.  
  93.  
  94.      /D:[(]xxx Date.  Select files based on the relationship
  95.                between
  96.         [)]    their last update date and the date specified.
  97.                This
  98.         [=]    parameter includes a date or number of days value.
  99.                It may also contain a modifier that reverses or
  100.                modifies the use of the date specified.
  101.  
  102.                When xxx contains a date the date is compared to
  103.                the last update date of the file.  The last update
  104.                date of the file is the date contained in its
  105.                directory entry.  The file is selected if the
  106.                condition specified by the condition modifier is
  107.                met.  The condition modifier meanings are:
  108.  
  109.                '('  Select files whose date is older than the date
  110.                     specified.
  111.  
  112.                ')'  Select files whose date is newer than the date
  113.                     specified.
  114.  
  115.                '='  Select files whose date is equal to the date
  116.                     specified.
  117.  
  118.                If the condition modifier is not specified, ')' is
  119.                assumed.
  120.  
  121.                Date values may be specified in any of the
  122.                following formats:
  123.  
  124.                     MM/DD/YY       MM-DD-YY  DDMMMYY
  125.                     12/31/80       12-31-80  31DEC80
  126.  
  127.                If xxx contains a numeric value, that positive
  128.                number is used to calculate a date value a number
  129.                of days prior to the current date.  Then that date
  130.                is used as in the calculation above.
  131.  
  132.                Example:
  133.  
  134.                /D:(1JAN86  - Process files updated before 1JAN86
  135.                /D:)1JAN86  - Process files updated after 1JAN86
  136.                /D:=1JAN86  - Process files updated 1JAN86
  137.                /D:(5  - Process files modified prior to 5 days ago
  138.                /D:)5  - Process files modified within the last 5
  139.                days
  140.                /D:=5  - Process files modified 5 days ago
  141.  
  142.  
  143.      /F:file   First.  Indicates that processing is not to start
  144.                until the specified full filename is encountered in
  145.                the scan of the directory.
  146.  
  147.  
  148.      /L:file   Last.  Indicates that processing is to stop after
  149.                the specified full filename is encountered in the
  150.                scan of the directory. The file specified will be
  151.                processed if it matches selection criteria.
  152.  
  153.  
  154.      /M        Stop screen from scrolling from scrolling past the
  155.                end without user intervention (MORE).
  156.  
  157.  
  158.      /NC       Do not display output in color.
  159.  
  160.  
  161.      /O        Indicates that all filenames except those matching
  162.                the filename specified on the input command are to
  163.                be selected for processing.
  164.  
  165.  
  166.      /P        Pause before each file is updated to allow user to
  167.                approve or reject the action for each file.
  168.  
  169.  
  170.      /RO       Include files marked with DOS readonly attribute.
  171.  
  172.  
  173.      /S        System.  Search all directories on the specified
  174.                disk for files to be processed.
  175.  
  176.  
  177.      /SF       Include files marked with DOS System attribute.
  178.  
  179.  
  180.      /SZ: [(] [)]  nnn  Select a file based on its size.  The
  181.                left paren indicates that files less than the
  182.                indicated size are to be selected.  The right paren
  183.                indicates to select files greater than the size.
  184.                If right or left paren are not specified, a left
  185.                paren is assumed.  Following are examples.
  186.  
  187.                /SZ:100  --    Select files less than 100
  188.                               characters
  189.                /SZ:(100 --    Select files less than 100
  190.                               characters
  191.                /SZ:)100 --    Select files greater than 100
  192.                               characters
  193.  
  194.  
  195.      /T        Test the command.  Use this switch when you would
  196.                like to test the command entered without actually
  197.                updating any files.
  198.  
  199.                Messages will indicate what will happen if the
  200.                command is executed without the /T switch.
  201.  
  202.  
  203.  
  204.      Examples:
  205.  
  206.           Reset dates on all archive files in the current
  207.           directory.
  208.  
  209.                ARCFDATE *
  210.  
  211.  
  212.           Test ARCFDATE to determine what it will do.  Do not
  213.           actually change any files.  Use this first to be sure
  214.           you are using the utility correctly.
  215.  
  216.                ARCFDATE */t
  217.  
  218.  
  219.           Reset archive dates on all files on the current disk
  220.           drive.
  221.  
  222.                ARCFDATE */s
  223.  
  224.  
  225.           Reset archive dates on all files beginning with the
  226.           letter P.
  227.  
  228.                ARCFDATE p*/s
  229.  
  230.  
  231.           Reset archive date on an individual file:
  232.  
  233.                ARCFDATE PCOPY62.ARC
  234.  
  235.  
  236.  
  237.      Program Maintenance:
  238.  
  239.      Version 1.0         September 7, 1987
  240.      Version 1.2         September 23, 1987
  241.         Processing stopped after several errors encountered.
  242.      Version 1.3         November 28, 1987
  243.         Correct problem causing system hangup after message shown.
  244.  
  245. Registering The Utilities
  246.  
  247. All utilities are distributed under the Shareware concept.  This
  248. makes them available for anyone to try without obligation.  If you
  249. decide one is useful and want to keep it, I ask that you register
  250. your use of it.  This will allow for continued support and
  251. maintenance of the program and will help to encourage that more
  252. quality software be made available through this channel.   We ask
  253. all corporate and government users of utilities register their
  254. copies.
  255.  
  256. The form on the following page indicates registration costs and
  257. may be used to register any or all of the utilities.
  258.  
  259.      Send registration requests to:
  260.  
  261.                     Norm Patriquin
  262.                     P.O. Box 8263
  263.                     San Bernardino, CA   92412
  264.  
  265.  
  266. The registration charge is a one time fee that entitles you to all
  267. future versions of the product.  These may either be obtained from
  268. normal Shareware sources or directly from me.  Any organization
  269. ordering more than 100 copies is also entitled to telephone
  270. support and will be given the technical support number.
  271.                          Registration
  272.                       ARCFDATE version 1.3
  273.  
  274. Please register the following utilities.  I have enclosed the fees
  275. as marked below.
  276.  
  277. _____ PALERT........................................    $15.00
  278. _____ PATTR.........................................    $10.00
  279. _____ PCOPY & PMOVE.................................    $15.00
  280. _____ PDAILY........................................    $10.00
  281. _____ PDELETE.......................................    $15.00
  282. _____ PPRINT........................................    $15.00
  283. _____ PSEARCH.......................................    $15.00
  284. _____ ARCFDATE......................................    $15.00
  285. _____ PTOUCH........................................   No Charge
  286.  
  287. _____ Users Guide for all utilities and disk........
  288.           (Does not include registration)               $15.00
  289.  
  290. _____ Registration of all Patriquin Utilities with
  291.          program disk and User's Guide..............   $45.00
  292.  
  293. _____ Update of newest Patriquin Utility disk with
  294.          manual.  ...................................  $15.00
  295.  
  296. _____ Disk source for all utilities.  This does not
  297.       include source for other vendors C tools
  298.       packages used for development.................. $200.00
  299.  
  300. ****************************************************************
  301.  
  302. Name: __________________________________________________
  303.  
  304. Company: _______________________________________________
  305.  
  306. Address: _______________________________________________
  307.  
  308.          _______________________________________________
  309.  
  310. City: ________________________  State: _______  Zip: ________
  311.  
  312. I learned about the utilities from: ____________________________
  313.  
  314. If BBS indicate name and number please._________________________
  315.  
  316. ________________________________________________________________
  317.  
  318. Please register the software under the following name:
  319.  
  320. ____________________________________________________
  321.  
  322.           Send to:  Norm Patriquin
  323.                     P.O. Box 8263
  324.                     San Bernardino, CA  92412 Reporting Problems
  325.  
  326. I welcome all comments or enhancement suggestions. Please document
  327. each item clearly and provide printed examples if possible.
  328. Please be sure to include this form with all requests, it will
  329. help to make sure we can provide you with the best possible
  330. service.
  331.  
  332.  
  333. Name: __________________________________________________________
  334.  
  335. Company: _______________________________________________________
  336.  
  337. Address:   _______________________________________________________
  338.  
  339.            ______________________________________________________
  340.  
  341. City: __________________________________  State: _______________
  342.  
  343. Zip: ______________________________
  344.  
  345. Telephone: _______ / ________________________ (Home / Work)
  346.  
  347.  
  348. Date: _________________________
  349.  
  350.  
  351. Name of Utility: _______________________________________________
  352.  
  353. Description of problem or enhancement:
  354.  
  355. ________________________________________________________________
  356.  
  357. ________________________________________________________________
  358.  
  359. ________________________________________________________________
  360.  
  361. ________________________________________________________________
  362.  
  363. Suggested solution:
  364.  
  365. ________________________________________________________________
  366.  
  367. ________________________________________________________________
  368.