+---------------------------------+
|           SAVE SCREEN           |
+---------------------------------+
SAVE SCREEN [TO <memvar>]

-----------------------------------
Saves a screen or window image to memory.
-----------------------------------

The SAVE SCREEN command saves the current screen or output window image
to a buffer, a memory variable or a memory variable array element so
that it may be redisplayed.  The ability to SAVE and RESTORE screen or
window images eliminates the need to redraw a screen or window image
step-by-step each time you need to display the screen or window image.

Screen or window images stored to a buffer with SAVE SCREEN may be
redisplayed with the RESTORE SCREEN command.  Images saved TO a memory
variable or an array element can be restored with the RESTORE SCREEN
FROM command.

Memory variables or array elements which have screen or window images
stored to them appear with a data type of `S' when you DISPLAY or LIST
MEMORY.  SCREENs saved to memory occupy approximately 4K of memory; this
memory is allocated from the memory variable pool.

Screens or windows saved to memory variables or array elements can be
SAVEd TO and RESTOREd FROM memory variable files or memo fields just
like other memory variables.

Clauses
-------

TO <memvar>
        Saves current screen or output window image to memory variable or
memory variable array element.  If you don't specify TO, the image is
saved to a buffer.

-----------------------------------

See Also:  RESTORE FROM, RESTORE SCREEN, SAVE TO

-----------------------------------