Analyzer Command

    Combines several PCA performance data files into one file, and/or
    combines data extracted from several SPM data files into one PCA
    data file.

    Format

      MERGE  input-file-spec[,input-file-spec...]

1  –  Parameters

 input-file-spec

    Any valid OpenVMS file specification that identifies the files
    you want to merge or to take ANC information from. Wildcards may
    be used in the file name and/or in the extension. If you specify
    the /SPM_PROCESS_ID qualifier, then the local node, current
    default device and current default directory are assumed as the
    default for each of the input file-specs provided, and default
    file name extensions are not applied. If you do not specify the
    /SPM_PROCESS_ID qualifier, then the same defaults are assumed,
    but the file name extensions default to PCA.

2  –  Description

    The MERGE command makes it possible for you to process data from
    several files by combining information from several performance
    data files into one PCA performance data file. You can use the
    MERGE command to combine several PCA performance data files or to
    combine data extracted from several SPM data files into one PCA
    data file. This allows you to process and display the PC sampling
    data collected by SPM (Software Performance Measurement). Merged
    data is always appended to the currently opened performance data
    file.

3  –  Qualifiers

3.1    /SPM_PROCESS_ID

       /SPM_PROCESS_ID=(process-id[,...])

    Merges the specified SPM data files. Each process-id parameter
    must be a valid OpenVMS process identification number, specified
    as a hexadecimal number. You may omit the leading zeros. Each
    collection of PC data is assigned a RUN_NAME identifier of
    the form SPM_n, where n is the OpenVMS process identification
    number that you specify in the process-id list. The data must be
    collected for the image of the currently open data file. A list
    of more than one number must be enclosed in parentheses. If you
    omit this qualifier, the Analyzer assumes that all of the files
    are PCA performance files.

3.2    /ANC

    For PCA data files with identical image names, image identifiers,
    link times and link identifiers; PCA writes all ANC (acceptable
    non-coverage) information to the coverage-set table in the output
    file.

    For PCA data files with identical image names and different image
    identifiers, link times or link identifiers; PCA writes only ANC
    (acceptable non-coverage) information from the input PCA data
    file to the coverage-set table in the output file which can be
    validated by the codepath data in both the input and output PCA
    data files.

    /ANC and /SPM_PROCESS_ID cannot be used together in the same
    command. The /ANC qualifier can only be used when merging PCA
    performance data files.

3.3    /SINCE

       /SINCE="time-spec"
       /BEFORE="time-spec"

    Sets the lower and/or higher limits on the collection times of
    the SPM data being merged. These optional qualifiers can only be
    specified together with the /SPM_PROCESS_ID qualifier. The time-
    spec parameters must be enclosed within double quotation marks ("
    ") and must be valid OpenVMS absolute date/time specifications,
    as described in the DCL Concepts manual.

4  –  Examples

  PCAA> SHOW DATAFILE
  Performance Data File: USRD$:[USER]PRIMES.PCA;1
  PCAA> MERGE PRIMES.OLD;*
   Merging file USRD$:[USER]PRIMES.OLD;2
   Merging file USRD$:[USER]PRIMES.OLD;1
  PCAA>

      The MERGE command is used above to merge the contents of
      all the versions of the performance data file PRIMES.OLD
      found in the current default directory into the currently set
      performance data file, PRIMES.PCA;1.

  PCAA> MERGE/SPM=2A80B7/BEFORE="4-JUL-1987" SPM1.DAT,SPM2.DAT

      This MERGE command will merge into the currently set
      performance data file any PC sampling data found in the SPM
      data files SPM1.DAT and SPM2.DAT that have been collected
      before July 4, 1987 for the process whose id number was
      002A80B7 (hexadecimal).