PCA$HELP.HLB  —  SET  FILTER  Examples
  PCAA> SET FILTER F1 RUN=1
  PCAA> PLOT PROGRAM BY ROUTINE

      The SET FILTER command defines a filter named F1. When the PLOT
      command is executed, only data from collection run 1 is tallied
      in the histogram.

  PCAA> SET FILTER FUMBLE PROGRAM_ADDRESS=FRATZ
  PCAA> PLOT/COUNTERS/CUMULATIVE PROGRAM BY ROUTINE

      The SET FILTER command defines filter FUMBLE. To pass this
      filter, the program address value of a data point must fall
      in the address range of routine FRATZ. The PLOT command plots
      the number of times each routine in the program calls routine
      FRATZ, directly or indirectly by way of other routines.

  PCAA> SET FILTER F1 RUN=3:5, RUN=8
  PCAA> SET FILTER F2 TIME=COMPUTE
  PCAA> SET FILTER F3 IO_SERVICE=SYS$PUT, IO_SERVICE=SYS$GET
  PCAA> TABULATE/IO_SERVICES MODULE FRATZ BY LINE

      The SET FILTER commands define filters F1, F2, and F3. To pass
      filter F1, a data point must come from collection run 3, 4,
      5, or 8. To pass filter F2, a data point must be collected
      after a COMPUTE event marker and before any other event. To
      pass filter F3, an I/O data point must represent a SYS$PUT
      or SYS$GET system service call. To be tallied in the table
      produced by the TABULATE command, an I/O data point must pass
      all three filters. (Had non-I/O data been tabulated, the data
      points would need to pass only filters F1 and F2 because the
      IO_SERVICE restriction is not applicable to non-I/O data.)

  PCAA> SET FILTER VLEN1 VLENGTH=0, VLENGTH=32, VLENGTH=64
  PCAA> PLOT VLENGTH BY ELEMENT

      The SET FILTER command defines a filter named VLEN1. When the
      PLOT command is executed, the report view is based on the
      Vector Length Register (VLR). It only shows the VLR lengths
      that are of a specified value. This is useful is a certain
      operation is known to work optimally when given vectors of a
      given length.

  PCAA> SET FILTER VLEN1 VLEN=0:7
  PCAA> PLOT PROGRAM BY ROUTINE

      This shows locations in the program where the use of vector
      instructions is not efficient, indicating that scalar
      instructions would be more appropriate.
Close Help