DISK ANALYSIS UTILITY
                         Release Level 12.0.0


This application consists of one runfile: DiskAnalysis.Run

Product Name   : Disk Analysis
Supported On   : B24, B26, B27, B28, B38, B39, XE5xx, and all SuperGen hardware
Supported OS   : BTOS II, CTOS I, CTOS II, CTOS III

Description    : Program that analyzes the disk occupation and gives the 
                 following information about the disk: 
                 
                 - a visual representation of the disk occupation (which 
                   includes a display of the disk parameters and a free sector 
                   summary report)
                 - an extents status report (detailed if requested)
                   
                 The visual representation of the disk occupation is 
                 interpreted as follows:                
                 
                 - the information is shown per 8 consecutive sectors
                 - if all 8 sectors are free the figure 8 is displayed in 
                   normal video (*)
                 - if all 8 sectors are in use a zero is displayed in reverse 
                   video (*)
                 - if per 8 sectors between 1 and 7 sectors are free then this 
                   figure is displayed in half bright reverse video.
                   
                 - Color can be suppressed by using case '01' in the /Disk 
                   Analysis command. This is necessary when executing /Disk 
                   Analysis thru Cluster View on a monochrome monitor.
                   
                 Layout of DAcolorConfig.sys:
                 
                 Offset       Length       Description

                 0            2            Version(Currently must be 1)
                 2            8            rgbAlphaPalette
                 10           8            rgbBackgroundPalette
                 18           10x3         Color video attributes
                 
                 Ten color video attributes can be defined.  Each exists of 3 
                 bytes (e.g. 0FF, 'B', 0C4h: use color 6 and reverse video). 
                 The first 9 attribute are used for 0 to 9 sectors free and 
                 the last one is used to reset the video attributes after 
                 displaying the map.  As not all of the video characters of 
                 the disk map can be printed the print out of the disk map 
                 will look different. These differences depend on the type 
                 of printer (capabilities of the printer) and a printer 
                 dependent Output Strings File (e.g. [sys]<sys>AP1351.Strng) 
                 is used to create a print table copy of the disk map. This 
                 file specifies to which characters and attributes the video 
                 characters and attributes are to be mapped.  

Directions/Use : The Disk Analysis utility may be executed by running the  
                 /Disk Analysis command using the following parameters which 
                 are outlined and explained below:
                 
                 Device or volume name
                 
                 This field is mandatory.  Enter the name of the device or 
                 volume whose disk occupation you want to analyze. 
                 
                 [Device or volume password]
                 
                 This field is optional.  Enter the password of the device or 
                 volume specified in the previous field.
                 
                 [Output File]
                 
                 This field is optional.  The output device may be any file 
                 name, any spooler queue, any GPS device, [LPT], [PTR]A or 
                 [PTR]B.
                 
                 [Output device type]
                 
                 Specifies the type of device used for the output file. This 
                 specification is used to create a printable copy of the 
                 visual representation of the disk occupation.  Four device 
                 types can be specified:
                 
                 AP1305
                 AP1351 
                 AP92Laser 
                 Video 
                 
                 Device type AP1305 can be used for all Diablo630 and 
                 QumeSprint9 printers, and device type 9208 is valid for the 
                 AP9208 and AP9215 laser printers.  Device type Video can be 
                 used if you want to store the information in a file which is 
                 to be displayed again (do not print this file). When you 
                 display the output file you will get exactly the same display 
                 as during the execution of the /DISK ANALYSIS command 
                 (specify 0 for Line length).  The default is is draft which 
                 generates a copy of the visual representation of the disk 
                 occupation that can be printed by any printer.
                 
                 [Line Length]
                 
                 Specifies the number of characters per line to be used for 
                 the diskmap on the output file. If you specify 0 then no 
                 Linefeeds will be inserted in the disk map.  The default is 
                 80 characters per line.
                 
                 [Suppress diskmap?]
                 
                 This field is optional.  Enter 'Y' to suppress the visual 
                 representation of the disk occupation.  
                 
                 [Number of extents]
                 
                 This field is optional.  Enter a value to display the names 
                 of the files and their number of extents for the files having 
                 at least this number of extents.  The default is not to 
                 display this information.
                 
                 [Details?]
                 
                 This field is optional.  Enter 'Y' to display the disk 
                 address and the run length of the extents of the files having 
                 at least the number of extents specified in the previous
                 field.


