Module View (vtl)

This information applies to the command-line interface (vtl) only.

Modules are executable binary image files. The module view displays all the modules specified by ID or name of the processes that were running during the period of sampling. This is the default view.

To view module data from the command line, use the  -modules option.

Command-line example:

>vtl view a2::r1 -modules

where a2 - Activity name, r1 - Activity result name.

Use the information from the module view for the hotspot analysis. Modules that have been called frequently during sampling data collection are displayed as ones with the highest number of events or the most CPU time.

For event-based sampling, the module view displays the event totals (for each event) for every module that executed. Collected data are displayed in the table format:

Column Heading

Description

Modules

Modules for which data was collected.

Process

Names of the processes that called each module.

Event

Event name.

CPU

Logical CPU where the samples were collected.

Events

Total event count for each module. The event count is based on the number of samples collected for the module x Sample After value.

%Events

Per cent of all events counted in this CPU-process-module combination during the data collection.

For example, if 1000 Clockticks events were counted during the data collection and 100 of the Clockticks events were counted in the vtl module (cpu 0, vtl process), 10% of the Clockticks events will be attributed to the cpu0-vtl module-vtl process module.

<Event name> CPU<n> events

Number of events that occurred on each processor for every module.

<Event ratio name>

The dynamically calculated sample count for the event ratios. These values depend on the event counts for the selected events.

Samples

Samples collected in the CPU-process-module combination due to a specific event.

Process Path

Paths of the processes that called each module, during profiling.

Process ID

The system provides each process with an ID to distinguish it from the other.

Module Path

Paths of the modules during profiling.

Some of the performance issues you can identify from the module view are:

note

Process and module views can be dumped in the same command line.

Command-line example:

>vtl view -modules -processes