home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 April / PCO_04_97.ISO / filesbbs / os2 / hdspace.arj / HDSPACE.ZIP / hdspace.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1996-06-16  |  46.4 KB  |  343 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. HDSpace Disk Space Utility and Swapper Monitor ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. ΓòÉΓòÉΓòÉ 1.1. General Information ΓòÉΓòÉΓòÉ
  6.  
  7. HDSpace is Freeware. You may distribute it as you please. 
  8.  
  9. If you have suggestions or bug-reports you can contact the author Brian J. 
  10. Dorling via EMail at the following addresses: 
  11.  
  12.      BDORLING @ NANDO.NET 
  13.  
  14.      BRIAN_DORLING @ VNET.IBM.COM 
  15.  
  16.      USIBAZE @ IBMMAIL 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 1.2. What does HDSpace do? ΓòÉΓòÉΓòÉ
  20.  
  21. HDSpace is a PM program with the following functions: 
  22.  
  23.      Shows total drive space and free drive space using PM slider controls 
  24.  
  25.      Shows drive type using icons on PM buttons 
  26.  
  27.      Provides a graphical "MAP" of the usage of each drive 
  28.  
  29.      Notebook control that gives drive geometry and other information about 
  30.       each drive 
  31.  
  32.      Show how much space could be saved by converting a FAT drive to HPFS or 
  33.       vice versa 
  34.  
  35.      Monitors the size of swapper.dat 
  36.  
  37.      Periodical refresh of the data displayed 
  38.  
  39.      Map of how total disk space is divided up into partitions 
  40.  
  41.      Mini monitor display 
  42.  
  43.      Fully customizable via PM notebook 
  44.  
  45.      Settings saved in OS/2 type INI file 
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 2. How to use HDSpace ΓòÉΓòÉΓòÉ
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ 2.1. Installing HDSpace ΓòÉΓòÉΓòÉ
  52.  
  53. HDSpace comes packed together with this .INF file. The HDSpace program consists 
  54. of a single executable HDSPACE.EXE. There are no DLLs. Unpack the ZIP file to 
  55. the directory of choice. 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2.2. Running HDSpace ΓòÉΓòÉΓòÉ
  59.  
  60. HDSpace does not accept any command line parameters. If the INI file 
  61. HDSpace.ini is found, then the settings from a previous session are loaded, 
  62. otherwise defaults are used. Just start HDSpace.exe to run the program. HDSpace 
  63. will try to position its window in the same place as when it was closed. 
  64.  
  65. If closed, HDSpace will write it's settings out to the INI file before the 
  66. program exits. In addition, a log file called HDSpace.log is written in the 
  67. directory that HDSpace is started from. This contains version information and 
  68. any errors that may occur. The file is deleted and written again each time 
  69. HDSpace is started. If you have any problems, select "DUMP DATA" from the 
  70. totals disk pulldown menu, this writes the internal data structures to the log 
  71. file, then send the author this file. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 2.3. Stopping HDSpace ΓòÉΓòÉΓòÉ
  75.  
  76. You can select "close" from the HDSpace main window system menu, or from the 
  77. OS/2 task list to stop HDSpace. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 2.4. General usage information ΓòÉΓòÉΓòÉ
  81.  
  82. HDSpace scans your system for physical and logical drives. Logical partitions 
  83. are displayed on the main screen. Each partition gets and Icon to depict what 
  84. type of partition or drive it is, diskette, disk, CD-ROM, Network etc. The icon 
  85. is placed on a button, selecting the right mouse button on this brings up a 
  86. pull-down menu with valid selections for this drive. 
  87.  
  88. For a logical drive, these are: 
  89.  
  90.      Details 
  91.  
  92.       This gets you to the details and settings notebook. 
  93.  
  94.      Hide 
  95.  
  96.       The drive is hidden from view. It is no longer scanned during refresh as 
  97.       long as it is hidden. To get the drive visible again, select it from the 
  98.       "Show Drives" menu. 
  99.  
  100.      Icon View 
  101.  
  102.      Tree View 
  103.  
  104.      Details View 
  105.  
  106.       These are the normal OS/2 container views of a drive. 
  107.  
  108.  For the totals drive, these are: 
  109.  
  110.      Details 
  111.  
  112.      Hide 
  113.  
  114.      Update Now 
  115.  
  116.       Does a complete scan through all drives and rebuilds the main display. 
  117.       Drives that were hidden stay hidden. 
  118.  
  119.      Dump Data 
  120.  
  121.       Dumps the internal data structures to HDSpace.log. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 2.5. Using the mouse. ΓòÉΓòÉΓòÉ
  125.  
  126. Most interaction with HDSpace is done with the mouse.The following section 
  127. explains how to control HDSpace with the mouse. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 2.5.1. Minimizing and Maximizing ΓòÉΓòÉΓòÉ
  131.  
  132. To minimize the display, click with the LMB on the normal OS/2 Minimize icon of 
  133. the frame window. From the minimized display, the only mouse action accepted is 
  134. the following double click, no others are accepted. 
  135.  
  136. To maximize, a double mouse click with the LMB on the mini display returns 
  137. HDSpace to the maximized state. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 2.5.2. Drive Menus ΓòÉΓòÉΓòÉ
  141.  
  142. To bring up a drive context menu, click RMB on the drive icon. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 2.5.3. Details Notebook ΓòÉΓòÉΓòÉ
  146.  
  147. The details notebook can be reached by double clicking LMB directly on the 
  148. drive slider, this goes directly to the MAP display page of the details 
  149. notebook. 
  150.  
  151. Or select Details from the drive context menu. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 2.5.4. Hide Frame Controls. ΓòÉΓòÉΓòÉ
  155.  
  156. Double clicking LMB on the container background (not on text, button or slider) 
  157. of the maximized display causes the window frame controls to be hidden. Double 
  158. clicking again reshows these controls. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 3. Details Notebook ΓòÉΓòÉΓòÉ
  162.  
  163. The details notebook is built dynamically and contains different pages 
  164. depending upon which drive was selected. 
  165.  
  166. For the totals drive: 
  167.  
  168.      Physical 
  169.  
  170.       Gives information on each physical disk. 
  171.  
  172.      Map 
  173.  
  174.       Graphical display of how the total hard disk capacity is divided among 
  175.       the partitions. 
  176.  
  177.      Options 
  178.  
  179.       This page allows the user to configure HDSpace. The interval between 
  180.       refreshes of the display can be set here. All settings made on this page 
  181.       are global. 
  182.  
  183.  For a logical partition: 
  184.  
  185.      Physical 
  186.  
  187.       Display information about the drive size, sector size, cluster size etc. 
  188.  
  189.      Logical 
  190.  
  191.       Displays the file system type, volume label and serial, drive type and 
  192.       drive location. If any other drive in the system maps to this partition 
  193.       (for example on a LAN), then the other drive letters that are in use for 
  194.       this partition are shown on this page. 
  195.  
  196.      HPFS 
  197.  
  198.       This page displays a comparison of how much space is wasted on the drive 
  199.       due to the sector size. If the drive is FAT, then its shows how much 
  200.       space would be saved by converting to HPFS. If it is HPFS, then it shows 
  201.       how much space is saved by using HPFS, and how much space FAT would use. 
  202.       The data is based on actual usage. 
  203.  
  204.      Details 
  205.  
  206.       Same as above. 
  207.  
  208.      Options 
  209.  
  210.       Same as above. 
  211.  
  212.      Map 
  213.  
  214.       Same as above. 
  215.  
  216.  For the swapper drive: 
  217.  
  218.      Swapper 
  219.  
  220.       Displays swapper size, starting size, and the place where OS/2 will warn 
  221.       the user that the partition is full. 
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 3.1. Map ΓòÉΓòÉΓòÉ
  225.  
  226. This page shows a graphical display of the space used by each sub-directory on 
  227. a drive. 
  228.  
  229. The above graphic shows an example MAP display. It shows the space used on 
  230. drive C:. The cursor was placed over the yellow block and the LMB was pressed, 
  231. the long text window at the bottom shows the details of the directory 
  232. represented by the yellow block. It's the directory C:\QW4, its size is 12.79 
  233. MB and it uses 13% of the total space on drive C:. 
  234.  
  235. The leftside directory, actually uses 11% of the space on the drive, about 5% 
  236. are in that directory (depicted by the red block) and another 5% are in a 
  237. subdirectory under that one (depicted by the pink block). 
  238.  
  239. To display the MAP, the SCAN function must be run to collect data about the 
  240. drive. The first time that this page is displayed, the scan function runs 
  241. automatically on a background thread. While it is running, information is 
  242. written to the text window at the bottom of this page. You can switch away from 
  243. this page while the scan is running. Once finished, the MAP display is built. 
  244. The data collected by scan is kept in internal data structures, this data is 
  245. not dynamically updated by a refresh. To refresh the data, click on the SCAN 
  246. button. Any time the MAP page is redisplayed, data from the previous scan is 
  247. used. This data is lost when HDSpace is stopped. 
  248.  
  249. Totals Drive 
  250.  
  251. The MAP display for the totals drive is different to the others. 
  252.  
  253. The above diagram shows an example of the totals map display page. The display 
  254. represents the total amount of local hard disk space in the system. Each 
  255. coloured block represents a logical partition and the size of that partition. 
  256.  
  257. Threshold value 
  258.  
  259. The threshold value that can be set on the options page, can be used to 
  260. customize this display. Setting it to its lowest value allows all directories 
  261. (that are large enough to display) to be shown, the larger the threshold value, 
  262. the larger a directory must be for it to be shown here. The diagram shown below 
  263. only display the top-level sub-directories, threshold has been set to a high 
  264. value, no others are large enough to be displayed. This value is a relative 
  265. value, the smallest value (3) is the smallest size which will allow a directory 
  266. to be visible, the actual size of this in bytes depends upon the size of the 
  267. drive. * 
  268.  
  269. Levels value 
  270.  
  271. The levels value of the options page, controls how many sub-directory levels 
  272. down the display should go. The above diagram shows three levels of 
  273. sub-directories, and the the threshold has been set to a lower value so that 
  274. sub-directories that use only a small amount of space are shown. 
  275.  
  276.  
  277. ΓòÉΓòÉΓòÉ 3.2. Options Page ΓòÉΓòÉΓòÉ
  278.  
  279. The options page allows the user to make global settings for HDSpace. Settings 
  280. made are active as soon as the notebook is saved. The settings are saved to the 
  281. INI file when HDSpace is closed. 
  282.  
  283. Available options are: 
  284.  
  285.      Directory Levels to Display 
  286.  
  287.      Directory Size Threshold 
  288.  
  289.      Display Refresh Rate 
  290.  
  291.      AutoHide 
  292.  
  293.       Autohide causes a drive that is not ready, to not be displayed. This is 
  294.       best used for diskette drives, or LAN drives. When the drive is detected 
  295.       as "not ready", then it is hidden, on each refresh, HDSpace checks the 
  296.       drive status. Once it is ready again, then it is redisplayed. 
  297.  
  298.       If Autohide is active, and drive A: is not ready, then it is not shown. 
  299.       Selecting drive A: in the "show drives" menu will not cause it to be 
  300.       displayed. 
  301.  
  302.      Autodetect 
  303.  
  304.       On each refresh cycle, HDSpace checks for new drive letters, if a new 
  305.       drive letter is found, then it is displayed. If a drive disappears, then 
  306.       it is removed. 
  307.  
  308.       If Autodetect is not selected, then new drives are not discovered, when a 
  309.       drive goes away, then it is just shown as not being ready. If Autohide is 
  310.       selected, then it would be hidden in this case. 
  311.  
  312.      Hide Duplicates 
  313.  
  314.       On Local area networks, it is sometimes common for more than one LAN 
  315.       drive letter to be mapped to the same physical drive on the LAN. 
  316.       Normally, HDSpace will just show all valid drive letters. With "Hide 
  317.       Duplicates" selected, then only the first drive letter is shown for a 
  318.       given physical disk. 
  319.  
  320.       For example: Drive letters, T, U and V all map to a single drive on the 
  321.       server. With hide duplicates active, then only drive T: is displayed. The 
  322.       logical details notebook page for drive T: has a field called "Other 
  323.       Drive Letters", in this case, that field displays U: and V: . 
  324.  
  325.      Float On Top 
  326.  
  327.       If selected, then on each refresh, the mini window of HDSpace is moved on 
  328.       top of all other windows. 
  329.  
  330.      Display Refresh 
  331.  
  332.       When a refresh occurs, and no changes have occured, the HDSpace display 
  333.       is not changed. The user has no way of seeing when a refresh occurs. When 
  334.       "Display Refresh" is selected, then the disk "light" on the totals button 
  335.       changes colour during the refresh cycle. 
  336.  
  337.      Display Swapper size 
  338.  
  339.       If selected, then a red bar is added to the disk slider where the 
  340.       swapper.dat is located. The size of this bar represents the size of the 
  341.       swapper. The size of the yellow and red bars added together, represents 
  342.       the total disk space used. The size is updated at every refresh. 
  343.