Availability:
     Level L    , 'c'

  Quick Help:
     Create Log File, c[Log],[LogType],[BufferOrDiskOpt],[NumBytes]

  Description:
    This command creates the specified log file.

  Input Parameters:

    0 - Log Number.
    
        This parameter specifies the number that will be associated with the log that
        is to be created.
    
        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: None
    
    1 - Log Type.
    
        This parameter specifies the type of log file to be created.
    
             0 = Error Log
             1 = ASCII Log
             2 = Read/Write Statistics Log
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 2
    
          Default: None
    
    2 - Buffer or Disc Log.
    
        This parameter specifies whether the log file is to be stored in the data buffer
        or on the disc.
    
             0 = Buffer Log
             1 = Disc Log
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 1
    
          Default: None
    
    3 - Log Size in bytes.
    
        This parameter specifies the size, in bytes, of the log file to be created.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to 0xFFFFFFFF
    
          Default: None
    
  Output Data:

    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
  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).