Preserves the contents of an existing screen display in a new
    display.

                                   NOTE

       This command is not available in the VSI DECwindows Motif for
       OpenVMS user interface to the debugger.

    Format

      SAVE  old-display AS new-display [, . . . ]

1  –  Parameters

 old-display

    Specifies the display whose contents are saved. You can specify
    any of the following entities:

    o  A predefined display:

          SRC
          OUT
          PROMPT
          INST
          REG
          FREG (Alpha and Integrity servers only)
          IREG

    o  A display previously created with the DISPLAY command

    o  A display built-in symbol:

          %CURDISP
          %CURSCROLL
          %NEXTDISP
          %NEXTINST
          %NEXTOUTPUT
          %NEXTSCROLL
          %NEXTSOURCE

 new-display

    Specifies the name of the new display to be created. This new
    display then receives the contents of the old-disp display.

2  –  Description

    The SAVE command enables you to save a snapshot copy of an
    existing display in a new display for later reference. The new
    display is created with the same text contents as the existing
    display. In general, the new display is given all the attributes
    or characteristics of the old display except that it is removed
    from the screen and is never automatically updated. You can later
    recall the saved display to the terminal screen with the DISPLAY
    command.

    When you use the SAVE command, only those lines that are
    currently stored in the display's memory buffer (as determined
    by the /SIZE qualifier on the DISPLAY command) are stored in
    the saved display. However, in the case of a saved source or
    instruction display, you can also see any other source lines
    associated with that module or any other instructions associated
    with that routine (by scrolling the saved display).

    You cannot save the PROMPT display.

    Related commands:

       DISPLAY
       EXITLOOP

3  –  Example

  DBG> SAVE REG AS OLDREG

      This command saves the contents of the display named REG into
      the newly created display named OLDREG.