Availability:
     Level 1    , 'c'
     Level 2    , 'c'
     Level F    , 'V'

  Quick Help:
     Buffer Compare, c[SrcBlk],[RefBlk],[NumBlks],[ContOnErr]
     Buffer Compare, V[SrcBlk],[RefBlk],[NumBlks],[ContOnErr]

  Description:
    The Buffer Compare command compares the contents of the specified source buffer
    block(s) to the specified reference buffer block(s) and returns an error if a
    miscompare is detected.

  Input Parameters:

    0 - First Source Buffer Block Number.
    
        If this parameter is entered, it specifies the number of the first buffer block
        that contains the source data to be compared.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to Buffer Size (in blocks) minus 1
    
          Default: If this parameter is not entered, the first block of the Diagnostic
                   Read Buffer will be the first source block.
    
    1 - First Reference Buffer Block Number.
    
        If this parameter is entered, it specifies the number of the first buffer block
        to which the source data is to be compared.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to Buffer Size (in blocks) minus 1
    
          Default: If this parameter is not entered, the first block of the Diagnostic
                   Write Buffer will be the first reference block.
    
    2 - Number of Buffer Blocks to Compare.
    
        This parameter specifies the number of consecutive buffer blocks to be compared.
    
          Type:    Unsigned 16-bit value
    
          Range:   1 to maximum number of buffer blocks
    
          Default: If Parameters 0, 1 and 2 are not entered, the entire Diagnostic Read
                   Buffer will be compared to the Diagnostic Write Buffer.  If Parameter 2
                   is not entered and either Parameter 0 or 1 is entered, a single buffer
                   block will be compared.
    
    3 - Continue on Error option.
    
        If this parameter is entered, the compare operation will compare all of the
        specified bytes and display an error for each miscompare that is detected.
        If this parameter is not entered, the compare operation will stop when the
        first miscompare is detected.
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 0xFF
    
          Default: None
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If the error is a buffer miscompare, the following additional information will be
    displayed.
    
          "at SrcBlk = cccc Addr = dddddddd Data = ee, RefBlk = ffff Addr = gggggggg Data = hh"
    
       where
    
          cccc     is the number of the Source Buffer Block in which the miscompare occurred.
    
          dddddddd is the address of the Source Buffer byte that miscompared.
    
          ee       is the value of the Source Buffer byte that miscompared.
    
          ffff     is the number of the Reference Buffer Block in which the miscompare occurred.
    
          gggggggg is the address of the Reference Buffer byte that miscompared.
    
          hh       is the value of the Reference Buffer byte that miscompared.
    
  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).