home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 223.lha / DiskStorageDeluxe_v1.20 / dsd.doc < prev    next >
Text File  |  1989-04-04  |  13KB  |  400 lines
  1.             Disk Storage Deluxe 1.10   By: Khalid Aldoseri.
  2.             -----------------------------------------------
  3.  
  4.  
  5.  
  6. INTRODUCTION:
  7. -------------
  8.  
  9.     This is a small program that will run from either the WB or CLI. It will
  10. open its own window and display a list of ALL currently mounted devices,
  11. including hard disk partitions.  
  12.  
  13.  
  14.     The window displays the following info:
  15.  
  16.  
  17. -   Name:
  18.     This is the AmigaDOS name for the device.  E.G. DF0: DH0: VD0: etc.
  19.  
  20. -   Usage:
  21.     Shows a percentage of how full the device is.
  22.  
  23. -   Free:
  24.     Shows the amount of free storage left in a device.  (in KiloBytes)
  25.  
  26. -   Size:
  27.     Shows the total amount of storage a device has.  (also in K)
  28.  
  29. -   Volume:
  30.     This is the device volume.  E.G.  Workbench: Boot: etc.
  31.  
  32. -   Alarm:
  33.     This is the alarm level for the relevant device. (in K)  This will
  34.     be explained later.
  35.  
  36. -   Chip:
  37.     The amount of free Chip memory in the system.
  38.  
  39. -   Fast:
  40.     The amount of free Fast memory.
  41.  
  42. -   Total:
  43.     The total amount of free memory.
  44.  
  45. -   Chunks:
  46.     The number of free memory chunks available.  This gives you an idea of
  47.     how fragmented the computer's free memory list is.
  48.  
  49. -   RAM Disk Size:
  50.     This is the size of the RAM: disk device in kilobytes.
  51.  
  52.  
  53.  
  54. STORAGE ALARM:
  55. --------------
  56.  
  57.     Disk Storage Deluxe's (DSD) main function is to keep track of how much
  58. free storage is remaining in every device.  If the free storage in any device
  59. is less than 5% of its total size, that device will be highlighed.  Also, if
  60. the storage drops below 5% while DSD is running, DSD will inform you of the
  61. fact by a 'Storage Alarm.'  This can be any of the following types:
  62.  
  63. 1.  Flash:
  64.     This will flash all the screens in the system five times, while
  65.     also flashing the relevant item in its window.
  66.  
  67. 2.  Requester:
  68.     This will put up a 'requester' informing you of the alarm.
  69.     Click into the requester to continue.  The requester will pop
  70.     up on ANY screen.
  71.  
  72. 3.  Beep:
  73.     This will beep three times.
  74.  
  75. 4.  Speech:
  76.     The program will speak to you informing you of the alarm.
  77.     (If the translator.library is not in the LIBS: directory, this option
  78.     will not work.)
  79.  
  80. 5.  No Alarm:
  81.     DSD will just ignore the alarm.
  82.  
  83.  
  84.  
  85. ALARM LEVEL:
  86. -----------
  87.  
  88.     The Alarm level normally is 5% of the total capacity of the device
  89. with a minimum alarm level of 50k.  You can change the Alarm level by
  90. clicking on the device row you want to change.  A gadget will appear at
  91. the bottom of the window.  Enter the new Alarm level and hit return.
  92. If you want to turn the alarm off for a specific device, enter a 0 as
  93. the alarm level.  Or, if you enter a negative value, a percent of storage
  94. space will be used, e.g. if you enter a -25, the alarm level will be
  95. 25% of its total storage space.
  96.  
  97.  
  98. UPDATE RATE:
  99. ------------
  100.  
  101.     DSD updates it display once every 3 seconds.  This can be changed to
  102. anything between 1 second and 15 minutes.  To do this, click on the 'update
  103. speed' gadget (it's a tiny block normally in the upper right hand corner
  104. of the window, next to the title line.)  To change the update rate, click
  105. on this gadget and hold it down, the window's title will display the current
  106. update rate, move the mouse up or down to change the update rate.  Let go
  107. of the mouse button when you find a rate you like.
  108.  
  109.     If you need an immediate update of the display, activate DSD's window and
  110. then click on the mouse menu (right) button.   DSD will also update the
  111. display every time a disk is inserted or removed from the drive.
  112.  
  113.  
  114.  
  115. DSD'S WINDOW:
  116. -------------
  117.  
  118.     The window is mostly fairly clear except for the following:
  119.  
  120. -   If a floppy disk has the write-protect tab on, an asterisk (*) will
  121.     appear next to the 'Free' number corresponding to that disk.
  122.  
  123. -   Also, if AmigaDOS is currently validating a disk, a 'V' will appear
  124.     next to the 'Free' number corresponding to that disk.  If this happens,
  125.     the info for that disk might not be correct.  Be careful.  Anyway, you
  126.     should not write to a disk as long as it is validating.
  127.  
  128. -   DSD's window will be as tall as it needs to be to display all the
  129.     mounted devices.  The limit for that is 20 devices.
  130.  
  131. -   The RAM Disk Size display applies to the normal RAM Disk and not VD0:
  132.     or RAD: as those would appear with the normal disk list.  If the RAM
  133.     Disk has not been accessed yet, DSD will start it up and display
  134.     'RAM Disk Empty'.  If DSD can't start up the RAM Disk for any reason,
  135.     it will display 'RAM Disk Not Initialized.' 
  136.  
  137.  
  138.  
  139. DEVICE SELECTION AND REMOVAL:
  140. -----------------------------
  141.  
  142.     You can remove devices from the display if you do not need them.  This
  143. is accomplished by 'selecting' a device from the list.  (To select a device
  144. click on its line TWICE.)  Then select 'Remove Selected' from the menu.
  145. (More on this later.)  When a device is removed, it will no longer be
  146. checked for its alarm level.  There are many 'Remove' options.  These will
  147. be discussed in the Menus section.
  148.  
  149.  
  150.  
  151. MENUS:
  152. ------
  153.  
  154.     DSD has the following menus attached to it:
  155.  
  156.  
  157. -   Options Menu:
  158.     -------------
  159.  
  160.     -   Reset All:
  161.         Resets the device list.
  162.  
  163.     -   Clear Selections:
  164.         Clears all 'selected' disks.
  165.  
  166.     -   Memory Display:
  167.         Turns the memory display box on/off.
  168.  
  169.     -   Time Display:
  170.         DSD displays the time and date on its window title.  This menu item
  171.         will turn this off or on.
  172.  
  173.     -   RAM Disk Display:
  174.         Turns the RAM Disk size box on/off.
  175.  
  176.     -   Go To Sleep:
  177.         Selecting this item will put the program to sleep.  It wil close its
  178.         window and open up a tiny window instead.  The program will be frozen
  179.         during that time.  To return to normal just click into the tiny
  180.         window and the original window will be back.
  181.  
  182.     -   Pop up to front:
  183.         When this option is selected, DSD's window will always 'pop up' on
  184.         whatever screen is on front.  (Note:  If the front screen is not big
  185.         enough to display DSD's window, DSD will come up on the screen behind
  186.         it and will automatically turn Popup off.)
  187.  
  188.     -   Quit:
  189.         Guess what this does!  :-)
  190.  
  191.  
  192. -   Remove Menu:
  193.     ------------
  194.  
  195.     This menu has all the different 'Remove' options.  They are:
  196.  
  197.     -   Selected:
  198.         This will remove just the 'selected' disks.  You can have more than
  199.         one selected disk at the same time.
  200.  
  201.     -   Unselected:
  202.         This will remove all the disks except the selected ones.  Useful when
  203.         you only want to see one or two devices.
  204.  
  205.     -   Floppies:
  206.         Removes all devices beginning with 'DF'.
  207.  
  208.     -   Not Floppies:
  209.         Removes all devices not beginning with 'DF'.
  210.  
  211.     -   < Alarm Level:
  212.         Removes all devices that are below the Alarm Level.
  213.  
  214.     -   > Alarm Level:
  215.         Removes all devices that are above the Alarm Level.
  216.  
  217.     -   Empty Drives:
  218.         Removes all drives that have no disk in them.
  219.  
  220.     -   Everything:
  221.         Removes ALL the devices from the list.
  222.  
  223.  
  224. -   Alarm Menu:
  225.     -----------
  226.  
  227.     This menu allows you to select the Alarm Type.
  228.  
  229.  
  230. -   Save Menu:
  231.     ----------
  232.  
  233.     -   Save Config:
  234.         When selecting this, DSD will save the following settings to a file
  235.         called 'S:DSD-Config':
  236.             -   Memory Display (on/off)
  237.             -   RAM Display (on/off)
  238.             -   Time Display (on/off)
  239.             -   Used/Size Display
  240.             -   Memory Chunk/Total Display
  241.             -   Alarm Type
  242.             -   Volume Name Display (on/off)
  243.             -   Shrink (on/off)
  244.             -   Popup (on/off)
  245.             -   Update Speed
  246.             -   DSD's Window position.  (X & Y coords)
  247.             -   Sleep Window position.  (X & Y coords)
  248.  
  249.         When DSD is first loaded, it will look for this file and change
  250.         its settings to what was saved.
  251.  
  252.     -   Save Devices:
  253.         When selecting the 'Save Devices' option, DSD will save the current
  254.         device list and the alarm level selected for each device into a file
  255.         called 'S:DSD-Devices'.  Everytime DSD is run, it will read this
  256.         file and will set the device list and alarm levels to what they
  257.         were when the list was saved.
  258.  
  259.  
  260. -   Screens Menu:
  261.     -------------
  262.  
  263.     This menu has a list of the currently available 'screens' in the system,
  264.     with the screen on which DSD's window is currently living marked with a
  265.     checkmark.  (Max screens listed are 10.)
  266.  
  267.     To move DSD's window to any other screen, just select its name from the
  268.     menu.
  269.  
  270.     The menu will also tell you what kind of screen you are moving to.
  271.     (Either Normal, Workbench, or Simple Screen.)  Be careful when moving to
  272.     a Simple (i.e. SIMPLE_REFRESH) screen.  Some Simple screens may lose
  273.     the contents under DSD's window.  (e.g. Paint Programs)
  274.  
  275.  
  276. GADGETS:
  277. --------
  278.  
  279.     DSD has many hidden gadgets that control the display options.  The file
  280. 'DSD.PIC' shows exactly where each gadget is.  (Use any IFF display program
  281. to see it.)  To select a gadget, just click on where it should be.
  282.  
  283.     -   Size/Used Gadget:
  284.         (Position: First Line, Second Column)
  285.  
  286.         This will toggle the display between % used and actual device size
  287.         in k.
  288.  
  289.     -   Volume/Free+Alarm Gadget:
  290.         (Position: First Line, 3rd & 4th Columns)
  291.  
  292.         This will toggle the display between either Free and Alarm levels or
  293.         the device's Volume name.
  294.  
  295.     -   Memory Total/Chunks Gadget:
  296.         (Position: Memory Box, last column)
  297.  
  298.     -   Color Select Gadget:
  299.         (Position: Memory Box, 1st & 2nd Columns)
  300.  
  301.         This will rotate the colors of DSD's window.
  302.  
  303.     -   Shrink/Expand Window:
  304.         (Close Gadget)
  305.  
  306.         This will shrink DSD's window to just the title bar.  This will NOT
  307.         affect any other operation of the program.  I.E. alarms will still
  308.         work, unlike the 'Sleep' mode.  If you want to quit the program,
  309.         select the 'Quit' menu item as the close gadget will only
  310.         shrink/expand the window.
  311.  
  312.  
  313.  
  314.  
  315. COMMENTS:
  316. ---------
  317.  
  318.     -   The time/date display will only be updated as often as the update
  319.         time you selected.
  320.  
  321.     -   Be careful when selecting an update rate of 1 second.  This can
  322.         take too much time from the processor.  2 seconds is okay, but I
  323.         find the optimal to be between 10 and 15 seconds if you are not
  324.         using drives a lot, and between 3 and 5 if you are.
  325.  
  326.     -   DSD's window will always come up as inactive.  It will
  327.         also turn itself into inactive after a fixed period.  (around
  328.         10 to 60 seconds, depending on the update rate.)
  329.  
  330.     -   DSD knows about WBLace V3.00 or higher (by the same
  331.         author), and will close its own window for about 2 seconds when
  332.         WBLace requests this from it.  This is in order to allow WBLace
  333.         to change the Workbench Interlace setting on or off.  If you don't
  334.         have WBLace, you can find it in the AmigaForum on Compuserve in DL13
  335.         as WBLCE3.ARC.
  336.  
  337.     -   DSD takes little processor time.  For example, with three disks
  338.         displayed, DSD will only consume about 1% of processing time (at an
  339.         update rate of 5 seconds.)  Its memory usage is around 20k.  But
  340.         be careful if you have more than 10 disks on the list.  It can get
  341.         very busy.
  342.  
  343.  
  344.  
  345. KNOWN BUGS:
  346. -----------
  347.  
  348.     -   If any program takes complete control of a drive, (e.g. DiskCopy,
  349.         Format, DiskDoctor, DiskSalv) DSD will not be able to
  350.         check that drive, and it will display '- No Disk Present -'
  351.         I can't currently find a way around this.  (Maybe I shouldn't
  352.         mess with the drive when it's busy anyway.)
  353.  
  354.     -   If any program closes its screen while DSD is living on that screen,
  355.         DSD will pop back up to the current screen, BUT you will lose 704
  356.         bytes of memory.  If you want to close a program's screen while DSD
  357.         is still on it, first move DSD to another screen.
  358.  
  359.     -   DSD runs at a priority of 0.  So, if there is a lot of activity in
  360.         the system, the update rate will not be correct.  I.E.  An update
  361.         rate of 3 seconds will means that DSD will update its display NOT
  362.         LESS THAN every 3 seconds.  It might take upto 5 or 6 seconds to
  363.         update its display.
  364.  
  365.     -   DSD currently uses Forbid() and Permit() a lot, this means that at
  366.         times, the mouse pointer will freeze for a split-second while it
  367.         is moving.  Sorry about this, but it's better than getting a guru!
  368.  
  369.  
  370. PLEASE! PLEASE!
  371.  
  372.  
  373.     If you have any ideas on what can be added to this program, easyplex
  374. me with your ideas, as I have run out of them!
  375.  
  376.  
  377.     Many thanks to the folks on the AmigaTech forum, especially Keith Young
  378. for their help with this.
  379.  
  380.  
  381.     Any comments, suggestions, complaints, etc. should be sent to me on
  382. Compuserve ID: 75166,2531.
  383.  
  384.  
  385.     This program is Freely Distributable, you can spread it as much as you
  386. like as long as you keep the files with it, and don't modify any of them.
  387. Please upload it to other networks, BBS's etc.
  388.  
  389.  
  390.     I hope you find this program as useful as I do.
  391.  
  392.  
  393.     By: Khalid Aldoseri.
  394.         CIS: 75166,2531.
  395.                   _
  396.           | /    | |
  397.           |/     |_|
  398.           |\     | |
  399.           | \ o  | | o
  400.