PCA Command
Displays various definitions, data collection options and mode
settings, depending on the keyword specified on the command.
Format
SHOW keyword [parameters]
1 – Parameters
keyword
Specifies the data collection option or the kind of definition
or mode setting to display. Valid keywords in the Collector are:
ALL, COUNTERS, COVERAGE, CPU_SAMPLING, DATAFILE, DISPLAY, EVENT,
IO_SERVICES, LANGUAGE, LOG, MAX_SOURCE_FILES, MODE, NOTE, PAGE_
FAULTS, PC_SAMPLING, RUN_NAME, SEARCH, SELECT, SERVICES, SOURCE,
STACK_PCS, SYMBOL, TASKING, TERMINAL, UNALIGNED, VCOUNTERS, VCPU_
SAMPLING, VERIFY, VPC_SAMPLING and WINDOW.
In the Analyzer, valid keywords are: ALL, ANC, DATAFILE, DISPLAY,
EDITOR, FILTER, KEY, LANGUAGE, LOG, MAX_SOURCE_FILES, MODE, PLOT,
RUN_DESCRIPTION, SEARCH, SELECT, SOURCE, SYMBOL, TERMINAL, TITLE,
VERIFY, and WINDOW.
parameters
Depends on the keyword specified.
2 – Description
SHOW is not an individual command. Each SHOW command has a two-
keyword name consisting of SHOW followed by a required keyword.
For details, see the individual SHOW command descriptions.
3 – ALL
PCA Command
Displays a summary of all data collection options and all major
Collector and Analyzer mode settings.
Format
SHOW ALL
3.1 – Description
The SHOW ALL command displays all data collection options,
definitions and mode settings you have established. It also
displays the name of the log file, the name of the performance
data file, and information on all major mode settings. Entering
SHOW ALL is the same as entering a number of more detailed SHOW
commands.
3.2 – Qualifiers
3.2.1 /FULL
Gives more complete status information than the unqualified
SHOW ALL command. If you specify the /FULL qualifier, you
see the status of all data collection options, even those not
established, and all mode settings. You also see full data file
information. If you omit the /FULL qualifier, you see only the
data collection options that are established and only a subset of
the remaining status information.
3.3 – Examples
PCAC> SHOW ALL
Output logging on file: DEV$:[STAR]SHOW.LOG;1
Language: BLISS
Performance Data File: DBGD$:[STAR]PRIMES.PCA;1
Counters
Set Counters PROGRAM_ADDRESS BY ROUTINE
Set Counters LINE PRIMES\OPENIN\%LINE 22
Gathering I/O service data
Gathering system service data
Default SEARCH qualifiers: /NEXT /STRING
This command displays the name of the log file, the current
language setting, the name of the performance data file, and
all data collections options.
4 – ANC
Analyzer Command
Displays all the coverage-set points currently set as ANC.
Format
SHOW ANC
5 – COUNTERS
Collector Command
Displays the node specifications for which exact execution
counters have been established with earlier SET COUNTERS
commands.
Format
SHOW COUNTERS
5.1 – Examples
PCAC> SHOW COUNTERS
Counters
Set Counters PROGRAM_ADDRESS BY ROUTINE
Set Counters LINE PRIMES\OPENIN\%LINE 22
The SHOW COUNTERS command shows that exact execution counts are
collected for every routine in the user program and for line 22
of routine OPENIN in module PRIMES.
6 – COVERAGE
Collector Command
Displays the current settings for the SET COVERAGE command.
Format
SHOW COVERAGE
6.1 – Examples
PCAC> SHOW COVERAGE
Coverages
Set Coverage /Until=1 /Previous PROGRAM_ADDRESS BY CODEPATH
This SHOW COVERAGE command shows that test coverage is
measured for every codepath in the user program. Each coverage
breakpoint is removed the first time it is executed.
7 – CPU_SAMPLING
Collector Command
Displays whether the collection of program counter sampling data
that occurs during a process's CPU time is enabled.
Format
SHOW CPU_SAMPLING
7.1 – Examples
PCAC> SHOW CPU_SAMPLING
Gathering CPU sampling data with STACK_
PCS, AST Timer Interval is 10 ms.
The SHOW CPU_SAMPLING command shows that CPU sampling data
is collected with stack PCs, that the sampling interval
is 10 milliseconds, and that the AST Timer Interval is 10
milliseconds.
8 – DATAFILE
PCA Command
Displays the name of the current performance data file.
Optionally, other information about the data file is also
displayed.
Format
SHOW DATAFILE
8.1 – Qualifiers
8.1.1 /FULL
Gives more detailed information from the performance data file
header.
8.2 – Examples
PCAC> SHOW DATAFILE
Performance Data File: DEV$:[PCA.TST]CUMU_MAIN_IO.PCA;1
The SHOW DATAFILE command displays the name of the current
performance data file.
PCAC> SHOW DATAFILE/FULL
Performance Data File: DEV$:[PCA.TST]CUMU_MAIN_IO.PCA;1
Created by: PCA V1.0 Last updated by: PCA V1.0
Created on:25-MAR-1985 15:51:19.07 Last updated on:25-MAR-1985 15:51:30.62
Image file: DEV$:[SAGER.TST]PCAPRIME.EXE;19
Image name: PCAPRIME Image ID: 01
Image linked on: 8-MAR-1985 13:57:53.14 by Linker: 04-00
There is 1 collection run
The DST is 481 bytes long
Known shareable images:
FORRTL LIBRTL PCA$COLLECTOR DBGSSISHR
PCA$PRVSHR LBRSHR SMGSHR
The /FULL qualifier gives more complete information about the
data file.
9 – DISPLAY
PCA Command
Lists all screen display definitions. The name, screen window,
maximum size, and kind of each defined display are listed. Screen
displays are created using the SET DISPLAY command.
Format
SHOW DISPLAY
9.1 – Examples
PCAA> SHOW DISPLAY
display SRC at Q123, size = 64, removed, dynamic, kind = SOURCE
display PLOT at Q123, size = 64, dynamic, kind = PLOT
display OUT at E7, size = 100, dynamic, kind = OUTPUT
display PROMPT at E8, size = 64, dynamic, kind = PROGRAM
This command displays the definitions of the default screen
displays SRC, PLOT, OUT and PROMPT.
10 – EDITOR
Analyzer Command
Displays the current setting of the editor. Also displays the
current command line.
Format
SHOW EDITOR
10.1 – Examples
PCAA> SHOW EDITOR
The editor is CALLABLE_TPU having the command line:
"TPU"
This command displays the setting of the editor and its command
line.
11 – EVENT
Collector Command
Displays the event names and the associated program locations
established with previous SET EVENT commands.
Format
SHOW EVENT
11.1 – Examples
PCAC> SHOW EVENT
Events
Set Event COMPUTE PRIMES\OPENIN\%LINE 22
This command shows that an event marker for event COMPUTE is
recorded in the performance data file each time line 22 in
routine OPENIN is executed.
12 – FILTER
Analyzer Command
Displays all current filter definitions.
Format
SHOW FILTER
12.1 – Description
The SHOW FILTER command lists the name and filter restrictions
for each defined filter. Filters determine which data points from
the performance data file are tallied by the PLOT and TABULATE
commands. You can create filters with the SET FILTER command and
delete them with the CANCEL FILTER command.
12.2 – Examples
PCAA> SHOW FILTER
Filter definitions:
Filter F1:
RUN_NAME = 1:3
RUN_NAME = 8
Filter F2:
TIME = OUTPUT (event marker)
The SHOW FILTER command shows that two filters are defined.
Filter F1 has two run-name restrictions and filter F2 has an
event marker restriction.
13 – IO_SERVICES
Collector Command
Displays whether the collection of I/O services data is enabled.
Format
SHOW IO_SERVICES
13.1 – Examples
PCAC> SHOW IO_SERVICES
Gathering I/O service data with STACK_PCS
The SHOW IO_SERVICES command shows that I/O services data is
collected.
14 – KEY
PCA Command
Displays predefined key definitions or key definitions created
with the DEFINE/KEY command.
Format
SHOW KEY [key-name]
14.1 – Parameters
key-name
Specifies the name of the key whose definition you want
displayed. See the DEFINE/KEY command for a list of the valid
key names.
14.2 – Description
The SHOW KEY command displays your current key definitions. After
you have defined keypad keys using the DEFINE/KEY command, you
can use the SHOW KEY command to list your key definitions. You
can use the /DIRECTORY qualifier to list the names of all states
(DEFAULT, GOLD, BLUE, EXPAND, MOVE and CONTRACT) in which there
are key definitions.
14.3 – Qualifiers
14.3.1 /ALL
Specifies that all key definitions in the current state be
displayed. You can use the /STATE qualifier to request key
definitions in other states. If you use the /ALL qualifier, do
not specify a key name.
14.3.2 /BRIEF
/BRIEF
/NOBRIEF
The /BRIEF qualifier requests that only the key definition
and state be displayed. /NOBRIEF requests that all qualifiers
associated with a key definition be displayed. The /BRIEF
qualifier performs the same function as the /NOFULL qualifier.
/BRIEF is the default.
14.3.3 /DIRECTORY
Specifies that the names of all states for which keys have been
defined be displayed. The predefined key states are DEFAULT,
GOLD, BLUE, EXPAND, MOVE and CONTRACT.
14.3.4 /FULL
/FULL
/NOFULL
The /FULL qualifier requests that all qualifiers associated with
a key definition be displayed. The /NOFULL qualifier requests
that only the key definition and state be displayed. The /FULL
qualifier performs the same function as the /NOBRIEF qualifier.
/NOFULL is the default.
14.3.5 /STATE
/STATE=(state-name[,...])
/NOSTATE
Specifies the name of a state for which the specified key
definitions are to be displayed. If you specify only one state
name, you can omit the parentheses. The predefined state names
are DEFAULT, GOLD, BLUE, EXPAND, MOVE and CONTRACT. Additional
state names are created with the DEFINE/KEY command.
If you omit the /STATE qualifier or use /NOSTATE, key definitions
in the current state are displayed.
14.4 – Examples
PCAC> SHOW KEY KP2
DEFAULT keypad definitions:
KP2 = "SHOW ALL/FULL"
This command displays the DEFAULT definition for key KP2.
15 – LANGUAGE
PCA Command
Displays the current language setting. The language setting
determines how symbol names are parsed. The language setting
is initially determined from the language of the main routine in
the user program. You change it with the SET LANGUAGE command.
Format
SHOW LANGUAGE
15.1 – Examples
PCAC> SHOW LANGUAGE
Language: FORTRAN
This command shows that FORTRAN is the currently set language.
16 – LOG
PCA Command
Shows whether PCA input and output is being recorded in a
log file. If logging is enabled, the name of the log file is
displayed. Logging is enabled with the SET LOG command.
Format
SHOW LOG
16.1 – Examples
PCAC> SHOW LOG
Output logging on file: USRD$:[CARRELL]PCAC.LOG;1
This command shows that output logging is enabled and gives the
name of the log file.
17 – MAX_SOURCE_FILES
PCA Command
Displays the maximum number of source files that PCA can keep
open at any one time. This value can be changed with the SET MAX_
SOURCE_FILES command.
Format
SHOW MAX_SOURCE_FILES
17.1 – Examples
PCAA> SHOW MAX_SOURCE_FILES
Max_source_files: 10
This command shows that PCA can keep up to ten I/O channels
open for source files at one time.
18 – MODE
PCA Command
Displays whether keypad mode is enabled. Keypad mode is enabled
or disabled with the SET MODE command.
Format
SHOW MODE
18.1 – Examples
PCAC> SHOW MODE
Mode: noscreen, keypad, scroll, nomovie, nolog_screen
This command shows that keypad mode is enabled.
19 – NOTE
Collector Command
Displays the note defined for the current collection run.
Format
SHOW NOTE
19.1 – Description
The SHOW NOTE command allows you to retrieve the note defined for
the current collection run from the PCA data file.
19.2 – Examples
PCAC> SET NOTE "G_FLAT"
PCAC> SHOW NOTE
Run note: "G-FLAT"
Thess command set and then display the note for the current
collection run.
20 – PAGE_FAULTS
Collector Command
Displays whether the collection of page fault data is enabled.
Format
SHOW PAGE_FAULTS
20.1 – Examples
PCAC> SHOW PAGE_FAULTS
Gathering page fault data
The SHOW PAGE_FAULTS command shows that page fault data is
collected.
21 – PC_SAMPLING
Collector Command
Displays whether the collection of program counter sampling data
is enabled.
Format
SHOW PC_SAMPLING
21.1 – Examples
PCAC> SHOW PC_SAMPLING
Gathering PC sampling data with STACK_
PCS, AST Timer Interval is 10 ms.
The SHOW PC_SAMPLING command shows that program counter
sampling data is collected with stack PC values, that the
sampling interval is 10 milliseconds, and that the AST Timer
Interval is 10 milliseconds.
22 – PLOT
Analyzer Command
Displays the current SET PLOT and active plot default qualifiers
and node specifications.
Format
SHOW PLOT
22.1 – Description
The SHOW PLOT command shows both the SET PLOT and the current
active plot defaults.
22.2 – Examples
PCAA> SHOW PLOT
Plot and tabulate defaults:
Qualifiers:
/PC_SAMPLING /DESCENDING /NOMINIMUM /NOMAXIMUM
/NOCUMULATIVE /SOURCE /ZEROS /NOSCALE /NOCREATOR_PC
/NOPATHNAME /NOCHAIN_NAME /WRAP /NOPARENT_TASK
/FILL=("*","O","x","@",":","#","/","+")
/NOSTACK_DEPTH /NOMAIN_IMAGE
Node specifications:
PROGRAM_ADDRESS BY ROUTINE
Setting for current plot:
Qualifiers:
/PC_SAMPLING /DESCENDING /NOMINIMUM /NOMAXIMUM
/NOCUMULATIVE /SOURCE /ZEROS /NOSCALE /NOCREATOR_PC
/NOPATHNAME /NOCHAIN_NAME /WRAP /NOPARENT_TASK
/FILL=("*","O","x","@",":","#","/","+")
/NOSTACK_DEPTH /NOMAIN_IMAGE
Node specifications:
TIME BY EVENT
The SHOW PLOT command displays the SET PLOT defaults first. The
qualifiers and node specifications of the currently active plot
are shown next.
23 – RUN_DESCRIPTION
Analyzer Command
Displays the kinds of data that were collected for each
collection run in the performance data file. This information
constitutes a condensed version of what the SHOW ALL command
would have shown you in the original Collector sessions.
Format
SHOW RUN_DESCRIPTION parameter
23.1 – Parameters
run-name
Specifies a collection run name. The run description for any
run whose run name matches the run-name parameter is displayed.
If run-name includes asterisks (*), each asterisk is treated as
a wildcard character that matches any zero or more characters.
If run-name is not an alphanumeric name, or if it begins with a
digit, it must be enclosed in quotation marks.
run-number
Specifies a collection run number. The run description for any
collection run in the specified range is displayed.
23.2 – Examples
PCAA> SHOW RUN_DESCRIPTION 2:3
Collection number 2. Named - "FOO"
Events
Set Event MARK_ROUTINE PRIMEPRIME
Gathered PC sampling data, AST Timer Interval is 10 ms.
Collection number 3. Named - "COVERAGE"
Coverages
Set Coverage /Until=1 PROGRAM_ADDRESS BY ROUTINE
This command describes what data was gathered in collection
runs 2 through 3. Run 2 gathered program counter sampling data
and used an event marker. Run 3 gathered test coverage data.
PCAA> SHOW RUN_DESCRIPTION *
Collection number 1. Named - ""
Counters
Set Counters PROGRAM_ADDRESS BY ROUTINE
Gathered I/O service data
Gathering stack PC data
Collection number 2. Named - "event_marker"
Gathered PC sampling data, AST Timer Interval is 10 ms.
Collection number 3. Named - "COVERAGE"
Coverages
Set Coverage /Until=1 PROGRAM_ADDRESS BY ROUTINE
This command describes all collection runs. The asterisk is a
wildcard character and matches all run names.
24 – RUN_NAME
Collector Command
Displays the current collection run name. The run name is
established with the SET RUN_NAME command.
Format
SHOW RUN_NAME
24.1 – Examples
PCAC> SHOW RUN_NAME
Current run name = "STEVE"
This command shows that the name of the current collection run
is STEVE.
25 – SEARCH
PCA Command
Displays the current default SEARCH qualifiers.
Format
SHOW SEARCH
25.1 – Examples
PCAC> SET SEARCH ALL, STRING
PCAC> SHOW SEARCH
Default search qualifiers: /ALL /STRING
This command shows the current default SEARCH command
qualifiers.
26 – SELECT
PCA Command
Displays the names of the current output, plot, source, and the
current scrolling display. These settings are established using
the SELECT command.
Format
SHOW SELECT
26.1 – Examples
PCAA> SHOW SELECT
screen mode not set
display selections:
scroll = PLOT
input = none
output = OUT
error = PROMPT
source = SRC
program = PROMPT
prompt = PROMPT
plot = PLOT
The SHOW SELECT command shows that screen display OUT is the
current output display, display PLOT is the current scrolling
display, and so on.
27 – SERVICES
Collector Command
Displays whether the collection of system services data is
enabled.
Format
SHOW SERVICES
27.1 – Examples
PCAC> SHOW SERVICES
Gathering system service data with STACK_PCS
The SHOW SERVICES command shows that system services data is
collected.
28 – SOURCE
Collector Command
Displays the current source directory search lists established
with the SET SOURCE command.
Format
SHOW SOURCE
28.1 – Description
The SHOW SOURCE command displays the current source directory
search lists. The source directory search list currently in
effect determines what directories are searched for source files
when source text must be displayed. The source directory search
list is established using the SET SOURCE command.
28.2 – Qualifiers
28.2.1 /EDIT
Shows the directory search list established by the last SET
SOURCE/EDIT command. If specified, this directory search list
is used in locating source files for the EDIT command.
28.3 – Examples
PCAC> SHOW SOURCE
source directory search list for PCAPRIME:
[BEANDER]
source directory list for all other modules:
[]
SRC$
This command shows that two source directory search lists are
defined: one for module PCAPRIME and one for all other modules.
29 – STACK_PCS
Collector Command
Displays whether the collection of stack PC values (return
addresses from the call stack) is enabled.
Format
SHOW STACK_PCS
29.1 – Examples
PCAC> SHOW STACK_PCS
Not gathering stack PC data
This command shows that stack PC values are not collected.
30 – SYMBOL
PCA Command
Displays information about symbols in the program address
domain, or symbol definitions established with the DEFINE/COMMAND
command.
Format
SHOW SYMBOL namespec[, namespec ...] [IN scope[, scope ...]]
30.1 – Parameters
namespec
Specifies the name of the symbol to show. If namespec includes
asterisks (*), each asterisk is treated as a wildcard character
that matches any zero or more characters. All symbols whose names
match namespec are shown.
scope
Specifies the name of a module, routine, or lexical block, and
may include pathname qualification.
30.2 – Description
The SHOW SYMBOL command lets you see symbols in the program
address domain, or symbols you have defined with the
DEFINE/COMMAND command.
You can use the /ADDRESS and /DIRECT qualifiers or the IN clause
only if /DEFINED is not specified. If you do not specify an
IN clause, then the whole program will be the scope for symbol
selection.
The /DEFINED qualifier can not be used in combination with any
other qualifiers to the SHOW SYMBOL command.
30.3 – Qualifiers
30.3.1 /ADDRESS
Displays the address specification for each selected symbol, when
applicable.
30.3.2 /DEFINED
Displays symbol definitions established with the DEFINE/COMMAND
command.
30.3.3 /DIRECT
Displays symbols that are defined directly in the symbol
selection scope. Symbols defined in lexical entities nested
within the scope specified by the scope parameters are not shown.
30.4 – Examples
PCAA> SHOW SYMBOL/DEFINED *
Defined commands:
P = "PLOT/NOZERO/DESCENDING"
BSGB = "SET FILTER FUM PROGRAM_ADDRESS=MUMBLE_FRATZ"
This SHOW SYMBOL command displays the definitions of all
symbols defined using DEFINE/COMMAND. Only two symbols, P and
BSGB, are defined. Their names and definitions are displayed.
PCAA> SHOW SYMBOL/ADDRESS SCALE
Module SCALE, language PASCAL
Address range: 00000200 to 00000297
Routine SCALE\SCALE
Address range: 00000200 to 0000020B
This SHOW SYMBOL command is used to display address ranges of
any program unit named SCALE.
31 – TASKING
Collector Command
Displays the status of the tasking measurement set with the SET
TASKING command.
Format
SHOW TASKING
32 – TERMINAL
PCA Command
Displays the terminal width and page size used by PCA when
formatting output. These settings can be changed using the SET
TERMINAL command.
Format
SHOW TERMINAL
32.1 – Examples
PCAA> SHOW TERMINAL
Terminal page size: 24, Terminal width: 80
This command shows that the Analyzer currently assumes a
terminal page size of 24 lines and a terminal width of 80
columns when formatting output.
33 – TITLE
Analyzer Command
Displays the current title text established with the last SET
TITLE command. This title text is output on top of every page of
PLOT and TABULATE output.
Format
SHOW TITLE
33.1 – Examples
PCAA> SHOW TITLE
Current title text:
"Welcome to Wonderland"
"Enjoy your visit"
This command displays the text of the current two-line title.
34 – UNALIGNED
Collector Command
Displays whether the collection of unaligned access fault data is
enabled.
Format
SHOW UNALIGNED
34.1 – Examples
PCAC> SHOW UNALIGNED
Gathering unaligned access data with STACK_PCS
The SHOW UNALIGNED command shows that unaligned access fault
data is collected.
35 – VCOUNTERS
Collector Command
Displays the node specifications for which vector instruction
counters have been established with earlier SET VCOUNTERS
commands.
Format
SHOW VCOUNTERS
35.1 – Examples
PCAC> SHOW VCOUNTERS
Set Vector Counters MODULE PRIMES BY VINSTRUCTION
The SHOW VCOUNTERS command shows what vector instruction counts
are collected for MODULE in the user program PRIMES.
36 – VCPU_SAMPLING
Collector Command
Displays whether a collection of vector program sampling data
that occurs during a process's CPU time is enabled.
Format
SHOW VCPU_SAMPLING
36.1 – Examples
PCAC> SHOW VCPU_SAMPLING
Gathering Vector CPU sampling data with STACK_PCS, AST Time
Interval is 10 ms.
This command shows that vector CPU sampling data is collected
with stack PCs, that the sampling interval is 10 milliseconds,
and that the AST Time Interval is 10 milliseconds.
37 – VERIFY
PCA Command
Displays whether command input is being echoed to the terminal.
Input verification is enabled with the SET VERIFY command.
Format
SHOW VERIFY
37.1 – Examples
PCAC> SHOW VERIFY
Not verifying commands
The SHOW VERIFY command shows that command input verification
is disabled.
38 – VPC_SAMPLING
Collector Command
Displays whether a collection of vector program counter sampling
data is enabled.
Format
SHOW VPC_SAMPLING
38.1 – Examples
PCAC> SHOW VPC_SAMPLING
Gathering vector PCA sampling data with /STACK_PCS, AST Timer
Interval is 10 ms.
This command shows that vector PC sampling data is collected
with stack PCs, that the sampling interval is 10 milliseconds,
and that the AST Timer Interval is 10 milliseconds.
39 – WINDOW
PCA Command
Displays the names and definitions of all defined screen windows.
Screen windows are either predefined or defined with the SET
WINDOW command.
Format
SHOW WINDOW
39.1 – Qualifiers
39.1.1 /ALL
Displays all PCA-defined and user-defined windows.