Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Examples

Parameters

Qualifiers

/ALL

/APPEND

/SCREEN_LAYOUT

DEBUG EXTRACT — VMS 4.6

     Saves screen displays into a file, or creates a file with all  of
     the  DEBUG  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

Examples

     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 DEBUG commands needed
                                     ! to re-construct the screen into
                                     ! file DBGSCREEN.COM in the
                                     ! current directory.

Parameters

 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).

Qualifiers

Additional information available:

/ALL/APPEND/SCREEN_LAYOUT

/ALL

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

/APPEND

     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.

/SCREEN_LAYOUT

     Write a file which contains the DEBUG 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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026