There are two classes of shareable images; those that are user
written, and those that are provided. The Analyzer can report
symbolically only on user written shareable images.
Before you can collect data, you must build a shareable image
on which to collect that data. Next, you must link an executable
image that uses that shareable image. The following steps are
necessary:
1. Compile your sources with the "/DEBUG" qualifier;
This puts all the necessary symbolic information PCA needs
into the object file.
2. Link your shareable image program with the "/SHAREABLE/DEBUG"
qualifiers;
This creates a version of the shareable image that contains
the DST information that PCA needs.
3. The following steps specifies the PCA Collector as your
program's "debugger":
i Link your program with the "/DEBUG" qualifier;
ii Define the logical name LIB$DEBUG as PCA$COLLECTOR;
4. Run your program;
5. Enter the "SET DATAFILE/SHAREABLE=img-name" command at the
PCAC> prompt.
This command specifies the shareable image to be measured.
Specify your remaining data collection commands.
Enter the "GO" command at the PCAC> prompt.
The Collector will transfer control to your program just like
the debugger does, and will store the data in a data file
named your-image-name.PCA.
The /APPEND qualifier may be used to collect data from several
program executions into one data file, even if the executions
are of different programs. However, you must always measure the
same shareable image. Thus, you may measure the performance of
one shareable image averaged over many executions of different
programs.