Saves screen displays into a file, or creates a file with all  of
     the  debugger  commands necessary to re-create the current screen
     state at a later time.

 Format:

     EXTRACT [/qualifier [...]] [disp-name [,disp-name...]] file-spec]

Additional information available:

ExamplesParametersQualifiers

     DBG> EXTRACT SRC                ! Write all the lines in the SRC
                                     ! display into file DEBUG.TXT
                                     ! in the current directory.
     DBG> EXTRACT SRC,OUT MYFILE.TXT ! Write all the lines in displays
                                     ! SRC and OUT into MYFILE.TXT
                                     ! in the current directory.
     DBG> EXTRACT/ALL [MYDIR]MYFILE  ! Write all the lines in all of
                                     ! the displays into the file
                                     ! [MYDIR]MYFILE.TXT.
     DBG> EXTRACT/APPEND SRC MYFILE  ! Append all the lines in display
                                     ! SRC to the end of MYFILE.TXT
                                     ! in the current directory.
     DBG> EXTRACT/SCREEN_LAYOUT      ! Write the debugger commands
     needed
                                     ! to re-construct the screen into
                                     ! file DBGSCREEN.COM in the
                                     ! current directory.

 disp-name

     The name (or list of  names)  of  the  screen  display(s)  to  be
     extracted.   The name of screen displays can be wild-carded.  You
     must specify either one  or  more  display  names,  or  the  /ALL
     qualifier, but not both.

 file-spec

     Specifies the file specification to write the information to.  If
     you  do  not  specify  a file name or file type, the default file
     name DEBUG and default file type TXT  are  provided,  unless  you
     specify  /SCREEN_LAYOUT.   If  you  specify  /SCREEN_LAYOUT,  the
     default file name and file type of the generated command file are
     DBGSCREEN  and  COM,  respectively.  A logical name may be given.
     You can modify the default file specification of the command file
     provided  with  /SCREEN_LAYOUT  by  using  the SET ATSIGN command
     (Type HELP SET ATSIGN).

Additional information available:

/ALL/APPEND/SCREEN_LAYOUT/SUFFIX

     Extract all displays.  If /ALL is used, do not specify a  display
     name.  Do not specify /ALL with /SCREEN_LAYOUT.

     Append the information at  the  end  of  the  file,  rather  than
     creating  a  new  file.  The default is to create a new file.  Do
     not specify /APPEND with /SCREEN_LAYOUT.

     Write a file which contains the debugger commands  that  describe
     the  current  state of the screen.  This information includes the
     screen height and width,  and  the  position,  kind,  and  SELECT
     attributes  of  every  display  which exists at the current time.
     This  file  can  then  be  executed  with  the  "@"  command   to
     re-construct the screen at a later time.

     Note:   This  qualifier  applies  to  a  multiprocess   debugging
     configuration (when DBG$PROCESS has the value MULTIPROCESS).  Use
     this qualifier only directly after a display name.

     Appends a process-identifying suffix  to  a  display  name.   The
     suffix  denotes  the  visible  process.   This  qualifier is used
     primarily  in  command   procedures   when   specifying   display
     definitions   or  key  definitions  that  are  bound  to  display
     definitions.  Use any of  the  following  process-identifier-type
     keywords:

        PROCESS_NAME     The display-name suffix is the VMS process name.

        PROCESS_NUMBER   The display-name suffix is the process number
                         (as shown in a SHOW PROCESS display).

        PROCESS_PID      The display-name suffix is the VMS process
                         identification number (PID).

     If  you  specify  /SUFFIX  without  a  process-identifier-   type
     keyword,  the  process  identifier type used for the display-name
     suffix is, by default, the same  as  that  used  for  the  prompt
     suffix (see SET PROMPT/SUFFIX).