PCA$HELP.HLB  —  CANCEL
    PCA Command

    Cancels a variety of data collection options, definitions and
    mode settings. The data collection option, definition or mode
    setting canceled depends on the keyword specified on the command.

    Format

      CANCEL  keyword [parameters]

1  –  Parameters

 keyword

    Specifies the data collection option, definition, or mode setting
    to cancel. Valid keywords in the Collector are ALL, COUNTERS,
    COVERAGE, CPU_SAMPLING, DATAFILE, DISPLAY, EVENT, IO_SERVICES,
    LOG, PAGE_FAULTS, PC_SAMPLING, SERVICES, SOURCE, STACK_PCS,
    TASKING, UNALIGNED, VCOUNTERS, VCPU_SAMPLING, VERIFY, VPC_
    SAMPLING and WINDOW.

    Valid keywords in the Analyzer are ANC, DATAFILE, DISPLAY,
    FILTER, LOG, PLOT, SOURCE, TITLE, VERIFY and WINDOW.

 parameters

    Depends on the keyword specified.

2  –  Description

    CANCEL is not an individual command. Each CANCEL command consists
    of the word CANCEL followed by a required keyword. See the
    descriptions of the individual CANCEL commands for details.

3  –  ALL

    Collector Command

    Cancels all data collection options.

    Format

      CANCEL ALL

3.1  –  Description

    The CANCEL ALL Collector command cancels all data collection
    options established with the SET commands listed below. PC_
    SAMPLING with the sampling interval of 10 milliseconds becomes
    the new collection default.

    SET COUNTERS                SET COVERAGE
    SET CPU_SAMPLING            EVENT
    SET IO_SERVICES             SET PAG_FAULTS
    SET PC_SAMPLING             SET SERVICES
    SET TASKING                 SET UNALIGNED
    SET VCOUNTERS               SET VCPU_SAMPLING
    SET SET VPC_SAMPLING

4  –  ANC

    Analyzer Command

    Removes the ANC attribute from the specified coverage-set points.

    Format

      CANCEL ANC  [nodespec]

4.1  –  Parameters

 nodespec

    Provides the address location or locations for which to remove
    the ANC attribute from the coverage-set points in the current
    data file. For additional information on nodespecs, refer to the
    Nodespecs entry in PCA HELP.

4.2  –  Qualifiers

4.2.1    /ALL

    Removes the ANC attribute from all the coverage-set points in the
    current data file. You cannot specify a nodespec with the /ALL
    qualifier.

5  –  COUNTERS

    Collector Command

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

    Format

      CANCEL COUNTERS  [nodespec, [nodespec...]]

5.1  –  Parameters

 nodespec

    Specifies a node specification to be canceled. This node
    specification must have been established with a previous SET
    COUNTERS command.

    See HELP Nodespec for information about node specifications.

5.2  –  Description

    The CANCEL COUNTERS Collector command cancels execution counters
    at the program locations specified by the node specification
    or by the /ALL qualifier. Any node specifications you cancel
    must have been established by previous SET COUNTERS commands.
    If you first set an execution counter at a program location
    with SET COUNTERS and then cancel it with CANCEL COUNTERS, no
    execution count is measured at that location when the GO command
    is entered.

5.3  –  Qualifiers

5.3.1    /ALL

    Specifies that all execution counters established with earlier
    SET COUNTERS commands be canceled. If you specify the /ALL
    qualifier, omit the node specifications.

5.4  –  Examples

  PCAC> CANCEL COUNTERS/ALL

      This command cancels all previously established execution
      counters.

  PCAC> CANCEL COUNTERS PROGRAM BY ROUTINE

      This command cancels the execution counters placed on every
      routine in the user program.

6  –  COVERAGE

    Collector Command

    Cancels the collection of test coverage data at specified program
    locations.

    Format

      CANCEL COVERAGE  [nodespec [,nodespec...]]

6.1  –  Parameters

 nodespec

    Specifies a node specification to be canceled. This node
    specification must have been established with a previous SET
    COVERAGE command.

    See HELP Nodespec for information about node specifications.

6.2  –  Description

    The CANCEL COVERAGE Collector command cancels the collection of
    test coverage data at the program locations specified by the node
    specification or by the /ALL qualifier. Any node specifications
    you cancel must have been established by previous SET COVERAGE
    commands. If you first establish test coverage measurement at
    a program location with SET COVERAGE and then cancel it with
    CANCEL COVERAGE, no data is gathered at that location when the GO
    command is entered.

6.3  –  Qualifiers

