Host Environment Commands › ADDRESS EPI Commands › EPI RDSCREEN—Retrieve Virtual Terminal Screen

EPI RDSCREEN—Retrieve Virtual Terminal Screen

The RDSCREEN command returns the entire virtual terminal screen as a set of output lines. The first output line is the operator information area, which is the status line at the bottom of the screen. The remaining lines are the screen contents starting with the top row. If trimming is on, trailing blanks are trimmed.

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

This command has the following format:

ADDRESS EPI "RDSCREEN keywords"
  {termname|*}

termname

Defines the virtual terminal for which you want to retrieve the screen.

*

Retrieves the screen for the current terminal defined by the SETTERM command.

Example: EPI RDSCREEN

The following returns the screen image on virtual terminal TERM4:

RDSCREEN TERM4