DISK UTILITIES


This application consists of one runfile: [Sys]<Sys>DiskUtilities.Run

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

Description    : Disk Utilities consists of a series of executive commands which utilize the Standard Software utility DiskUtilities.Run

Directions/Use : The Disk Utilities commands: /Print DCB, /Print VHB, FHDR 
                 Utility, and /List Open Files are undocumented features of 
                 the Standard Software utility DiskUtilities.Run.  To execute 
                 each utility run the appropriate command with the paramters 
                 and command cases described and detailed below:
                 
                 Print DCB - This subprogram displays the Device Control Block 
                             from the file system.  Execute /Print DCB command 
                             with case 06.
                             
                              Device Spec
                              
                              This field is mandatory.    Enter a device name 
                              (d0, d1, etc.)
                              
                              [output file]
                              
                              This field is optional.  The default is [Vid].  
                              Enter a file or device in which to write the 
                              output.

              
                  List Open Files - This subprogram displays files that are 
                                    open in the file system.  Execute the 
                                    /List Open Files command using case 07.
                  
                    [Device Spec]
                    
                    This field is optional.  Enter a device (!Sys, Sys), for 
                    which a file system exists.  The default is Sys.
                    
                    [Print file]
                    
                    This field is optional.  The default if [Vid].  Enter a 
                    file or device name to write the output.
                    
                    [Display user info?]
                    
                    This field is optional.  The default is 'No'.  Enter 'Yes' 
                    to display user name along with the other file information.

Meaning of output:

iUfb FH   UN   Md  UC Pr St D# T FhStatus  FileName                      
---- ---- ---- -- --- -- -- -- - --------  ------------------------------
   |    |    |  |   |  |  |  | |        |  |                             
   |    |    |  |   |  |  |  | |        |  The file name.                
   |    |    |  |   |  |  |  | |        |                                
   |    |    |  |   |  |  |  | |        w = Write Enable                 
   |    |    |  |   |  |  |  | |        @ = At Sign File                 
   |    |    |  |   |  |  |  | |        r = Read Only                    
   |    |    |  |   |  |  |  | |        f = Free on Close                
   |    |    |  |   |  |  |  | |        d = No Access Date/Time          
   |    |    |  |   |  |  |  | |        m = Modified                     
   |    |    |  |   |  |  |  | |        a = Accessed                     
   |    |    |  |   |  |  |  | |                                         
   |    |    |  |   |  |  |  | The object type: 1=node, 2=device         
   |    |    |  |   |  |  |  |                  3=top level directory    
   |    |    |  |   |  |  |  |                  4=directory, 5=file      
   |    |    |  |   |  |  |  |                                           
   |    |    |  |   |  |  |  Device number, 1st is 0.                    
   |    |    |  |   |  |  Status: SL=short lived,                        
   |    |    |  |   |  |          LL=long lived, F=free                  
   |    |    |  |   |  Protection level                                  
   |    |    |  |   User count                                           
   |    |    |  Open mode: read, modify, peek or zombie                  
   |    |    User number                                                 
   |    File Handle                                                      
   Ufb index
                     
                  Print VHB - This subprogram displays Volume Home Block 
                              Information.  Execute the /Print VHB command 
                              using case Case 08
                              
                              [Device Spec]
                              
                              This field is optional.  The default is the 
                              current volume.  Enter the device name whose VHB 
                              is to be displayed.
                              
                              [output file]
                              
                              This field is optional.  The default is [Vid].  
                              Enter a file or device name in which to write 
                              the output.

                  
                  FHDR Utility - This subprogram displays file header 
                                 information.  This utility can also be used 
                                 to correct a bogus primary fileheader by 
                                 setting to yes parameter #4.  Be very careful 
                                 in using the copy alternate feature.  It has 
                                 been used to repair disks corrupted by XEBTOS 
                                 7.0.  Execute the /FHDR Utility command using 
                                 case 09.
                                 
                                 [File list]
                                   
                                 This field is optional.  The default is all 
                                 files.  Enter the file names to be displayed.
                                   
                                 [output file]
                                   
                                 This field is optional.  The default is 
                                 [Vid].  Enter a file or device name in which 
                                 to write the output.
                                   
                                 [Display alternate FHB?]
                                 
                                 This field is optional.  Enter 'Yes' to 
                                 display the alternate File Header Block.
                                 This is useful in determining if the primary 
                                 FHB has been damaged.  The   default is 
                                 'No'.  
                                                                            
                                 [Copy alternate FHB?]
                                 
                                 This field is optional.  Enter 'Yes' and the 
                                 alternate FHB will be copied over the primary 
                                 FHB.  Used when the primary FHB has been 
                                 damaged.  The default is 'No'.  
                                   
                                 [Suppress contents list?]
                                 
                                 This field is optional.  The default is 'No'.
                                 Enter 'Yes' to prevent the results from being 
                                 displayed or written.  This would be used 
                                 when copying the alternate fileheader.

                   
COMMANDS

/Print DCB
 [Device Spec]
 [output file]
	
/List Open Files
  [DevSpec]
  [Print file]
  [Display user info?]

/Print VHB
  [Device Spec]
  [output file]

/FHDR Utility
  [File list]
  [output file]
  [Display alternate FHB?]
  [Copy alternate FHB?]
  [Suppress contents list?]