6.3.1    /ALL

    Specifies that all test coverage breakpoints established with
    earlier SET COVERAGE commands be canceled. If you specify the
    /ALL qualifier, omit the node specifications.

6.4  –  Examples

  PCAC> CANCEL COVERAGE/ALL

      This command cancels all previously established test coverage
      breakpoints.

  PCAC> CANCEL COVERAGE PROGRAM BY CODEPATH

      This command cancels the test coverage breakpoints on all
      codepaths in the user program.

7  –  CPU_SAMPLING

    Collector Command

    Disables the collection of CPU sampling data.

    Format

      CANCEL CPU_SAMPLING

7.1  –  Description

    The CANCEL CPU_SAMPLING Collector command disables the collection
    of CPU sampling data. It thus cancels the effect of an earlier
    SET CPU_SAMPLING command.

8  –  DATAFILE

    PCA Command

    Cancels the performance data file established with the last SET
    DATAFILE command.

    Format

      CANCEL DATAFILE

8.1  –  Description

    The CANCEL DATAFILE command closes the current performance data
    file. The Collector does not record data in that file when data
    collection starts. Instead, it uses the default data file or the
    data file you establish with a subsequent SET DATAFILE command.
    The Analyzer does not read or process data until another SET
    DATAFILE command is entered.

9  –  DISPLAY

    PCA Command

    Deletes the specified screen displays.

    Format

      CANCEL DISPLAY  [display-name [,display-name...]]

9.1  –  Parameters

 display-name

    Specifies a screen display to be canceled. If you specify a
    display-name, do not use the /ALL qualifier.

9.2  –  Description

    The CANCEL DISPLAY command cancels the specified screen displays.
    When a screen display is canceled, it disappears from the screen
    and its contents and definition are permanently lost.

9.3  –  Qualifiers

9.3.1    /ALL

    Cancels all screen displays (except PROMPT) including the PCA-
    defined PLOT, SOURCE and OUT displays. After canceling all
    displays, you must use the SET DISPLAY command to create new
    screen displays if you want to select them for use in screen mode
    (see SELECT command). If you use the /ALL qualifier, omit the
    display-name list.

9.4  –  Examples

  PCAA> CANCEL DISPLAY FOO

      This command removes the screen display named FOO.

10  –  EVENT

    Collector Command

    Cancels the collection of event markers established with previous
    SET EVENT commands.

    Format

      CANCEL EVENT  [event-name [nodespec [,nodespec...]]]

10.1  –  Parameters

 event-name

    Specifies the name of an event for which event markers will
    be canceled. This event name must have been established with a
    previous SET EVENT command.

 nodespec

    Specifies a node specification already associated with the event-
    name event through a previous SET EVENT command. The CANCEL EVENT
    command breaks the association between this node specification
    and the event-name event.

    See HELP NODESPECS for more information on node specifications.

10.2  –  Description

    The CANCEL EVENT Collector command cancels the collection of
    event markers for a specified event when the specified program
    locations associated with that event are executed. Event markers
    for the event-name event are thus not recorded in the performance
    data file when these program locations are executed. If you
    specify an event-name without a program location, then all
    program locations associated with the event-name are canceled.

10.3  –  Qualifiers

10.3.1    /ALL

    Specifies that the collection of all event markers established
    with earlier SET EVENT commands be canceled. If you specify the
    /ALL qualifier, omit the event-name and prog-loc parameters.

10.4  –  Examples

  PCAC> CANCEL EVENT COMPUTE LINE %LINE 22

      This command cancels the event marker established for event
      COMPUTE at line 22 of the program.

  PCAC> CANCEL EVENT TERM_IO

      This command cancels all the event markers established for
      event TERM_IO.

11  –  FILTER

    Analyzer Command

    Deletes filters established with the SET FILTER command. Filters
    specify which data points from the performance data file to tally
    in histograms and tables.

    Format

      CANCEL FILTER  [filter-name [,filter-name...]]

11.1  –  Parameters

 filter-name

    Specifies an existing filter to cancel. The filter must have been
    created with an earlier SET FILTER command.

11.2  –  Description

    The CANCEL FILTER Analyzer command deletes the specified filters
    so they no longer filter the performance or coverage data used by
    the PLOT and TABULATE commands. Filters are established using the
    SET FILTER command.

11.3  –  Qualifiers

11.3.1    /ALL

    Specifies that all currently defined filters be deleted. If you
    use the /ALL qualifier, omit the filter-name parameters.

11.4  –  Examples

  PCAC> CANCEL FILTER FOO, BAR

      This command cancels the previously set filters FOO and BAR.

