1 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] 2 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. 2 ALL Collector Command Cancels all data collection options. Format CANCEL ALL 3 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 2 ANC Analyzer Command Removes the ANC attribute from the specified coverage-set points. Format CANCEL ANC [nodespec] 3 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. 3 Qualifiers /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. 2 COUNTERS Collector Command Cancels the collection of exact execution counts at specified program locations. Format CANCEL COUNTERS [nodespec, [nodespec...]] 3 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. 3 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. 3 Qualifiers /ALL Specifies that all execution counters established with earlier SET COUNTERS commands be canceled. If you specify the /ALL qualifier, omit the node specifications. 3 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. 2 COVERAGE Collector Command Cancels the collection of test coverage data at specified program locations. Format CANCEL COVERAGE [nodespec [,nodespec...]] 3 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. 3 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. 3 Qualifiers /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. 3 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. 2 CPU_SAMPLING Collector Command Disables the collection of CPU sampling data. Format CANCEL CPU_SAMPLING 3 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. 2 DATAFILE PCA Command Cancels the performance data file established with the last SET DATAFILE command. Format CANCEL DATAFILE 3 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. 2 DISPLAY PCA Command Deletes the specified screen displays. Format CANCEL DISPLAY [display-name [,display-name...]] 3 Parameters display-name Specifies a screen display to be canceled. If you specify a display-name, do not use the /ALL qualifier. 3 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. 3 Qualifiers /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. 3 Examples PCAA> CANCEL DISPLAY FOO This command removes the screen display named FOO. 2 EVENT Collector Command Cancels the collection of event markers established with previous SET EVENT commands. Format CANCEL EVENT [event-name [nodespec [,nodespec...]]] 3 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. 3 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 /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. 3 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. 2 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...]] 3 Parameters filter-name Specifies an existing filter to cancel. The filter must have been created with an earlier SET FILTER command. 3 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. 3 Qualifiers /ALL Specifies that all currently defined filters be deleted. If you use the /ALL qualifier, omit the filter-name parameters. 3 Examples PCAC> CANCEL FILTER FOO, BAR This command cancels the previously set filters FOO and BAR. 2 IO_SERVICES Collector Command Disables the collection of I/O services data. Format CANCEL IO_SERVICES 3 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. 2 LOG PCA Command Disables the recording of PCA input and output in a log file. Format CANCEL LOG 3 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. 2 PAGE_FAULTS Collector Command Disables the collection of page fault data. Format CANCEL PAGE_FAULTS 3 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. 2 PC_SAMPLING Collector Command Disables the collection of program counter sampling data. Format CANCEL PC_SAMPLING 3 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. 2 PLOT Analyzer Command Resets the SET PLOT defaults to their initial values. Format CANCEL PLOT 3 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. 2 SERVICES Collector Command Disables the collection of system services data. Format CANCEL SERVICES 3 Description The CANCEL SERVICES Collector command disables the collection of system services data. It thus cancels the effect of an earlier SET SERVICES command. 2 SOURCE PCA Command Cancels the current source file directory search list established with a previous SET SOURCE command. Format CANCEL SOURCE 3 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. 3 Qualifiers /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. /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. 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. 2 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 3 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. 2 TASKING Collector Command Disables the collection of tasking data. Format CANCEL TASKING 3 Description The CANCEL TASKING command disables the collection of tasking data established with any previously issued SET TASKING command. 2 TITLE Analyzer Command Cancels the title text for histograms and tables established with a previous SET TITLE command. Format CANCEL TITLE 3 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 2 UNALIGNED Collector Command Disables the collection of unaligned access fault data. Format CANCEL UNALIGNED 3 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. 2 VCOUNTERS Collector Command Cancels the collection of vector instruction counts at specified program locations. Format CANCEL VCOUNTERS [nodespec [, nodespec...]] 3 Parameters nodespec Specifies a node specification to be canceled. This node specification must have been established with the SET VCOUNTERS command. 3 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. 3 Qualifiers /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. 3 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. 2 VCPU_SAMPLING Collector Command Disables the collection of vector CPU sampling data. Format CANCEL VCPU_SAMPLING 3 Description The CANCEL VCPU_SAMPLING Collector command disables the collection of vector CPU sampling data established with an earlier SET VCPU_SAMPLING command. 2 VERIFY PCA Command Disables the echoing of command input to the terminal. Format CANCEL VERIFY 3 Description The CANCEL VERIFY command disables the echoing of command input to the terminal. It cancels the effect of an earlier SET VERIFY command. 2 VPC_SAMPLING Collector Command Disables the collection of vector PC sampling data. Format CANCEL VPC_SAMPLING 3 Description The CANCEL VPC_SAMPLING Collector command disables the collection of vector PC sampling data established with an earlier SET VPC_ SAMPLING command. 2 WINDOW PCA Command Deletes a screen window definition. Format CANCEL WINDOW [window-name [,window-name...]] 3 Parameters window-name Specifies the name of a screen window definition to be canceled. 3 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. 3 Qualifiers /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. 3 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.