1  MERGE
   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...]
 

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

2  Qualifiers
 

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

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

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

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