1 SHOW PCA Command Displays various definitions, data collection options and mode settings, depending on the keyword specified on the command. Format SHOW keyword [parameters] 2 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. 2 ALL PCA Command Displays a summary of all data collection options and all major Collector and Analyzer mode settings. Format SHOW ALL 3 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 Qualifiers /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 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. 2 ANC Analyzer Command Displays all the coverage-set points currently set as ANC. Format SHOW ANC 2 COUNTERS Collector Command Displays the node specifications for which exact execution counters have been established with earlier SET COUNTERS commands. Format SHOW COUNTERS 3 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. 2 COVERAGE Collector Command Displays the current settings for the SET COVERAGE command. Format SHOW COVERAGE 3 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. 2 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 3 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. 2 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 3 Qualifiers /FULL Gives more detailed information from the performance data file header. 3 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. 2 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 3 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. 2 EDITOR Analyzer Command Displays the current setting of the editor. Also displays the current command line. Format SHOW EDITOR 3 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. 2 EVENT Collector Command Displays the event names and the associated program locations established with previous SET EVENT commands. Format SHOW EVENT 3 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. 2 FILTER Analyzer Command Displays all current filter definitions. Format SHOW FILTER 3 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. 3 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. 2 IO_SERVICES Collector Command Displays whether the collection of I/O services data is enabled. Format SHOW IO_SERVICES 3 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. 2 KEY PCA Command Displays predefined key definitions or key definitions created with the DEFINE/KEY command. Format SHOW KEY [key-name] 3 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. 3 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. 3 Qualifiers /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. /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. /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. /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. /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. 3 Examples PCAC> SHOW KEY KP2 DEFAULT keypad definitions: KP2 = "SHOW ALL/FULL" This command displays the DEFAULT definition for key KP2. 2 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 3 Examples PCAC> SHOW LANGUAGE Language: FORTRAN This command shows that FORTRAN is the currently set language. 2 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 3 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. 2 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 3 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. 2 MODE PCA Command Displays whether keypad mode is enabled. Keypad mode is enabled or disabled with the SET MODE command. Format SHOW MODE 3 Examples PCAC> SHOW MODE Mode: noscreen, keypad, scroll, nomovie, nolog_screen This command shows that keypad mode is enabled. 2 NOTE Collector Command Displays the note defined for the current collection run. Format SHOW NOTE 3 Description The SHOW NOTE command allows you to retrieve the note defined for the current collection run from the PCA data file. 3 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. 2 PAGE_FAULTS Collector Command Displays whether the collection of page fault data is enabled. Format SHOW PAGE_FAULTS 3 Examples PCAC> SHOW PAGE_FAULTS Gathering page fault data The SHOW PAGE_FAULTS command shows that page fault data is collected. 2 PC_SAMPLING Collector Command Displays whether the collection of program counter sampling data is enabled. Format SHOW PC_SAMPLING 3 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. 2 PLOT Analyzer Command Displays the current SET PLOT and active plot default qualifiers and node specifications. Format SHOW PLOT 3 Description The SHOW PLOT command shows both the SET PLOT and the current active plot defaults. 3 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. 2 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 3 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. 3 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. 2 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 3 Examples PCAC> SHOW RUN_NAME Current run name = "STEVE" This command shows that the name of the current collection run is STEVE. 2 SEARCH PCA Command Displays the current default SEARCH qualifiers. Format SHOW SEARCH 3 Examples PCAC> SET SEARCH ALL, STRING PCAC> SHOW SEARCH Default search qualifiers: /ALL /STRING This command shows the current default SEARCH command qualifiers. 2 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 3 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. 2 SERVICES Collector Command Displays whether the collection of system services data is enabled. Format SHOW SERVICES 3 Examples PCAC> SHOW SERVICES Gathering system service data with STACK_PCS The SHOW SERVICES command shows that system services data is collected. 2 SOURCE Collector Command Displays the current source directory search lists established with the SET SOURCE command. Format SHOW SOURCE 3 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. 3 Qualifiers /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. 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. 2 STACK_PCS Collector Command Displays whether the collection of stack PC values (return addresses from the call stack) is enabled. Format SHOW STACK_PCS 3 Examples PCAC> SHOW STACK_PCS Not gathering stack PC data This command shows that stack PC values are not collected. 2 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 ...]] 3 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. 3 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. 3 Qualifiers /ADDRESS Displays the address specification for each selected symbol, when applicable. /DEFINED Displays symbol definitions established with the DEFINE/COMMAND command. /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. 3 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. 2 TASKING Collector Command Displays the status of the tasking measurement set with the SET TASKING command. Format SHOW TASKING 2 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 3 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. 2 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 3 Examples PCAA> SHOW TITLE Current title text: "Welcome to Wonderland" "Enjoy your visit" This command displays the text of the current two-line title. 2 UNALIGNED Collector Command Displays whether the collection of unaligned access fault data is enabled. Format SHOW UNALIGNED 3 Examples PCAC> SHOW UNALIGNED Gathering unaligned access data with STACK_PCS The SHOW UNALIGNED command shows that unaligned access fault data is collected. 2 VCOUNTERS Collector Command Displays the node specifications for which vector instruction counters have been established with earlier SET VCOUNTERS commands. Format SHOW VCOUNTERS 3 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. 2 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 3 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. 2 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 3 Examples PCAC> SHOW VERIFY Not verifying commands The SHOW VERIFY command shows that command input verification is disabled. 2 VPC_SAMPLING Collector Command Displays whether a collection of vector program counter sampling data is enabled. Format SHOW VPC_SAMPLING 3 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. 2 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 3 Qualifiers /ALL Displays all PCA-defined and user-defined windows.