COMMAND
          
/Disk Analysis
  [ Device or volume name ]
  [ Device or volume password ]
  [ Output file ]
  [ Output device type]
  [ Line length ]
  [ Suppress diskmap? ]
  [ Number of extents ]
  [ Details? ]


$MEDIUM OPTIMIZE(2)

/*****************************  PROGRAM HEADER  ******************************
******************************************************************************
**                                                                          **
**      MACHINE:       B21/B22/B25/B27/B28/B38/XE520/XE530                  **
**      LANGUAGE:      Plm                                                  **
**      OS:            BTOS & BTOS II                                       **
**                                                                          **
**      MODULE:        Diskmap.plm                                          **
**      LEVEL:         12.0.0                                               **
**      CREATED:       Kris Van Bogaert                                     **
**                     RCC UNISYS BELGIUM                                   **
**                     Seneffe, May 27, 1987                                **
**                                                                          **
**      DESCRIPTION:   Program that analyses the disk occupation and gives  **
**                     the following information about the disk:            **
**                                                                          **
**                       - a visual representation of the disk occupation   **
**                         (which includes a display of the disk parameters **
**                         and a free sector summary report);               **
**                                                                          **
**                       - an extents status report (detailed if requested);**
**                                                                          **
**   {not supported in   - a fully detailed diskmap (the use of all the     **
**    this release }       sectors on disk).                                **
**                                                                          **
**                                                                          **
**                     The visual representation of the disk occupation     **
**                     is interpreted as follows:                           **
**                                                                          **
**                       - the information is shown per 8 consecutive       **
**                         sectors;                                         **
**                                                                          **
**                       - if all 8 sectors are free the figure 8 is        **
**                         displayed in normal video (*);                   **
**                                                                          **
**                       - if all 8 sectors are in use a zero is displayed  **
**                         in reverse video (*);                            **
**                                                                          **
**                       - if per 8 sectors between 1 and 7 sectors are     **
**                         free then this figure is displayed in half       **
**                         bright reverse video (*).                        **
**                                                                          **
**                                                                          **
**                     (*)  On a color monitor the diskmap is now displayed **
**                          in color.  As these colors are configurable     **
**                          thru the file DAcolorConfig.sys, the meaning    **
**                          of the different colors is displayed before     **
**                          displaying the diskmap.                         **
**                                                                          **
**                          Color can be suppressed by using case '01' in   **
**                          the Disk Analysis command. This is necessary    **
**                          when executing Disk Analysis thru Cluster View  **
**                          on a monochrome monitor.                        **
**                                                                          **
**                                                                          **
**                     Layout of DAcolorConfig.sys:                         **
**                                                                          **
**                        Offset   Length   Description                     **
**                                                                          **
**                          0        2      Version   (Currently must be 1) **
**                          2        8      rgbAlphaPalette                 **
**                         10        8      rgbBackgroundPalette            **
**                         18       10x3    Color video attributes          **
**                                                                          **
**                                                                          **
**                        Ten color video attributes can be defined.  Each  **
**                        exists of 3 bytes (e.g. 0FF, 'B', 0C4h: use color **
**                        6 and reverse video).  The first 9 attribute are  **
**                        used for 0 to 9 sectors free and the last one     **
**                        is used to reset the video attributes after       **
**                        displaying the map.                               **
**                                                                          **
**                                                                          **
**                     As not all of the video characters of the disk map   **
**                     can be printed the print out of the disk map will    **
**                     look different. These differences depend on the type **
**                     of printer (capabilities of the printer) and a       **
**                     printer dependent Output Strings File (e.g.          **
**                     [sys]<sys>AP1351.Strng) is used to create a printable**
**                     copy of the disk map. This file specifies to which   **
**                     characters and attributes the video characters and   **
**                     attributes are to be mapped.                         **
**                                                                          **
**                                                                          **
**                                                                          **
**                     Command Form:                                        **
**                                                                          **
**                   ____________________________________________________   **
**                  !                                                    !  **
**                  !  Disk Analysis                                     !  **
**                  !                                                    !  **
**                  !    [ Device or volume name ]       _____________   !  **
**                  !    [ Device or volume password ]   _____________   !  **
**                  !    [ Output file ]                 _____________   !  **
**                  !    [ Output device type]           _____________   !  **
**                  !    [ Line length ]                 _____________   !  **
**                  !    [ Suppres diskmap? ]            _____________   !  **
**                  !    [ Number of extents ]           _____________   !  **
**                  !    [ Details? ]                    _____________   !  **
**{not supported in !<---[ Fully detailed diskmap? ] _________________   !  **
** this release}    !                                                    !  **
**                  !____________________________________________________!  **
**                                                                          **
**                                                                          **
**                                                                          **
**                     Fields:                                              **
**                     ------                                               **
**                                                                          **
**                     Device or volume name :                              **
**                     - - - - - - - - - - -                                **
**                     Enter the name of the device or volume whose disk    **
**                     occupation you want to analyze.                      **
**                                                                          **
**                                                                          **
**                     [Device or volume password] :                        **
**                     - - - - - - - - - - - - - -                          **
**                     The password of the device or volume specified in    **
**                     the previous field.                                  **
**                                                                          **
**                                                                          **
**                     [Output File] :                                      **
**                     - - - - - - -                                        **
**                     * any file name                                      **
**                     * any spooler queue                                  **
**                     * any GPS device                                     **
**                     * [LPT]                                              **
**                     * [PTR]A or [PTR]B                                   **
**                                                                          **
**                                                                          **
**                     [Output device type] :                               **
**                     - - - - - - - - - -                                  **
**                     Specifies the type of device used for the output     **
**                     file. This specification is used to create a         **
**                     printable copy of the visual representation of the   **
**                     disk occupation.                                     **
**                                                                          **
**                     Four device types can be specified:                  **
**                                                                          **
**                       * AP1305                                           **
**                       * AP1351                                           **
**                       * AP92Laser                                        **
**                       * Video                                            **
**                                                                          **
**                     Device type AP1305 can be used for all Diablo630     **
**                     and QumeSprint9 printers, and device type 9208 is    **
**                     valid for the AP9208 and AP9215 laser printers.      **
**                                                                          **
**                                                                          **
**                     Device type Video can be used if you want to         **
**                     store the information in a file which is to be       **
**                     displayed again (do not print this file). When you   **
**                     display the output file you will get exactly the     **
**                     same display as during the execution of the          **
**                     DISK ANALYSIS command (specify 0 for Line length).   **
**                                                                          **
**                     Default is draft which generates a copy of the visual**
**                     representation of the disk occupation that can be    **
**                     printed by any printer.                              **
**                                                                          **
**                                                                          **
**                     [Line Length] :                                      **
**                     - - - - - - -                                        **
**                     Specifies the number of characters per line to be    **
**                     used for the diskmap on the output file. If you      **
**                     specify 0 then no Linefeeds will be inserted in the  **
**                     disk map.                                            **
**                                                                          **
**                     Default is 80 characters per line.                   **
**                                                                          **
**                                                                          **
**                     [Suppress diskmap?] :                                **
**                     - - - - - - - - - -                                  **
**                     Enter 'Y' to suppress the visual representation of   **
**                     the disk occupation.                                 **
**                                                                          **
**                                                                          **
**                     [Number of extents] :                                **
**                     - - - - - - - - - -                                  **
**                     Enter a value to display the names of the files      **
**                     and their number of extents for the files having at  **
**                     least this number of extents.                        **
**                                                                          **
**                     Default is not to display this information.          **
**                                                                          **
**                                                                          **
**                     [Details?] :                                         **
**                     - - - - -                                            **
**                     Enter 'Y' to display the disk address and the run    **
**                     length of the extents of the files having at least   **
**                     the number of extents specified in the previous      **
**                     field.                                               **
**                                                                          **
**                                                                          **
**      MODIFIED:      Level II-1.00.00   May 25, 1988   Kris Van Bogaert   **
**                                                                          **
**                       - clean up                                         **
**                       - add comments                                     **
**                       - protected mode compatible                        **
**                                                                          **
**                                                                          **
**                     Level II-1.1.0    Oct. 31, 1988   Kris Van Bogaert   **
**                                                                          **
**                       - Use <edf> files for procedure declarations.      **
**                       - Rename quad variable to Quadd.                   **
**                       - Use SetImageMode for printer log file to prevent **
**                         that carriage returns are added by the OS.       **
**                       - Add a carriage return (0Dh) after a linefeed     **
**                         (necessary because of SetImageMode).             **
**                       - Output also an initial attribute string to the   **
**                         output file before outputting the bitmap.        **
**                       - First close the logfile before terminating the   **
**                         program when an error is encountered.            **
**                       - Add consistency check for the output strings     **
**                         file.                                            **
**                       - Do not output a formfeed to the output file if   **
**                         the extents status report is not being displayed.**
**                       - Take altFileHeaderPageOffset into account when   **
**                         calculating the number of files on the volume.   **
**                       - Parameter 4 of the command form is now 'Output   **
**                         device type' instead of ' Output Strings file'   **
**                         unless the Case parameter is '01'.  This device  **
**                         type is converted to an Output Strings File name.**
**                       - Include Copy Protection feature if the           **
**                         'CopyProtect' switch is set. A 'C' appended to   **
**                         the version string (e.g. II-1.1.0C) indicates    **
**                         that the run file is copy protected (that the    **
**                         switch was set when compiling).                  **
**                                                                          **
**                                                                          **
**                     Level II-1.1.1    Nov. 09, 1988   Kris Van Bogaert   **
**                                                                          **
**                       - Correct Lfa calculation of extension file        **
**                         headers (GetDiskExtentsPass1 and                 **
**                         GetDiskExtentsPass2).                            **
**                                                                          **
**                                                                          **
**                                                                          **
**                     Level II-1.1.2    Nov. 26, 1988   Kris Van Bogaert   **
**                                                                          **
**                       - Bind with Min. Array and Max. array = 1.         **
**                                                                          **
**                                                                          **
**                     Level II-1.1.3    March 28, 1989  Kris Van Bogaert   **
**                                                                          **
**                       - Correct the calculation of sBitMap for large     **
**                         disks (use "DOUBLE(AllocPageCnt)" in formula).   **
**                                                                          **
**                       - Output the run length also in sectors.           **
**                                                                          **
**                       - Declare Is_Access_Valid only if the CopyProtect  **
**                         switch is set.                                   **
**                                                                          **
**                                                                          **
**                     Level II-1.1.4   Aug. 03, 1989    Kris Van Bogaert   **
**                                                                          **
**                       - Support demo validation (Bind with enhanced      **
**                         external procedure 'Is_Access_Valid').           **
**                                                                          **
**                       - Changed AP92Laser.Strng to use pitch 12 with     **
**                         font 7 (Letter Gothic 15). This solves the       **
**                         problem that the diskmap is printed with a       **
**                         mixture of pitch 12 and 15 when the Current CPI  **
**                         mode on the indicator panel of the printer is set**
**                         to 'Depends on font'.                            **
**                                                                          **
**                       - Output a formfeed to the output file before      **
**                         closing it.                                      **
**                                                                          **
**                                                                          **
**                     Level II-1.1.5  Sept. 04, 1989    Kris Van Bogaert   **
**                                                                          **
**                       - Display 'Longest Continuous Number of Free       **
**                         Sectors'  as a DWORD instead of a WORD.          **
**                                                                          **
**                                                                          **
**                     Level 12.0.0    Sept. 27, 1990    Kris Van Bogaert   **
**                                                                          **
**                       - Support CTOS/XE 3.0 initialized disks.           **
**                                                                          **
**                       - Color Support.                                   **
**                                                                          **
**                       - Don't call SetImageMode for the log file unless  **
**                         a device type has been specified (is needed for  **
**                         postscript printers).                            **
**                                                                          **
**                                                                          **
****************************  END OF PROGRAM HEADER  *************************
*****************************************************************************/