Analyzer Command

    Writes the output from the most recent PLOT, TABULATE, INCLUDE,
    EXCLUDE, LIST, or traverse command to a text file.

    Format

      FILE  file-spec

1  –  Parameters

 file-spec

    Specifies the file to which the output from the last PLOT,
    TABULATE, INCLUDE, EXCLUDE, LIST or traverse command will be
    written. The file-spec parameter can be any valid OpenVMS file
    specification. If no file type is specified, it defaults to
    PCALIS.

2  –  Description

    The FILE Analyzer command writes the output from the most recent
    PLOT, TABULATE, INCLUDE, EXCLUDE, LIST or traverse command to
    a file. Thus, to write a histogram, table, or listing of raw
    performance data to a file, first enter a command to generate the
    report on the terminal, and then enter a FILE command to write
    that report to a file. The text file can be printed or used as
    input to other programs.

    When writing histograms and tables to a file, the FILE command
    assumes that there are 66 lines per page and formats the output
    accordingly. You can change the number of lines per page by
    defining the logical name SYS$LP_LINES at DCL level.

    You can concatenate many separate histograms, tables, or listings
    into a single file by using the APPEND command.

3  –  Examples

  PCAA> PLOT/IO_SERVICE MODULE FOO BY LINE
  PCAA> FILE FOOLINES
  %PCA-I-CREFILE, creating file DEV$:[MYDIR]FOOLINES.PCALIS

      A histogram is generated with the PLOT command. That histogram
      is then written to the text file FOOLINES.PCALIS.

  PCAA> LIST ALL
  PCAA> FILE PING.DAT
  %PCA-I-CREFILE, creating file DEV$:[MYDIR]PING.DAT

      A listing of all raw data in the performance data file is
      generated with the LIST command. (If the output is long, it
      can be stopped with CTRL/C.) That listing is written to the
      file PING.DAT. This file can later be printed or used as input
      to a data reduction program of your own.