PCA$HELP.HLB  —  CANCEL  EVENT
    Collector Command

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

    Format

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

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.

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.

3  –  Qualifiers

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.

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.
Close Help