Previous Topic: MVCURSOR termname row columnNext Topic: POKE termname row col poketext


PEEK termname row col length

Use this command to display virtual terminal screen buffer contents. This command displays the raw buffer code in hexadecimal. Sixteen bytes are displayed in hexadecimal for each output line.

The typical use of this command is to interrogate 3278 host attribute bytes or to examine the Operator Information Area (Row 0). This buffer code is returned in EBCDIC format by the PEEK command. The ranges X'20' through X'3f' are attribute bytes. For an easier way to read the screen, see the RDSCRROW and RDSCREEN commands. The following example shows the beginning of the TSO READY message. The first 24 is a high-intensity unprotected attribute byte. The next five characters are READY in 3278 buffer code. The next 20 is a low-intensity unprotected attribute byte.

This command runs synchronously in AOF rules and will return data in the external data queue.

PEEK * 22 1 30
24 D9 C5 C1 C4 E8 20 00 00 00 00 00 00 00 00 00 *.READY..........*
00 00 00 00 00 00 00 00 00 00 00 00 00 00
Return code:
  0 - Normal completion.
  4 - virtual terminal is not defined.
    - virtual terminal is not enabled.
 12 - Invalid row/column/length specification.
      The row or column is larger than the screen size
      or the length spans beyond the end of the screen.