12  –  IO_SERVICES

    Collector Command

    Disables the collection of I/O services data.

    Format

      CANCEL IO_SERVICES

12.1  –  Description

    The CANCEL IO_SERVICES Collector command disables the collection
    of I/O services data. It thus cancels the effect of an earlier
    SET IO_SERVICES command.

13  –  LOG

    PCA Command

    Disables the recording of PCA input and output in a log file.

    Format

      CANCEL LOG

13.1  –  Description

    The CANCEL LOG command disables the recording of input and output
    in a log file. Input and output logging is established using the
    SET LOG command.

14  –  PAGE_FAULTS

    Collector Command

    Disables the collection of page fault data.

    Format

      CANCEL PAGE_FAULTS

14.1  –  Description

    The CANCEL PAGE_FAULTS Collector command disables the collection
    of page fault data. It thus cancels the effect of an earlier SET
    PAGE_FAULTS command.

15  –  PC_SAMPLING

    Collector Command

    Disables the collection of program counter sampling data.

    Format

      CANCEL PC_SAMPLING

15.1  –  Description

    The CANCEL PC_SAMPLING Collector command disables the collection
    of program counter sampling data. It thus cancels the effect of
    an earlier SET PC_SAMPLING command.

16  –  PLOT

    Analyzer Command

    Resets the SET PLOT defaults to their initial values.

    Format

      CANCEL PLOT

16.1  –  Description

    The CANCEL PLOT Analyzer command resets the SET PLOT default
    qualifiers to their initial values. It also cancels the SET PLOT
    node specifications, if defined. The SET PLOT defaults are set
    with the SET PLOT command and specify qualifier defaults for
    PLOT and TABULATE commands which have node specifications. (PLOT
    and TABULATE commands without node specifications take their
    defaults from the currently active plot.) The SET PLOT defaults
    also specify all qualifier and nodespec defaults for PLOT and
    TABULATE commands that have the /DEFAULT qualifier.

    The CANCEL PLOT command resets the default qualifiers
    to the following values: /PC_SAMPLING, /NOMINIMUM,
    /NOMAXIMUM, /NOCUMULATIVE, /NOMAIN_IMAGE, /NOSCALE,
    /DESCENDING, /SOURCE, /NOSTACK_DEPTH, /ZEROS, /NOCHAIN_NAME,
    /NOPATH_NAME, /NOWRAP, /NOPARENT_TASK, /NOCREATOR_PC, and
    /FILL=("*","O","x","@",":","#","/","+").

    This command also resets the default node specification to
    PROGRAM_ADDRESS BY ROUTINE.

17  –  SERVICES

    Collector Command

    Disables the collection of system services data.

    Format

      CANCEL SERVICES

17.1  –  Description

    The CANCEL SERVICES Collector command disables the collection of
    system services data. It thus cancels the effect of an earlier
    SET SERVICES command.

18  –  SOURCE

    PCA Command

    Cancels the current source file directory search list established
    with a previous SET SOURCE command.

    Format

      CANCEL SOURCE

18.1  –  Description

    The CANCEL SOURCE command cancels the source file directory
    search list established with a previous SET SOURCE command. After
    the directory search list is canceled, PCA is unable to find any
    source file which has been moved or copied since being compiled.

    If you have established a directory search list for a specific
    module with the SET SOURCE/MODULE=modname command, you must use
    the same /MODULE qualifier on the CANCEL SOURCE command to cancel
    that search list.

    If you have established a directory search list for the EDIT
    command using the SET SOURCE/EDIT command, you must use the
    same /EDIT qualifier on the CANCEL SOURCE command to cancel that
    search list.

18.2  –  Qualifiers

18.2.1    /EDIT

    Specifies that the EDIT command directory search list established
    with a previous SET SOURCE/EDIT command be canceled. This command
    should only be used if the EDIT command has its own specific
    directory search list.

18.2.2    /MODULE

       /MODULE=module-name

    Specifies that the directory search list for a specific module
    established with a previous SET SOURCE/MODULE command be
    canceled. This qualifier should be used only if the module-name
    module has its own specific directory search list.

18.3  –  Examples

  PCAA> CANCEL SOURCE
  PCAA> SHOW SOURCE
  No source directory search list

      The above CANCEL SOURCE command cancels any directory search
      list previously established for all modules with a SET SOURCE
      command.

19  –  STACK_PCS

    Collector Command

    Disables the collection of stack PC values (return addresses from
    the call stack) when other kinds of data are gathered.

    Format

      CANCEL STACK_PCS

