PCA$HELP.HLB  —  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]

1  –  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.

3  –  Qualifiers

3.1    /ALL 

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

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

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

4  –  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.
Close Help