Availability:
     Level 2    , 'X'

  Quick Help:
     Display Track Information, X[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).