PCA$HELP.HLB  —  SET  COUNTERS
    Collector Command

    Establishes the collection of exact execution counts at specified
    program locations.

    Format

      SET COUNTERS  nodespec [,nodespec...]

1  –  Parameters

 nodespec

    Specifies a set of program locations that gather execution
    counts.

    See HELP Nodespec for information about node specifications.

2  –  Description

    The SET COUNTERS command establishes execution counters at all
    program locations specified by the node specifications. After you
    enter the GO command, the Collector counts the number of times
    each specified program location is executed and records each
    execution in the performance data file.

    If you enter the SET COUNTERS command before entering a SET
    DATAFILE command, the Collector establishes a default data file.
    The default data file has the same file name as your program's
    executable image file and a file type of PCA.

    You must collect stack PC information if you want to use a /MAIN_
    IMAGE, /CUMULATIVE or /STACK_DEPTH qualifier with the PLOT or TAB
    command in the Analyzer.

3  –  Qualifiers

3.1    /STACK_PCS

    Specifies that stack PC values are collected for counter data.
    Further SET COUNTERS requests will assume a default of /STACK_
    PCS.

3.2    /NOSTACK_PCS

    Specifies that no stack PC values are collected for counter data.
    This is the default upon entry into the collector.

4  –  Examples

  PCAC> SET COUNTERS/STACK_PCS LINE PRIMES %LINE 22

      This command causes PCA to count the executions of line 22
      of module PRIMES when data collection starts, and enables the
      collection of stack PC values. For all further SET COUNTERS
      requests, a default of /STACK_PCS will be established.

  PCAC> SET COUNTERS PROGRAM BY ROUTINE

      This command specifies that execution counters be placed at all
      routine entry points in the user program.
Close Help