SCRNRESTORE

8.0.4, ANSI

The SCRNRESTORE instruction (which may be abbreviated as SCRNREST) restores the entire contents and state of a screen from a variable. The instruction uses the following format:

[label]

SCRNRESTORE

{screen}

Where:

label

Optional. A Program Execution Label.

screen

Required. A previously defined Character String Variable from which the entire contents of a screen plus the screen state information is restored.

Flags Affected: NONE

Note the following:

If {screen} does not contain the exact amount of information for the screen, no change is made to the screen and an E06 Error is generated. This error is not trappable.
The characters and attributes are displayed in row major order.
All of the screen state information that was stored in the {screen} is made current.