The main window of the Collector lets you:
1. Select an application to collect performance or
coverage information on
2. Ask a question relating to the category of
performance or coverage information you want to
collect
3. Start the collection process
For more information on the PCA Collector, see the
Guide to DIGITAL Performance and Coverage Analyzer for
OpenVMS Systems or topics from the Additional Topics
window below.
1 – uidgen HelpBox
The Help pull-down menu contains the following
information:
o On Context - provides a way to get access to
context-sensitive help.
o On Window - provides a brief description of the
Collector main window.
o On Help - describes how to get access to the
context-sensitive help.
o On Version - identifies the product name, version
number, and copyright information.
You can get help in two ways:
o To get help about Collector tasks, choose Overview
from the Help menu.
The Overview topic describes the application and
lists additional topics that explain how to do
common tasks when using the Collector. Double click
on an additional topic for more information.
o To get help about screen objects, such as data
types, dialog boxes, and buttons, press and hold
the HELP key while you click on the screen object in
which you're interested in getting help.
2 – uidgen MenuBar
The PCA Collector menu bar contains the following
menus:
o File - for creating a data file into which to store
performance or coverage data; to select an existing
data file into which the collected information is
to be be placed; to select a user-written sharable
image on which to collect performance or coverage
information; and to exit from the Collector.
o Options - for naming a specific collection run you
are performing; to setting collection ranges for
information; and for modifying the default sampling
rate for for any of the sampling timers.
o Help - for providing topical access to online help.
2.1 – File Cascade
Use the File pull-down menu to:
1. Create the data file in which the collected
information is to be placed.
2. Select an existing data file in which the collected
information is to be placed.
3. Select a user-written sharable image on which to
collect performance or coverage information.
4. Exit from the Collector.
2.1.1 – Create dfile Btn
Choose New Datafile... from the File pull-down menu to create a data file in which you want the performance or coverage information collected. You should create a new data file only for your first collection run on an application. If you have already done a collection run on a specific application, you should use Select Datafile... to append new collection information to an existing data file.
2.1.2 – Select dfile Btn
Choose Open Datafile... from the File pull-down menu to select an existing data file to which new performance or coverage information is to be appended. If you have already done a collection run on a specific application, you should use Open Datafile... to keep all your performance and coverage information on an application in one place.
2.1.3 – Select Image Btn
Choose Select Image... from the File pull-down menu to select a sharable image in which you want to collect performance or coverage information. Note that there are two kinds of sharable images: user-written, and provided. You can use PCA only with user-written sharable images.
2.1.4 – Exit Btn
Choose Exit from the File pull-down menu to terminate the current Collector session.
2.2 – Customize Cascade
The Options pull-down menu lets you control your run-
time environment with the following menu items:
o Collection Name... - to specify a name for a
particular collection run
o Counting Range... - to specify the parts of your
application on which you want to collect execution
count information
o Coverage Range... - to specify the parts of your
on which application you want to get coverage
information
o Interval... - to modify the default value sampling
rate for any of the sampling timers
2.2.1 – Set Coll Name Btn
Choose the Collection Name... menu item from the Options pull-down menu to associate a name and comment with a particular collection run.
2.2.2 – Set Count Btn
Choose the Counting Range... menu item from the Options pull-down menu to specify the parts of your application on which you want to obtain execution counts information.
2.2.3 – Set Cover Btn
Choose the Coverage Range... menu item from the Options pull-down menu to specify which parts of your application you want to obtain test coverage information on.
2.2.4 – Set Int Btn
Choose the Interval... menu item from the Options pull- down menu to modify the default value sampling rate for the elapsed time and process time sampling timers.
2.3 – Help Cascade
The Help menu contains the following entries:
o On Context - Converts the mouse pointer to a reverse
question mark, allowing you to obtain help on any
object you click on. When you click on an object,
PCA displays the DECwindows Help Widget, containing
help specific to the object you clicked on.
o On Help - Displays the DECwindows Help Widget,
containing a list of topics you can obtain help
on.
o On Window - Displays the DECwindows Help Widget,
containing a list of topics you can obtain help on.
o On Version - Displays the DECwindows Help Widget,
containing the version identifier of PCA software
you are running and a copyright notice.
2.3.1 – on context Btn
When you click on On Context, PCA provides a fast way to obtain context-sensitive help on any object you click on in the Collector window. Note that when you click on On Context, the arrow pointer converts to a reverse question mark, indicating you are in Context-Sensitive Help mode. To revert to regular mouse input mode, click on On Context again.
2.3.2 – on help Btn
To get help on using the Collector, you can use one of
two methods:
o Choose On Context from the Help menu. Then click on
any object in the Collector window on which you want
help.
o Press and hold MB1 on any object in the Collector
main window on which you want help, and press the
Help key on your keyboard.
2.3.3 – on window Btn
PCA collects performance information on your
application and lets you view that information
to observe the runtime characteristics of your
application, such as:
o What parts of your application are executed the most
o What parts of your application are compute-bound or
I/O-bound
o What areas of your application are, or are not,
executed by tests
o What the dynamic call relationships are among the
routines in your application
o Where page faults occur
o Where you use system services
With this information, PCA helps you pinpoint important
qualities of your application, such as the location
and nature of performance bottlenecks, or how effective
your test coverage is.
2.3.4 – on version Btn
************************************************** HP CONFIDENTIAL. This software is confidential proprietary software licensed by Hewlett-Packard Development Company, L.P., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of HP. © 2015 Copyright Hewlett-Packard Development Company, L.P. VMS SOFTWARE, INC. CONFIDENTIAL. This software is confidential proprietary software licensed by VMS Software, Inc., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of VMS Software, Inc. © 2015 Copyright VMS Software, Inc. ************************************************** For more information about the PCA Collector, double click on Overview of PCA from the additional topics below.
3 – work area PaneWin
The PCA Collector main window contains three main areas: o The menu bar, at the top o The main work area, in the middle o The query panel, at the bottom
3.1 – top Form
In the main work area, you can do the following: o Choose a query category from the Query Category menu o Choose a query in the query panel o Start the collection run
3.1.1 – appl Lab
This field shows the name of the application that has been linked with the PCA Collector.
3.1.2 – appl text Txt
This field shows the name of the application that has been linked with the PCA Collector.
3.1.3 – data Lab
This field shows the name of the data file into which the Collector stores performance or coverage information.
3.1.4 – data text Txt
This field shows the name of the data file into which the Collector stores performance or coverage information.
3.1.5 – collect Btn
After you have chosen a query from the query panel, click on Start Collection to begin the PCA information collection phase.
3.1.6 – category OptMenu
The Query Category pull-down menu lets you choose a
category of queries to display in the Collector query
pane. The available categories are:
o Process Execution Information - displays queries
relating to process execution information, such as
elapsed time, system time, and so on.
o Execution Counts - displays queries relating to
execution counts of lines, modules, routines, and
routine calls.
o Coverage - displays queries relating to codepath
coverage information.
o Dynamic Call Information - displays queries relating
to call tree structure and calling relationships.
o I/O Usage - displays queries relating to I/O
activity.
o System Service Usage - displays queries relating to
system service usage.
o Page Faults - displays queries relating to page
fault information.
o ADA Usage - displays queries relating to ADA tasking
information.
3.1.6.1 – proc query Btn
The Process Execution query category contains queries
that relate to the following areas of performance
analysis:
o Elapsed time - where your application spends the
most time, as measured against total elapsed time.
o Process time - where your applications spends the
most process, or CPU, time.
o Routine calls-which routines get executed the most.
3.1.6.2 – count query Btn
The Execution Counts query category contains queries that relate to collecting the following: o Lines executed the most o Routines executed the most o Modules executed the most
3.1.6.3 – io query Btn
The I/O Usage query categoey contains queries that relate to collecting the following information on your application: o Where I/O is being done o What I/O system services are being used o Where I/O reads or writes are being used o Number of I/O read or write counts o Where I/O reads and writes are used o Files involved in I/O o Record sizes
3.1.6.4 – cov query Btn
The Coverage query category contains queries that
relate to collecting the following information that
results from executing tests:
o What percentage of the application was covered by
the tests
o Where the application is and is not covered by the
tests
o Where the application is acceptably not covered
(ANC)
3.1.6.5 – call query Btn
The Dynamic Call Information query category contains queries that relate to collecting the following information: o Your program's call tree structure o What routines call what other routines o Which routines make the most calls
3.1.6.6 – sysser query Btn
The System Service Usage query category contains queries that relate to finding: o Where system services are used o What system services are used
3.1.6.7 – page query Btn
The Page Faults query category contains queries that relate to showing: o Where page faults are occurring o What addresses are causing page faults
3.1.6.8 – ada query Btn
The Ada Usage query category contains queries that relate to finding: o What tasks are performing context switching o What Ada tasking names are used o What Ada tasking types used o What Ada task priorities are used
3.2 – query Form
The main query window displays the queries associated with the query category you have chosen. If there are more queries than can be displayed in one view, a scroll bar appears in the right margin, allowing you to scroll through the entire list of queries. Click on the appropriate query for the current collection run, and click on Start Collection to begin the PCA collection phase.
3.2.1 – query ScrWind
The Query Scroll Window displays the queries contained in the current query category. If not all the queries of the current category can fit in the window, a vertical scroll bar is displayed in the right margin, which allows you to scroll through the entire list of queries.
3.2.1.1 – scroll Form
The query panel displays the queries in the current query category.
3.2.1.1.1 – proc query Form
Click on one of the queries contained in the Process Execution query category radio box. You can use the vertical scroll bar in the right margin of this radio box to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.1.1 – elapsed time Tgl
Click on this button to collect information on where in your application the most elapsed time is spent.
3.2.1.1.1.2 – process time Tgl
Click on this button to collect information on where in your application that most process, or CPU, time is spent.
3.2.1.1.1.3 – prtn calls Tgl
Click on this button to collect information on which routines are executed the most in your application.
3.2.1.1.1.4 – prtn callers Tgl
Click on this button to collect information identifying which routines make the most calls.
3.2.1.1.2 – count query Form
The query panel displays the queries from the Execution Counts query category.
3.2.1.1.2.1 – lines Tgl
Click on this button to collect information identifying which lines are executed the most.
3.2.1.1.2.2 – routines Tgl
Click on this button to collect information identifying which routines are executed the most.
3.2.1.1.2.3 – modules Tgl
Click on this button to collect information identifying which modules in your application are executed the most.
3.2.1.1.2.4 – rtn callers Tgl
Click on this button to collect information identifying which routines in your application make the most calls.
3.2.1.1.3 – io query Form
This panel contains the queries in the I/O Usage query category.
3.2.1.1.3.1 – io done Tgl
Click on this button to collect information on I/O operations being executed in your application.
3.2.1.1.3.2 – io serv Tgl
Click on this button to collect information on I/O system services being used in your application.
3.2.1.1.3.3 – io read Tgl
Click on this button to collect information identifying I/O reads being used in your application.
3.2.1.1.3.4 – io read num Tgl
Click on this button to collect information identifying the total number of I/O read operations being performed in your application.
3.2.1.1.3.5 – io write Tgl
Click on this button to collect information on the I/O write operations being performed in your application.
3.2.1.1.3.6 – io write num Tgl
Click on this button to collect information identifying the total number of I/O write operations being performed in your application.
3.2.1.1.3.7 – io phys Tgl
Click on this button to collect information on I/O read and write operations being performed in your application.
3.2.1.1.3.8 – io file Tgl
Click on this button to collect information on files involved in I/O operations in your application.
3.2.1.1.3.9 – io file vbn Tgl
Click on this button to collect information on what file virtual block numbers are being used in your application.
3.2.1.1.3.10 – io file key Tgl
Click on this button to collect information on file keys being used in your application.
3.2.1.1.3.11 – io rec siz Tgl
Click on this button to collect information on record sizes being used in your application.
3.2.1.1.4 – cov query Form
Click on one of the queries contained in the Coverage query category radio box. You can use the vertical scroll bar in the right margin of this radio box to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.4.1 – app cov Tgl
Click on this button to collect information on the percentage of your application being covered by tests.
3.2.1.1.4.2 – cover Tgl
Click on this button to collect information on what parts of your application are covered by tests.
3.2.1.1.4.3 – non cover Tgl
Click on this button to collect information identifying the parts of your application that are covered by tests.
3.2.1.1.4.4 – anc cover Tgl
Click on this button to collect information identifying the parts of your application that have been designated acceptably noncovered (ANC).
3.2.1.1.5 – call query Form
Click on one of the queries contained in the Dynamic Relationships query category panel. You can use the vertical scroll bar in the right margin of this radio box to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.5.1 – call show Tgl
Click on this button to collect information on the call tree structure of your application.
3.2.1.1.5.2 – call callees Tgl
Click on this button to collect information identifying the routines in your application that call other routines.
3.2.1.1.5.3 – call callers Tgl
Click on this button to collect information identifying the routines in your application that make the most calls.
3.2.1.1.6 – sysser query Form
Click on one of the queries contained in the System Services query category panel. You can use the vertical scroll bar in the right margin of the panel to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.6.1 – sysser where Tgl
Click on this button to collect information identifying where system services are being used in your application.
3.2.1.1.6.2 – sysser what Tgl
Click on this button to collect information identifying what system services are being used in your application.
3.2.1.1.7 – page query Form
Click on one of the queries contained in the Page Faults query category panel. You can use the vertical scroll bar in the right margin of this radio box to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.7.1 – page where Tgl
Click on this button to collect information identifying where page faults occur in your application.
3.2.1.1.7.2 – page address Tgl
Click on this button to collect information identifying the addresses in your application that cause page faults to occur.
3.2.1.1.8 – ada query Form
Click on one of the queries contained in the Ada query category panel. You can use the vertical scroll bar in the right margin of this radio box to scroll to queries appearing later in the list. You cannot click on more than one query at a time.
3.2.1.1.8.1 – ada where Tgl
Click on this button to collect information identifying what tasks in your application perform context switching.
3.2.1.1.8.2 – ada task Tgl
Click on this button to collect information identifying what Ada tasking names are used in your application.
3.2.1.1.8.3 – ada type Tgl
Click on this button to collect information identifying what Ada tasking types are used in your application.
3.2.1.1.8.4 – ada prior Tgl
Click on this button to collect information identifying what Ada task priorities are used in your application.
4 – sel data PopForm
Choose the directory and file specification of the data file you want to use by double-clicking, respectively, on the directory and file name you want. You can use the Filter box to limit the number of directories and files that are displayedin the Directories and Files windows, respectively. You can choose a data file by double-clicking on it, or by typing in the full specifications of the data file in the Selection box.
4.1 – sel data FilSelB
If you double click on data file in the Files window, the data file name appears in the Selection box. You can also type in the name of a data file in this box.
5 – create data PopForm
You can create a data file by entering a name into the Selection box at the bottom.
5.1 – create data FilSelB
You can create a data file by entering a name into the Selection box at the bottom.
6 – Warning Warn
You have generated an error with a severity level of Warning.