19.1  –  Description

    The CANCEL STACK_PCS Collector command disables the collection
    of call stack PC values. It thus cancels the effect of an earlier
    SET STACK_PCS command.

20  –  TASKING

    Collector Command

    Disables the collection of tasking data.

    Format

      CANCEL TASKING

20.1  –  Description

    The CANCEL TASKING command disables the collection of tasking
    data established with any previously issued SET TASKING command.

21  –  TITLE

    Analyzer Command

    Cancels the title text for histograms and tables established with
    a previous SET TITLE command.

    Format

      CANCEL TITLE

21.1  –  Description

    The CANCEL TITLE Analyzer command deletes the title text
    established with the last SET TITLE command. That title text no
    longer appears on each page of PLOT and TABULATE output. Instead,
    the default title text appears as follows:

                   Performance and Coverage Analyzer for OpenVMS

22  –  UNALIGNED

    Collector Command

    Disables the collection of unaligned access fault data.

    Format

      CANCEL UNALIGNED

22.1  –  Description

    The CANCEL UNALIGNED Collector command disables the collection
    of unaligned access fault data. It thus cancels the effect of an
    earlier SET UNALIGNED command.

23  –  VCOUNTERS

    Collector Command

    Cancels the collection of vector instruction counts at specified
    program locations.

    Format

      CANCEL VCOUNTERS  [nodespec [, nodespec...]]

23.1  –  Parameters

 nodespec

    Specifies a node specification to be canceled. This node
    specification must have been established with the SET VCOUNTERS
    command.

23.2  –  Description

    The CANCEL VCOUNTERS command cancels vector instruction counters
    at the program locations specified by the node specification
    or by the /ALL qualifier. If you first set a vector instruction
    counter at a program location with SET VCOUNTERS and then cancel
    it with CANCEL VCOUNTERS, no execution count is measured at that
    location when the GO command is entered.

23.3  –  Qualifiers

23.3.1    /ALL

    Specifies that all vector instruction counters established with
    earlier SET VCOUNTERS commands be canceled. If you specify the
    /ALL qualifier, omit the node specifications.

23.4  –  Examples

  PCAC> CANCEL VCOUNTERS/ALL

      This command cancels all previously established vector
      instruction counters.

  PCAC> CANCEL VCOUNTERS ROUTINE FOO BY VINSTRUCTION

      This command cancels the vector instruction counters place in
      routine FOO in the user program.

24  –  VCPU_SAMPLING

    Collector Command

    Disables the collection of vector CPU sampling data.

    Format

      CANCEL VCPU_SAMPLING

24.1  –  Description

    The CANCEL VCPU_SAMPLING Collector command disables the
    collection of vector CPU sampling data established with an
    earlier SET VCPU_SAMPLING command.

25  –  VERIFY

    PCA Command

    Disables the echoing of command input to the terminal.

    Format

      CANCEL VERIFY

25.1  –  Description

    The CANCEL VERIFY command disables the echoing of command input
    to the terminal. It cancels the effect of an earlier SET VERIFY
    command.

26  –  VPC_SAMPLING

    Collector Command

    Disables the collection of vector PC sampling data.

    Format

      CANCEL VPC_SAMPLING

26.1  –  Description

    The CANCEL VPC_SAMPLING Collector command disables the collection
    of vector PC sampling data established with an earlier SET VPC_
    SAMPLING command.

27  –  WINDOW

    PCA Command

    Deletes a screen window definition.

    Format

      CANCEL WINDOW  [window-name [,window-name...]]

27.1  –  Parameters

 window-name

    Specifies the name of a screen window definition to be canceled.

27.2  –  Description

    The CANCEL WINDOW command cancels the specified screen window
    definitions. After a window definition has been canceled, that
    window name can no longer be used on DISPLAY or SET DISPLAY
    commands. Only the definition of the window name is deleted;
    the actual screen region specified by the window name is not
    affected. Screen displays that were declared with the window
    name are not affected except that the SHOW DISPLAY command shows
    numeric window coordinates instead of the canceled window name.

27.3  –  Qualifiers

27.3.1    /ALL

    Specifies that all screen window definitions be canceled,
    including all window definitions predefined by the Analyzer.
    If you use the /ALL qualifier, omit the window-name parameters.

27.4  –  Examples

  PCAC> SHOW WINDOW SMALL
  window SMALL at (1,2,1,80)
  PCAC> CANCEL WINDOW SMALL
  PCAC> SHOW WINDOW SMALL
  window(s) not defined

      Above, the CANCEL WINDOW command is used to cancel window
      SMALL, which was previously defined with the SET WINDOW
      command.
Close Help