home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 184.lha / Storage4.DOC < prev    next >
Encoding:
Text File  |  1988-04-29  |  6.4 KB  |  221 lines
  1.  
  2.  
  3.             Disk Storage 4.00   By: Khalid Aldoseri.
  4.             ----------------------------------------
  5.             
  6.             
  7.     This is a small program that will run from either the WB or CLI.  It will
  8. open its own window and display a list of ALL currently mounted devices,
  9. including hard disk partitions.  The window looks like this:
  10.  
  11.  
  12.  
  13.                 Name:    Size   Free  Alarm
  14.     
  15.                 DF0:      837     10     50
  16.                 DF1:      837    129     50
  17.                 DF2:    - No Disk Present -
  18.                 DH0:    19864   6742    993
  19.                 DH1:    19734   1118    986
  20.     
  21.     
  22.     
  23.     The Size column gives the actual capacity of the device in Kilobytes.
  24. The Free columns gives the free space in the device.  The Alarm column
  25. is the level at (or below) which the program will highlight the device
  26. row to warn you that there isn't much free space left in the device.  If
  27. the free space drops below the Alarm level while the program is running
  28. it will flash all screens five times while also flashing the relevant item.
  29. (P.S. The program will correctly reflect the size of the WB1.3 Fast File
  30. System (FFS) hard disk partitions, and any other new disk formats.)
  31.  
  32.  
  33.     The Alarm level normally is 5% of the total capacity of the device
  34. with a minimum alarm level of 50k.  You can change the Alarm level by
  35. clicking on the device row you want to change.  A gadget will appear at
  36. the bottom of the window.  Enter the new Alarm level and hit return.
  37.  
  38.  
  39. *    If a floppy disk has the write-protect tab on, an asterisk (*) will
  40. appear next to the 'Free' number corresponding to that disk.
  41.  
  42.  
  43.     The program will update its display every 3 seconds.  If you need to
  44. get an immediate update just click on the first line, (the one with
  45. the titles.)  The program's window will be as big as it needs to be to
  46. display all the mounted devices.  The limit for that is 15 devices.
  47.  
  48.  
  49. *    If you want the program to update its display more/less than 3 seconds,
  50. there is a small gadget near the upper right hand side of the window,
  51. (next to the 'Alarm' text).  Just click on this gadget and move it up
  52. or down to decrease or increase update time.  The window title will
  53. display the update rate as long as you are holding down the mouse button.
  54. If you select the 'No Update' setting, then you can manually update the
  55. window by clicking on either the memory display box, or the top line
  56. of the window.  (the one with 'Name   Full   Free  Alarm').
  57.     
  58.  
  59.     At the bottom of the window there is a small box with the current
  60. free memory in the system.  This is displayed as Chip, Fast and Total,
  61. or as Chip, Fast and Static if there is any free memory above the normal
  62. system addressing space (e.g. the CSA 32-bit memory board.)
  63.  
  64.  
  65.     
  66.  
  67.  
  68.     The program has a menu attached to it with the following options:
  69.  
  70.     
  71.     CLEAR ALL:
  72.  
  73.     This will reset the program to its original startup state.
  74.  
  75.  
  76.     CLEAR SELECTIONS:
  77.  
  78.     This will clear all currently selected disks.  (More on this later.)
  79.  
  80.  
  81.     REMOVE SELECTED DISKS:
  82.  
  83.     This will remove disks from the display list.  To do this just click
  84.     twice on each disk name you want to remove (the background color of
  85.     the line will change twice) and then select this menu item.  You
  86.     can remove more than one disk at a time.  Any disk removed will NOT
  87.     be checked for its alarm level any more.
  88.  
  89.     
  90.     REMOVE FLOPPY DISKS:
  91.  
  92.     This will remove all floppy disks from the display list.
  93.  
  94.  
  95.  
  96.     REMOVE ALL EXCEPT FLOPPIES:
  97.  
  98.     No explanation needed!
  99.  
  100.  
  101.     REMOVE DISKS < (LESS THAN) ALARM LEVEL:
  102.  
  103.     This will remove all disks that are currently less that the Alarm
  104.     Level.  (i.e. are currenly highlighted)
  105.  
  106.  
  107.     REMOVE DISKS > (MORE THAN) ALARM LEVEL:
  108.  
  109.     The opposite of the above.
  110.  
  111.  
  112.     REMOVE ALL DISKS:
  113.  
  114.     Removes everything, and just keeps the memory display on.
  115.  
  116.  
  117.     SWITCH MEMORY DISPLAY ON/OFF:
  118.  
  119.     Turns the memory display on or off.
  120.  
  121.  
  122. *    SWITCH TIME DISPLAY ON/OFF:
  123.  
  124.     This turns on/off time and date display on the top of the program's
  125.     window.
  126.  
  127.         
  128. *    DISPLAY MEMORY CHUNKS/TOTAL:
  129.  
  130.     When Display Memory Chunks is selected, the program will display the
  131.     number of free memory chunks in the system.  This gives you an idea
  132.     of how fragmented memory is.  This number appears instead of the
  133.     memory total.
  134.  
  135.  
  136. *    DISPLAY DISK SIZE/USAGE:
  137.  
  138.     This toggles the second column of numbers between actual disk size
  139.     in kilobytes, or how full is the disk (in percentage terms.)
  140.  
  141.  
  142.     QUIT:
  143.  
  144.     Guess what this does?!
  145.  
  146.  
  147.  
  148.  
  149.     Note:  This program takes very little processor time.  For example,
  150. with three disks displayed, the program will only consume about 1/2 % of
  151. processing time at the most (at an update rate of 5 seconds.)  Its memory
  152.  usage is around 11-15k.
  153.  
  154.  
  155.     Any comments, suggestions, complaints, etc. should be sent to me on
  156. Compuserve ID number 75166,2531.
  157.  
  158.  
  159.     This program is placed in the Public Domain, you can spread it as 
  160. much as you like as long as you keep this file with it.
  161.  
  162.  
  163.  
  164.     I hope you find this program as useful as I do.
  165.  
  166.  
  167.                                     Khalid Aldoseri.
  168.                                     CIS: 75166,2531.
  169.                                     
  170.  
  171.  
  172. *    Marks items new in Version 4.00.
  173.  
  174.  
  175.  
  176.  
  177. Version 4.00 Comments:
  178.  
  179.     -    Fixed problem with PAR: or SER: appearing on display.
  180.     
  181.     -    Added the following features:
  182.  
  183.         -    Disk Full Percentage display.
  184.         -    Memory chunks (fragmentation) display.
  185.         -    'Disk Protected' display.
  186.         -    Variable update (refresh) time.
  187.  
  188.  
  189.     -    The time/date display will only be updated as often as the update
  190.         time you selected.
  191.  
  192.     -    Be careful when selecting an update rate of 1 second.  This can
  193.         take too much time from the processor.  2 seconds is okay, but I
  194.         find the optimal to be between 10 and 15 seconds if you are not
  195.         using drives a lot, and between 3 and 5 if you are.  When 
  196.  
  197.     -    The program's window will always come up as inactive.  It will
  198.         also turn itself into inactive after a fixed period.  (around
  199.         10 to 60 seconds, depending on the update rate.)
  200.  
  201.     -    The program now knows about WBLace V3.00 or higher (by the same
  202.         author), and will close its window for about 2 seconds when
  203.         WBLace requests this from it.  This is in order to allow WBLace
  204.         to change the Workbench Interlace setting on or off.  If you don't
  205.         have WBLace, you can find in the AmigaForum on Compuserve in DL13
  206.         as WBLCE3.ARC.
  207.  
  208.  
  209.  
  210. Known Bugs:
  211.  
  212.     -    From time to time, the program seems to forget to update the
  213.         time/date display.  I am looking into this problem.
  214.  
  215.  
  216.  
  217. PLEASE:
  218.  
  219.     If you have any ideas on what can be added to this program, easyplex
  220. me with your ideas, as I am running out of them!
  221.