PCA$HELP.HLB  —  Shareable Images
    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.
Close Help