PCA$HELP.HLB  —  LIST
    Analyzer Command

    Displays raw performance or coverage data. Also displays other
    information stored in the performance data file.

    Format

      LIST  data-kind [,data-kind...]

1  –  Parameters

 data-kind

    Specifies a kind of performance or coverage data. All records in
    the performance data file that contain the specified kind of data
    are listed. The valid data-kind parameters follow:

    Keyword            Description

    ALL                Lists all data records
    BEGIN_END          Lists collection run begin and end records
    COUNTERS           Lists execution counter records
    COVERAGE           Lists test coverage records
    CPU_SAMPLING       Lists CPU sampling records
    EVENTS             List event marker records
    IO_SERVICES        Lists I/O system service call records
    PAGE_FAULTS        Lists page fault records
    PC_SAMPLING        Lists program counter sampling records
    RUN_DESCRIPTION    Lists collection run description records
    SERVICES           Lists system service call records
    SHAREABLE_IMAGES   Lists all shareable image name and address
                       range records
    TASKING            Lists tasking records
    TASK_SWITCH        Lists task switch records
    UNALIGNED          Lists unaligned records
    VCOUNTERS          Lists vector instruction counter records
    VCPU_SAMPLING      Lists CPU sampling records for code containing
                       vector instructions
    VPC_SAMPLING       Lists program counter sampling records for
                       code containing vector instructions

2  –  Description

    The LIST command displays information stored in the performance
    data file. If you specify data-kind parameters, it displays all
    corresponding performance or coverage data records from the
    file. Thus, you can inspect the raw performance or coverage
    data gathered by the Collector. If you specify the appropriate
    qualifiers, the LIST command displays other information stored in
    the performance data file (see qualifier list). You must always
    request at least one kind of information from the LIST command.

    The output of the LIST command is often extensive. You can stop
    the LIST output by entering CTRL/C.

    The LIST output can be sent to the printer with the PRINT command
    or written to a file with the FILE command. If you write the
    LIST output to a file, you can use it as input to your own data
    reduction programs.

3  –  Qualifiers

3.1    /CODEPATHS

    Lists the names of all modules for which codepath data was
    gathered.

3.2    /COVERAGE_SET

    Lists the contents of the coverage-set table.

3.3    /CPT

    Lists the contents of the codepath table.

3.4    /DMT

    Lists the contents of the DMT.

3.5    /DST

    Lists the contents of the DST.

3.6    /EVENT_NAMES

    Lists all event marker names recorded in the data file.

3.7    /FILE_NAMES

    Lists the names of all files opened or created by the user
    program.

3.8    /GST

    Lists the contents of the GST.

3.9    /HEADER

    Lists the performance data file header.

3.10    /HEXADECIMAL

    Lists all performance data records in hexadecimal form in
    addition to the normal text form.

3.11    /IMAGE

    Lists information about the user program's executable image file.

3.12    /LOST_DATA

       /LOST_DATA=[keyword]

    Controls the output of lost data indications and the displaying
    of lost data records.

    The default qualifier is /LOST_DATA=ALL.

    Qualifier
    Keyword    Description

    ALL        Outputs any lost data indications and displays any lost
               data records.
    NONE       Does not output any lost data indications or display
               any lost data records.
    PCA        Outputs lost data indications and displays lost data
               records which were caused by PCA.
    USER       Outputs lost data indications and displays lost data
               records which were caused by the user.

3.13    /NOLOST_DATA

       /NOLOST_DATA

    Does not output any lost data indications or display any lost
    data records.

    This is the default LIST qualifier.

3.14    /MODULE_NAMES

    Lists the names of all the modules in the image for which the
    data was collected.

3.15    /SEQUENCE_NUMBERS

       /SEQUENCE_NUMBERS

    Outputs sequence numbers when listing performance data records.

3.16    /NOSEQUENCE_NUMBERS

       /NOSEQUENCE_NUMBERS

    Does not output sequence numbers when listing performance data
    records.

    This is the default LIST qualifier.

3.17    /SHAREABLE_IMAGE

    Lists the names of all shareable images used by the user program
    or by the Collector.

3.18    /START_TIME

       /START_TIME

    Outputs CPU start and end times when listing system service
    records.

3.19    /NOSTART_TIME

       /NOSTART_TIME

    Output only the CPU end time when listing system service records.

    This is the default LIST qualifier.

3.20    /TASK_NAME

    Lists the task name section.

3.21    /TASK_TYPE

    Lists the task type section.

4  –  Examples

  PCAA> LIST ALL

      This command lists all performance or coverage data records in
      the data file.

  PCAA> LIST IO_SERVICE, PAGE_FAULTS

      This command lists only I/O services and page fault data
      records from the data file.

  PCAA> LIST/HEADER

      This command lists the header of the performance data file.

  PCAA> LIST VCOUNTERS

      This command lists the execution counter records for vector
      instructions in the data file.
Close Help