PCA Command

    Identifies the performance data file to be used by the Collector
    or processed by the Analyzer.

    Format

      SET DATAFILE  [file-spec]

1  –  Parameters

 file-spec

    Specifies the performance data file the Collector should use
    to record symbol information and performance or coverage data,
    or that the Analyzer should process. File-spec can be any valid
    OpenVMS file specification. If no file type is specified, the
    default file type is PCA.

2  –  Description

    In the Collector, the SET DATAFILE command identifies the
    performance data file the Collector should use to record symbol
    information and performance or coverage data. No performance or
    coverage data is actually written to the specified file until you
    enter the GO command. You can thus respecify the data file with
    another SET DATAFILE command if you need to correct the data file
    specification.

    If you want to append the data from the present collection run to
    an existing performance data file, use the /APPEND qualifier. If
    you want to measure the performance of a shareable image, use the
    /SHAREABLE qualifier.

    In the Analyzer, the SET DATAFILE command identifies a
    performance data file to be processed by the Analyzer. Data from
    this file is used by all subsequent PLOT, TABULATE, LIST, and
    SHOW commands. You can use the SET DATAFILE command to change the
    performance data file any number of times during the Analyzer
    session. The Collector builds the performance data file to
    contain all symbol information and all performance or coverage
    data required by the Analyzer.

3  –  Qualifiers

3.1    /APPEND

    Appends the performance or coverage data from the current
    collection run to an existing performance data file. If the file
    specified by file-spec exists, the Collector opens that file
    and appends the performance or coverage data from the current
    collection run to it. If the file specified by file-spec does
    not exist, the Collector creates a new data file by that name and
    writes the performance or coverage data to that file. If you do
    not specify the /APPEND qualifier, the Collector always creates
    a new file. You may append data to an existing data file only by
    using the same image that originally created the file.

3.2    /EXECUTABLE

    Causes the Collector to use the default performance data file
    name. The default data file name consists of the name of the user
    program's executable image and the .PCA file type. You get the
    default file name if you do not use the SET DATAFILE command.
    However, you need the /EXECUTABLE qualifier if you want the
    default file name and you also want to specify the /APPEND or
    /SHAREABLE qualifier. If you specify the /EXECUTABLE qualifier,
    omit the file-spec parameter.

3.3    /SHAREABLE

       /SHAREABLE=(img-name)

    Specifies that you want to measure the performance of a shareable
    image and that you have created a Debug Symbol Table that fits
    that shareable image. The img-name parameter specifies the
    shareable image to measure.

4  –  Examples

  PCAC> SET DATAFILE [PING]TEST

      This command specifies that the performance or coverage data be
      written to a new file called [PING]TEST.PCA.

  PCAA> SET DATAFILE [PING]TEST

      This command specifies that performance or coverage data should
      be taken from file [PING]TEST.PCA by subsequent PLOT, TABULATE,
      and LIST commands.

  PCAC> SET DATAFILE/APPEND [PING]OLDTEST

      This command specifies that the performance or coverage data be
      appended to the existing data file [PING]OLDTEST.PCA.

  PCAC> SET DATAFILE/SHAREABLE=(MYSHR) SHRDATA

      This command specifies that the performance of shareable image
      MYSHR be measured. The name of the data file is SHRDATA.PCA.