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