Availability:
     Level A    , 'l'

  Quick Help:
     Display Track Information, l[LogCyl],[Hd],[SysAreaOpt],[Opts],[RowsPerPage]

  Description:
    This command displays information about the specified track.  If no track address is
    specified, this command will display information about the current Target Track.

  Input Parameters:

    0 - Logical Cylinder Address.
    
        If Parameter 2 is not entered, this parameter is the User Area logical cylinder
        address of the track for which information is to be displayed.  If Parameter 2
        is entered, this parameter is the System Area logical cylinder address of the
        track for which information is to be displayed.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to 0xFFFFFFFF
    
          Default: Next logical cylinder address in the Test Space
    
    1 - Logical Head Address.
    
        This parameter is the logical head address of the track for which information
        is to be displayed.
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 0xFF
    
          Default: Next logical head address in the Test Space
    
    2 - System Area Flag.
    
        If any value is entered for this parameter, then Parameter 0 specifies a System
        Area logical cylinder address, else it specifies a User Area logical cylinder
        address.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: None
    
    3 - Display Sector Information option.
    
        If this parameter is equal to 0, the specified tracks sector information will not
        be displayed, else the specified tracks sector information will be displayed.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: For Level 2 'X' the default is 1 (Display track's Sector Information)
                   For Level A 'l' the default is 0 (Don't display track's Sector Information)
    
    4 - Sector Information Rows Per Page.
    
        If Parameter 3 is entered and this parameter is entered, the sector information
        display will pause after the number of rows specified by this parameter and wait for
        the user to enter a character.  If this parameter is not entered, all of the sector
        information will be displayed without pausing.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: None (Don't pause the sector information display)
    
  Output Data:

    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    

    The track information will be displayed as follows.
    
          "Track Info:"
          "Partition PhyCyl   LogCyl   NomCyl   Radius_mils LogHd Zn 
FirstLba FirstPba LogSecs PhySecs WdgSkw SecPerFrm WdgPerFrm"
          "bbbbbb    cccccccc dddddddd nnnnnnnn o.ooooooEoo ee    ff 
gggggggg hhhhhhhh iiii    jjjj    kkkk   llll      mmmm"
    
       where
    
          bbbbbb            is either "User" or "System" to indicate 
which partition.
    
          cccccccc          is the Logical Cylinder address where 
Logical Cylinders do not
                            include the cylinders in other partitions.
    
          dddddddd          is the Physical Cylinder address where 
Physical Cylinders
                            include User Area Cylinders, System Area 
Cylinders and Spare
                            Cylinders.
    
          ee                is the Logical Head address where Logical 
Heads do not
                            include heads that have been depopulated.
    
          ff                is the number of the zone that contains the 
track.
    
          gggggggg          is the first Logical Block Address (LBA) on 
the track.
    
          hhhhhhhh          is the first Physical Block Address (PBA) on
 the track.
    
          iiii              is the number of logical sectors on the 
track.
    
          jjjj              is the number of physical sectors on the 
track.
    
          kkkk              is the skew in wedges from index to the 
wedge that contains
                            physical sector 0.
    
          llll              is the number of physical sectors per frame.
    
          mmmm              is the number of wedges per frame.
    
          nnnnnnnn          is the Nominal Cylinder address where 
Nominal Cylinders
                            remove the VBAR scaling factor.
    
          o.ooooooEoo       is the Radius in milliinches as measured 
from the hub.
    
    If the Sector Information display is enabled, the following 
additional information
    will be displayed:

    
    "Sector Info:"
    
    "PhySec(LogSec) Wdg SFI        PhySec(LogSec) Wdg SFI        
PhySec(LogSec) Wdg SFI        PhySec(LogSec) Wdg SFI        Split"
      cccc   dddd   eee ffffffff    gggg   hhhh   iii jjjjjjjj    kkkk  
 llll   mmm nnnnnnnn    pppp   qqqq   rrr tttttttt   qqq:rrr
      
    
    As shown above, the sector information is displayed in four columns.  For each column,
    the Physical Sector Address (PhySec) increments sequentially for each row.  All of the
    sectors in a given row are at the same sector offset from the start of the frame and
    frames are seperated by a blank line.  The displayed information is defined as follows:
    
       cccc, gggg, kkkk and pppp are the Physical Sector Address.
    
       dddd, hhhh, llll and qqqq are the Logical Sector Address.
    
       eee, iii, mmm and rrr are the number of the Servo Burst that preceeds the sector.
    
       ffffffff, jjjjjjjj, nnnnnnnn, tttttttt are the number of NRZ Symbols from Index
       to the start of the sector.
    
       qqq is the number of bytes before the servo burst that splits the sector for all
       sectors in the row.
    
       rrr is the number of bytes after the servo burst that splits the sector for all
       sectors in the row.
    
  Revision History:

    0001.0000   Initial revision.
    0011.0000   Combined the PSG Diagnostic Error Codes (PSGDEC) and the Diagnostic External
                Test Service Error Codes (DETSEC) into a single set of Diagnostic Error Codes
                (DiagError).