home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT103B.ZIP / PALERT20.COM / PALERT.DOC < prev    next >
Text File  |  1990-08-06  |  13KB  |  382 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   P A L E R T
  17.  
  18.                                        by
  19.  
  20.                                     Patri-Soft
  21.  
  22.  
  23.  
  24.                                    Version 2.0
  25.                                    August 1990
  26.  
  27.  
  28.  
  29.  
  30.                        Support BBS --  Patriquin's BBS
  31.                                        714-369-9766 (DATA)
  32.  
  33.  
  34.  
  35.  
  36.                           Copyright 1990 by Patri-Soft
  37.  
  38.  
  39.  
  40.                         Table of Contents
  41.  
  42.  
  43.       What is PALERT. . . . . . . . . . . . . . . . . . . . . .   1
  44.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  45.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  46.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
  47.       Registering PALERT. . . . . . . . . . . . . . . . . . . .   7
  48.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  49.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  50.       Other Utilities . . . . . . . . . . . . . . . . . . . . .   9
  51.  
  52.  
  53.  
  54.  
  55.       What is PALERT
  56.       --------------
  57.  
  58.       PALERT is a utility program to help you avoid unexpectedly
  59.       running out of disk space and/or memory.  Many times application
  60.       programs terminate abnormally or disallow you from completing a
  61.       function because of insufficient disk space or memory.
  62.       Sometimes, this may cause you to lose valuable work time and
  63.       sometimes causes data to be lost. PALERT watches your disk space
  64.       and warns you when space is getting low.
  65.  
  66.       PALERT lets you specify your disk space needs and then watches
  67.       the disk until that limit is reached.  It then warns you of
  68.       the situation and lets you take appropriate action.  PALERT
  69.       is implemented as a standard DOS command that may be used
  70.       by itself or from a DOS batch command file.
  71.  
  72.       Implement PALERT before starting any application or program
  73.       where sufficient disk space is critical.  PALERT will save
  74.       you time and money.
  75.  
  76.       Features:
  77.       ─────────
  78.  
  79.         **  Checks disk space whenever you want to.
  80.  
  81.         **  Checks available memory
  82.  
  83.         **  Can trigger other commands based on insufficient
  84.             disk space and/or memory
  85.  
  86.         **  Many features to customize messages and actions
  87.  
  88.         **  Easy to install and use
  89.  
  90.                                                                 Page  2
  91.  
  92.       Command Mode Parameters
  93.       -----------------------
  94.  
  95.       PALERT allows several command parameter switches to be specified
  96.       to customize the process.  All these parameters are optional.
  97.       The command format and switch parameters are described below.  A
  98.       quick review of command parameters is always available by
  99.       entering the PALERT command with the /H parameter.
  100.  
  101.       COMMAND FORMAT:
  102.  
  103.       PALERT [drive:]    [ (/ switches) ]
  104.  
  105.  
  106.       [drive:]  If desired you may specify the drive where space
  107.                 is to be checked.  If the drive letter is not
  108.                 specified, the current defualt drive is checked.
  109.                 PALERT will also check multiple drives.  For example:
  110.                 PALERT CDE will check drives C, D, and E and give
  111.                 you a cumulative display.  (This alos works with all
  112.                 parameters)
  113.  
  114.  
  115.       /Wppp     Warn the user and set DOS ERRORLEVEL flag if the
  116.                 percentage of free disk space is less than the
  117.                 ppp value specified.
  118.  
  119.                 /W5 indicates to warn user if less than 5 percent
  120.                 of disk space is free.
  121.  
  122.  
  123.       /Bbbbb    Warn the user and set DOS ERRORLEVEL flag if the
  124.                 number of kilobytes of free disk space is less than
  125.                 the bbbb value specified.  The maximum value of
  126.                 bbbb is 32767.
  127.  
  128.                 /B3000 indicates to warn the user if less than
  129.                 3,000,000 characters of disk free space exist.
  130.  
  131.       /Lxxx     Warn when available memory is less than xxx.
  132.                 Sets the DOS ERRORLEVEL flag to 2.
  133.  
  134.                 PALERT /L400 will warn you if memory is below
  135.                 400,000 bytes.
  136.  
  137.       /E        SupprEss the disk check and check only memory
  138.  
  139.       /N        A scale that shows used disk space is normally
  140.                 shown to the user each time PALERT is run.  To
  141.                 prevent the scale from being displayed, enter the
  142.                 /N parameter.
  143.  
  144.  
  145.       /M        Messages are normally shown to indicate the Total,
  146.                 Used, and Free disk space.  If these messages are
  147.                 not normally wanted, enter the /M parameter.  Then
  148.                 they will only be issued when the user is warned.
  149.                                                                 Page  3
  150.  
  151.  
  152.       /P        After the user is warned of insufficient disk/memory
  153.                 space, PALERT will pause to make sure the user is aware
  154.                 of the situation.  To avoid this pause enter /P.
  155.  
  156.  
  157.       /S        When PALERT detects insufficient disk/memory space it
  158.                 sounds an alert to the user.  To avoid this noise
  159.                 specify the /S parameter.
  160.  
  161.  
  162.       /C        Each time PALERT is run it reminds the user that
  163.                 HELP is available by entering the /H parameter.  To
  164.                 avoid this message enter /C.
  165.  
  166.  
  167.       /H        PALERT contains internal help that is available at
  168.                 any time by using the /H parameter.
  169.  
  170.                                                                 Page  4
  171.  
  172.  
  173.       Examples:
  174.  
  175.       1.  Warn user when less than 1,000,000 characters of disk
  176.           space is available.
  177.  
  178.               ===> PALERT C: /B1000 /C
  179.  
  180.  
  181.       2.  Warn user when less than 5 percent of disk space is
  182.           available.
  183.  
  184.               ===> PALERT C: /W5 /C
  185.  
  186.  
  187.       3.  Warn user when less than 300K of memory is available:
  188.  
  189.               ===> PALERT /L300
  190.  
  191.  
  192.       4.  DOS batch file that will check disk space each time
  193.           the LOTUS command is entered.  If the desired disk
  194.           space is not available stop the command.
  195.  
  196.             PALERT /b2000/m
  197.             if errorlevel 1 goto error
  198.             LOTUS
  199.             goto end
  200.             :error
  201.             ECHO command terminated due to insufficient disk space
  202.             :end
  203.  
  204.           This sample DOS batch file may be found in the .ARC file
  205.           that contains this program.  Name=PA123.BAT.
  206.  
  207.                                                                 Page  5
  208.  
  209.  
  210.       Registering PALERT
  211.       ──────────────────
  212.  
  213.       PALERT is distributed under the Shareware concept.  This makes it
  214.       available for anyone to try without obligation.  If you decide it
  215.       is useful and want to keep it, I ask that you register your use
  216.       of it.  This will allow for continued support and maintenance of
  217.       the program and will help to encourage that more quality software
  218.       be made available through this channel.   We require all
  219.       corporate and government users of this utility register their
  220.       copies.
  221.  
  222.       To simply register the program, $10 is requested.  If you would
  223.       like the newest program disk and a copy of the manual send
  224.       $20.  If you would like to register all the Patriquin utilities,
  225.       and receive programs on disk and manuals, send $45.
  226.  
  227.  
  228.       Send registration requests to:
  229.  
  230.                       Patri-Soft
  231.                       P.O. Box 8263
  232.                       San Bernardino, CA   92412
  233.  
  234.  
  235.       The registration charge is a one time fee that entitles you to
  236.       all future versions of the product.  These may either be obtained
  237.       from normal Shareware sources or directly from me.  Any
  238.       organization ordering more than 100 copies is also entitled to
  239.       telephone support and will be given the technical support number.
  240.  
  241.       Following is a form that may be used to register PALERT.
  242.  
  243.                                                                 Page  6
  244.  
  245.                               PALERT Registration
  246.                                  Version 2.0
  247.  
  248.  
  249.       Please Register PALERT to the following person.  We will use ____
  250.       copies  of  the program and have enclosed $____ for each copy to
  251.       be used.
  252.  
  253.       ──────────────────────────────────────────────────────────────
  254.  
  255.       _____ Registration only .............................   $10.00
  256.  
  257.       _____ Registration, program disk and manual..........   $20.00
  258.  
  259.       _____ Registration of all Patriquin Utilities with
  260.                program disks and manuals...................   $45.00
  261.  
  262.       _____ Update of newest Patriquin Utility disk with
  263.                manual.  ...................................   $15.00
  264.  
  265.       ──────────────────────────────────────────────────────────────
  266.  
  267.  
  268.       Name: __________________________________________________
  269.  
  270.       Company: _______________________________________________
  271.  
  272.       Address: _______________________________________________
  273.  
  274.                _______________________________________________
  275.  
  276.       City: ______________________________  State: ___________
  277.  
  278.       Zip:  ______________________
  279.  
  280.       I obtained my copy of PALERT from: ____________________________
  281.  
  282.       If BBS indicate name and number please._________________________
  283.  
  284.       ________________________________________________________________
  285.  
  286.       Please register the software under the following name:
  287.  
  288.       ____________________________________________________
  289.  
  290.               Send to:
  291.                       Patri-Soft
  292.                       P.O. Box 8263
  293.                       San Bernardino, CA  92412
  294.                                                                 Page  7
  295.                           P A L E R T
  296.  
  297.       Problems and Maintenance
  298.       ------------------------
  299.  
  300.       I welcome all comments or enhancement suggestions. Please
  301.       document each item clearly and provide printed examples if
  302.       possible.  Please be sure to include this form with all requests,
  303.       it will help to make sure we can provide you with the best
  304.       possible service.
  305.  
  306.  
  307.       Name: __________________________________________________________
  308.  
  309.       Company: _______________________________________________________
  310.  
  311.       Address: _______________________________________________________
  312.  
  313.                _______________________________________________________
  314.  
  315.       City: __________________________________  State: _______________
  316.  
  317.       Zip: ______________________________
  318.  
  319.       Telephone: _______ / ________________________ (Home / Work)
  320.  
  321.  
  322.       Date: _________________________
  323.  
  324.       Description of problem or enhancement:
  325.  
  326.       ________________________________________________________________
  327.  
  328.       ________________________________________________________________
  329.  
  330.       ________________________________________________________________
  331.  
  332.       ________________________________________________________________
  333.  
  334.  
  335.       Suggested solution:
  336.  
  337.       ________________________________________________________________
  338.  
  339.       ________________________________________________________________
  340.                                                                 Page  8
  341.  
  342.       Program Maintenance:
  343.       --------------------
  344.  
  345.       Version 1.0     August 22, 1986
  346.  
  347.       Version 1.6     January 17, 1987
  348.                         --  Problem with large capacity disks printing
  349.                             incorrect space used percent.
  350.  
  351.       Version 2.0     August 8, 1990
  352.                         --  Added memory check
  353.                         --  Support for cumulative report of mulitple
  354.                             drives
  355.  
  356.  
  357.  
  358.       -----------------------------------------------------------------
  359.  
  360.  
  361.  
  362.       Other Patriquin Utilities:
  363.       --------------------------
  364.  
  365.       PSEARCH  --  Extensive file find and Text search capabilities in
  366.                 a menu driven environment.
  367.  
  368.       PCOPY/PMOVE  --  Complete file copy.move utility that prevents
  369.                 users from accidently losing files by using DOS COPY.
  370.                 Fast file movers are intelligent and move files to
  371.                 different hard disk directories without moving data.
  372.  
  373.       PTOUCH  --  Set date and time values on files specified
  374.                 through command parameters.
  375.  
  376.       PALERT  --  Warn users of insufficient disk space before it
  377.                 causes them problems.
  378.  
  379.       PDAILY  --  Perform any command or batch function only once
  380.                   per day.  Use in AUTOEXEC.BAT file.
  381.  
  382.