1  FILE
   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
 

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

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