The RESTORE.SCREEN statement restores a rectangular portion of the display screen image previously saved using SAVE.SCREEN().
This statement can only be used with QMConsole and QMTerm sessions and with terminals that support the save and restore screen region functions (e.g. AccuTerm 5.2b upwards with terminal definitions that have the -at suffix).
RESTORE.SCREEN image, restore.state
The RESTORE.SCREEN statement restores the data previously saved in image using SAVE.SCREEN(). The data cannot be restored to a different screen position from which it was saved. If the restore.state expression evaluates to a non-zero value, the pagination mode will also be restored.
IMAGE = SAVE.SCREEN(0, 0, 80, 25)
RESTORE.SCREEN IMAGE, @TRUE
The above code fragment saves the screen image, executes the command in variable COMMAND.STRING and then restores the screen image.