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.