Availability:
     Level 2    , 'E'
     Level 3    , 'E'
     Level 4    , 'E'
     Level 7    , 'E'
     Level A    , 'E'
     Level T    , 'E'

  Quick Help:
     Display / Edit Log, E[LogNum],[ErrCodeOrSpecialFuncKey],[SpecialFunc]

  Description:
    This command displays or modifies the specified Log File.

  Input Parameters:

    0 - Log Number.
    
        This parameter specifies the number of the log to be displayed.  If this
        parameter is not entered, the Active Error Log will be displayed.  If this
        parameter is equal to 0, the Active Error Log will be cleared.  If this
        parameter is entered and is not equal to 0, it specifies the number of the
        Log to be displayed.
    
        The following are the default or special log files supported by the diagnostics:
        0x0000: ACTIVE_ERROR_LOG_ID - Indicates the currently active error log.
        0x0001: ACTIVE_ASCII_LOG_ID - Indicates the currently active ASCII log.
        0x0002: ACTIVE_RW_STATISTICS_LOG_ID - Indicates the currently active R/W statistics log.
        0xFFFA: QMON_STATISTICS_LOG_ID - Indicates QMON error map log.
        0xFFFB: SYMBOL_ERROR_MAP_LOG_ID - Indicates symbol error map log.
        0xFFFC: DEFAULT_ERROR_LOG_ID - Indicates the default error log.
        0xFFFD: DEFAULT_RW_STATISTICS_LOG_ID - Indicates the default R/W statistics log.
        0xFFFE: TEMPORARY_LOG_ID - This log is used internally for copy operations.
        0xFFFF: INVALID_LOG_ID - Indicates an invalid log.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: Display Active Error Log
    
    1 - Special Log Function Key or Display Error Code.
    
        If Parameter 2 is equal to 8, 20 hex, 100 hex, 200 hex or 400 hex, this parameter
        must be equal to AA hex to enable the special error log operation specified by
        Parameter 2.  If Parameter 2 is not equal to 8, 20 hex, 100 hex, 200 hex or 400 hex,
        only log entries with the Error Code specified by this parameter will be displayed.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: None
    
    2 - Select Special Log Function.
    
        This parameter selects the following special log functions.
    
          0x0004 - Display Number of Unused Log Bytes.
    
                   If Parameter 2 is equal to 4, the number of unused bytes in the log
                   specified by Parameter 0 will be displayed.
        
          0x0008 - Clear ASCII Log and update with entered data.
    
                   If Parameter 2 is equal to 8, the ASCII log will be cleared and ASCII data
                   entered from the serial port will be stored in the ASCII log.  When a
                   carriage return is entered, the ASCII log will be stored to the log number
                   specified by Parameter 0.
    
                   Note: When selecting this function, Parameter 1 must be equal to AA hex.
    
          0x0010 - Append data to end of ASCII Log.
    
                   If Parameter 2 is equal to 10 hex, ASCII data entered from the serial port
                   will be appended to the end of the ASCII log.  Entering a carriage return
                   terminates the ASCII data to be appended.
    
          0x0020 - Write Active Error Log to specified Log.
    
                   If Parameter 2 is equal to 20 hex, the Active Error Log will be written
                   to the log number specified by Parameter 0.
    
                   Note: When selecting this function, Parameter 1 must be equal to AA hex.
    
          0x0040 - Enable Fast Log Dump.
    
                   If Parameter 2 is equal to 40 hex, the Fast Log Dump will be enabled.
                   When Fast Log Dump is enabled, unformatted log data will be output and
                   the delay between log dumps will be disabled.
    
          0x0080 - Display Log Address.
    
                   If Parameter 2 is equal to 80 hex, the address of the specified log will
                   be displayed.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: None
    
  Output Data:

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

    The contents of the Error Log will be displayed as follows.
    
          "Log c Entries d"
          "Count DIAGERR  RWERR    LBA      PBA      SFI      WDG  LLL CHS         PLP CHS         Partition"
          "----- -------- -------- -------- -------- -------- ---- --------------- --------------- ---------"
          "eeee  ffffffff hhhhhhhh iiiiiiii jjjjjjjj kkkkkkkk llll mmmmmmmm.n.pppp qqqqqqqq.r.ssss ttttttttt"
    
       where
    
          c is the log number
    
          d is the number of valid log entries
    
          eeee is the number of times the error repeated
    
          ffffffff is the Diagnostic Error Code
    
          hhhhhhhh is the Read/Write Subsystem Error Code
    
          iiiiiiii is the LBA at which the error occurred
    
          jjjjjjjj is the PBA at which the error occurred
    
          kkkkkkkk is the number of symbols from index at which the error occurred
    
          llll is the servo wedge number in which the error occurred
    
          mmmmmmmm is the Logical Cylinder Address at which the error occurred
    
          n is the Logical Head Address at which the error occurred
    
          pppp is the Logical Sector Address at which the error occurred
    
          qqqqqqqq is the Physical Cylinder Address at which the error occurred
    
          r is the Logical Head Address at which the error occurred
    
          ssss is the Physical Sector Address at which the error occurred
    
          tttttttt is an ASCII String that indicates the partition ( "System" or " User" )
          in which the error occurred

    If no error occurred and the contents of an ASCII Log are selected to be displayed,
    
          "Log c Entries d"
    
          (Followed by the ASCII data contained in log)
    
       where
    
          c is the log number
    
          d is the number of valid ASCII characters contained in the log
    
    If no error occurred and the contents of a Read/Write Statistics Log are
    being displayed,

       TBD


    If no error occurred and the number of unused log bytes is being displayed,
    
          "Log e Number of Unused Bytes = ffffffff"
    
       where
    
          e is the number of the log whose starting address is being displayed
    
          ffffffff is the number of log bytes that are currently unused
    

    If no error occurred and the log address is being displayed,
    
          "Log e Starting System Area LBA = ffffffff"      (for a Disc Log or)
          "Log e Starting Buffer Addr = gggggggg"          (for a Buffer Log)
    
       where
    
          e is the number of the log whose starting address is being displayed
    
          ffffffff is the starting System Area LBA of a disc log
    
          gggggggg is the starting Buffer Address of a buffer log
    
  Examples:

    Example #1:
    To create a new user-defined error log as log 10 with 64KB of memory, display
    information about it, enable it as the active error log, and display the actual
    contents of the log:

       F3 L>/Lc10,0,0,10000   <-- Create a new error log as log 10 with 64KB.
       F3 L>/LI10             <-- Display error log 10 information
       F3 L>/LD10             <-- Display the new error log using Level L 'D'
       F3 L>/2E10             <-- Display the new error log using Level 2 'E'
       F3 2>/LE10             <-- Select and enable log 10
       F3 L>/LI               <-- Display current active error log information
  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).
    0012.0000   Added symbols from index, servo wedge, and PBA to the error log output.