Availability:
     Level 7    , 'm'

  Quick Help:
     Display Single Track Directed Offline Scan Information, m[clr,min scn]

  Description:
    This command is used to display Single Track Directed Offline Scan information.

    If "7> m?"  shows a revision less than 8000.0000, please see "Display And Modify
    Directed Offline Scan Information".
 
  Input Parameters:

    
    0 - Clear Counters Marker
    
        This parameter indicates whether to clear the single track DOS write counters.
    
        If this value is 0x100, the table will be cleared and written to disk, and no
        values will be displayed.  Any other value is ignored.
    
          Type:    unsigned 32 bit value
    
          Range:   0 - 0xFFFFFFFF
    
          Default: 0
    
    1 - Minimum Scan Count
    
        This parameter specifies the lowest count that will be displayed.
    
          Type:    unsigned 32 bit value
    
          Range:   0 - 0xFFFFFFFF
    
          Default: 1
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If no error occurred, the following information will be displayed.  More than one
    line may be displayed.
    
          "                                         last     area     area     left     left    right    right"
          "                  scan                   scan    first     last    start      end    start      end"
          "Idx Cylinder Hd  count  flags    count  count      lba      lba      lba      lba      lba      lba"
          "aaa bbbbbbbb  c dddddd eeeeeeee ffffff gggggg xxxxxxxx yyyyyyyy hhhhhhhh iiiiiiii kkkkkkkk mmmmmmmm
    
       where
       
          aaa - Index of table entry.  The entries are shown in oldest (top) to newest (bottom)
                order.  The index is useful only for identifying a table entry to track how
                it is reused.
    
          bbbbbbbb - Cylinder number of entry
     
          c - Head number of entry
     
          dddddd - Scan count of entry
     
          eeeeeeee - Flags:

             0x01 DOS WRITE COUNTER ATI1       Adjacent track scan due on one side
             0x02 DOS WRITE COUNTER ATI2       Adjacent track scan due on the other side
             0x04 DOS WRITE COUNTER STE1       Multiple track scan due on one side
             0x08 DOS WRITE COUNTER STE2       Multiple track scan due on the other side
             0x10 DOS_ATI_OUGHT_TO_SCAN        ATI Ought To scan is pending or running
             0x20 DOS_ATI_MUST_SCAN            ATI Must scan is pending or running
             0x40 DOS_STE_OUGHT_TO_SCAN        STE Ought To scan is pending or running (Not Supported Yet)
             0x80 DOS_STE_MUST_SCAN            STE Must scan is pending or running
             0x200 DOS_WRITE_FAULT_OUGHT_ATI_SCAN   Write Fault ATI Ought To scan perfomed, pending or running
             0x400 DOS_WRITE_FAULT_OUGHT_ATI_SCAN   Write Fault ATI Must scan perfomed, pending or running
             0x01 DOS WRITE COUNTER RETAIN       Retain this entry
             0x02 DOS WRITE COUNTER RECALC_LBA       serpent calculation done
             0x01 DOS WRITE COUNTER ATI1       Adjacent track scan due on one side
             0x02 DOS WRITE COUNTER ATI2       Adjacent track scan due on the other side
             0x04 DOS WRITE COUNTER STE1       Multiple track scan due on one side
             0x08 DOS WRITE COUNTER STE2       Multiple track scan due on the other side
             0x10 DOS_WRITE_FAULT_OUGHT_ATI_SCAN   Write Fault ATI Ought To scan perfomed, pending or running
             0x20 DOS_WRITE_FAULT_OUGHT_ATI_SCAN   Write Fault ATI Must scan perfomed, pending or running
             0x10 DOS_ATI_OUGHT_TO_SCAN        ATI Ought To scan is pending or running
             0x20 DOS_ATI_MUST_SCAN            ATI Must scan is pending or running
             0x10 DOS_ATI_OUGHT_TO_SCAN        ATI Ought To scan is pending or running
             0x20 DOS_ATI_MUST_SCAN            ATI Must scan is pending or running
             0x10 DOS_ATI_OUGHT_TO_SCAN        ATI Ought To scan is pending or running
             0x20 DOS_ATI_MUST_SCAN            ATI Must scan is pending or running
             0x10 DOS_ATI_OUGHT_TO_SCAN        ATI Ought To scan is pending or running
             0x20 DOS_ATI_MUST_SCAN            ATI Must scan is pending or running
             0x40 DOS_STE_OUGHT_TO_SCAN        STE Ought To scan is pending or running (Not Supported Yet)
             0x80 DOS_STE_MUST_SCAN            STE Must scan is pending or running
    
          ffffff - Count of entry
    
          gggggg - Last scan count of entry
      
          xxxxxxxx - Minimum LBA written for this write count and range.  THIS FIELD NOT PRESENT IN
              ALL FIRMWARE.
    
          yyyyyyyy - Maximum LBA written for this write count and range.  THIS FIELD NOT PRESENT IN
              ALL FIRMWARE.
    
             LBAs: The LBAs are set when a serpent is about to be scanned and are set to
                   F's when the scan is complete.  A user is very unlikely to see anything
                   but 0 ( has not been scanned since power up ) or FFFF ( scan complete )
                   in these fields.
    
          hhhhhhhh - The first LBA of the region to be scanned on one side of the writes
    
          iiiiiiii - The last LBA of the region to be scanned on one side of the writes
    
          kkkkkkkk - The first LBA of the region to be scanned on the other side of the writes
    
          mmmmmmmm - The last LBA of the region to be scanned on the other side of the writes
  
  Examples:
 
    Example #1:
    To display all non-zero counter values:

       F3 7>m
 
    Example #2:
    To display counter values greater than 8:

       F3 7>m,9
 
    Example #3:
    To clear the DOS table and write it to disk:

       F3 7>m100
 
  Revision History:

    NOTE: The high bit of the revision being set indicates this is single track DOS,
          not original DOS.
    
    8001.0000   Initial revision.
    8002.0000   Add 'clear table' option, support new table format, change parameter layout.
    8003.0000   Add display of 'first lba' and 'last lba'.