1  EXTRACT
   PCA Command

   Saves the contents of a screen display in a file or creates a
   file with all of the commands necessary to re-create the current
   screen state at a later time.

   Format

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

2  Parameters
 

disp-name

   Specifies a display to be extracted. You can use the wildcard
   character (*) in a display name. When using /ALL, do not specify
   a display name.
 

file-spec

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

   If you specify /SCREEN_LAYOUT to save the configuration of the
   screen, then the default specification for the file is PCA.PCAC
   in the Collector, PCA.PCAA in the Analyzer. Otherwise, the
   default file specification is PCA.TXT.
 

2  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 or SET DISPLAY command) are written
   to the file.

   You cannot extract the contents of the PROMPT display into a
   file.
 

2  Qualifiers
 

/ALL

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

/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 /APPEND.
 

/SCREEN_LAYOUT

   Writes a file that contains the commands describing the current
   state of the screen. This information includes the screen height
   and width, and the position, display kind, and display attributes
   of every existing display. This file can then be executed with
   the @file-spec command to reconstruct the screen at a later time.
 

2  Examples

 PCAA> EXTRACT SRC

     This command writes all the lines in display SRC into file
     PCA.TXT.

 PCAA> EXTRACT/APPEND OUT [STEVE.WORK]MYFILE

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

 PCAA> EXTRACT/SCREEN_LAYOUT

     This command writes the PCA commands needed to reconstruct the
     screen into file PCA.PCAA.