Saves the contents of screen displays in a file or creates a
    debugger command procedure with all of the commands necessary to
    re-create the current screen state later on.

                                   NOTE

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

    Format

      EXTRACT  [display-name[, . . . ]] [file-spec]

1  –  Parameters

 display-name

    Specifies a display to be extracted. 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

    You can use the asterisk (*)  wildcard character in a display
    name. Do not specify a display name with the /ALL qualifier.

 file-spec

    Specifies the file to which the information is written. You can
    specify a logical name.

    If you specify /SCREEN_LAYOUT, the default specification for
    the file is SYS$DISK:[]DBGSCREEN.COM. Otherwise, the default
    specification is SYS$DISK:[]DEBUG.TXT.

2  –  Qualifiers

2.1    /ALL

    Extracts all displays. Do not specify /SCREEN_LAYOUT with this
    qualifier.

2.2    /APPEND

    Appends the information at the end of the file, rather than
    creating a new file. By default, a new file is created. Do not
    specify /SCREEN_LAYOUT with this qualifier.

2.3    /SCREEN_LAYOUT

    Writes a file that contains the debugger commands describing the
    current state of the screen. This information includes the screen
    height and width, message wrap setting, and the position, display
    kind, and display attributes of every existing display. This file
    can then be executed with the execute procedure (@) command to
    reconstruct the screen at a later time. Do not specify /ALL with
    this qualifier.

3  –  Description

    When you use the EXTRACT command to save the contents of a
    display into a file, only those lines that are currently stored
    in the display's memory buffer (as determined by the /SIZE
    qualifier on the DISPLAY command) are written to the file.

    You cannot extract the PROMPT display into a file.

    Related commands:

       DISPLAY
       SAVE

4  –  Examples

    1.DBG> EXTRACT SRC

      This command writes all the lines in display SRC into file
      SYS$DISK:[]DEBUG.TXT.

    2.DBG> EXTRACT/APPEND OUT [JONES.WORK]MYFILE

      This command appends all the lines in display OUT to the end of
      file [JONES.WORK]MYFILE.TXT.

    3.DBG> EXTRACT/SCREEN_LAYOUT

      This command writes the debugger commands needed to reconstruct
      the screen into file SYS$DISK:[]DBGSCREEN.COM.