Availability:
     Level 1    , 'B'
     Level 2    , 'B'
     Level 7    , 'B'
     Level F    , 'B'
     Level H    , 'B'

  Quick Help:
     Buffer Display, B[DisplayBlk],[RefBlk],[NumBlks],[Opts],[SymBits]

  Description:
    The Buffer Display command reads and displays the contents of the specified buffer
    blocks.  Optionally, the buffer data being displayed can be compared to a specified
    compare buffer blocks, with miscomparing bytes displayed as highlighted text.

  Input Parameters:

    0 - Display Buffer Block.
    
        This parameter specifies the number of the first buffer block to be displayed.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to last buffer block number
    
          Default: If this parameter is not entered, the First block of Diagnostic Read
                   Buffer will be displayed.
    
    1 - Reference Buffer Block.
    
        This parameter specifies the number of the first buffer block that will be
        compared to the blocks being displayed.  Bytes that miscompare will be
        displayed as highlighted text.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to last buffer block number
    
          Default: If this parameter is not entered and the Display Buffer Block is
                   located in the Diagnostic Read Buffer, the corresponding block in
                   the Diagnostic Write Buffer will be used as the Reference Buffer
                   Block.
    
    2 - Number of Blocks.
    
        This parameter specifies the number of consecutive buffer blocks to be display.
    
          Type:    Unsigned 16-bit value
    
          Range:   1 to the number of buffer blocks
    
          Default: 1
    
    3 - Options.
    
        This parameter is a bit-significant value that selects the following options.
    
          Bits 31-1: not used
    
          Bit 0:     Disable pause after each block displayed.
    
                      If this bit is cleared, the display will pause after each block
                      and wait for the user to enter a character.
    
                      If this bit is set, all of the requested blocks will be displayed
                      without pausing.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to 0xFFFFFFFF
    
          Default: 0 (Enable pause after each block displayed)
    
    4 - Symbol Size.
    
        If this parameter specifies the size, in bits, of the symbols to be displayed.
    
          Type:    Unsigned 8-bit value
    
          Range:   1 to 32
    
          Default: 8
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If no error occurred, the following header will be displayed.
    
          "Buffer Block cccc (eee Bytes/Block)"                                   or
          "Buffer Block cccc compared to Buffer Block dddd (eee Bytes/Block)"
    
       where
    
          cccc  is the number of the Buffer Block being displayed.
    
          dddd  if the number of the Buffer Block to which the displayed block is
                being compared.
    
          eee   is the number of bytes per block.
    
    If the memory data is being displayed as bytes, the following information will be
    displayed following the header.
    
          "  Addr    0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F"
          "ffffffff  gg gg gg gg gg gg gg gg gg gg gg gg gg gg gg gg"  (repeated)
    
       where
    
          ffffffff is the buffer address of the first byte in the row.
    
          gg       is the buffer data byte.
    
    If the memory data is being displayed as non-8-bit symbols, the following information
    will be displayed following the header.
    
          "Symbol Size = hh bits"
          "Sym  0  1  2  ... "
          "iii  jj jj jj ... "             (repeated)
    
       where
    
          hh    is the size, in bits, of the symbols being displayed.
    
          iii   is the number of the first symbol in the row.
    
          jj    is the buffer symbol.  The number of characters displayed for each symbol
                will vary depending on the symbol size.
    
    If the displayed data is being compared to a reference buffer block, the bytes or
    symbols that are not equal to the reference will be displayed as highlighted text.
    
  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