IBM Support

Packages & Perspectives

News


Abstract

The Performance Data Investigator packages group perspectives (charts and tables) for one collection or purpose.

Content

You are in: IBM i Technology Updates > Performance Tools > Performance on the web > Packages & Perspectives

Search on the main Investigate Data page from each column to find a perspective by database field, name, etc.

See also Functions & Enhancements  

If you have custom packages or perspectives, The way these files are shipped with PDI has changed.  See PML Packages for New Navigator.


Primary & Secondary Perspectives

Some charts are not available on the Investigate Data page.  They can only be displayed by selecting data from a primary perspective and then selecting a drilldown chart from the "Actions" button (found above the context panel).  These drilldown perspectives are referred to as secondary charts.

The primary perspectives display metrics (CPU, page faults, waits, etc) by a single category type (job or task, system, user profile, server type, etc).  Primary perspectives are typically named "[metric] by [category]".

Drilldown charts allow the user to select a specific category value to filter only those desired categories.  The secondary perspectives are typically the Perspectives with "for" in the name indicating they are a specific metric (CPU, Page Fault, Waits) for a specific subset (job or task, thread or task, pool, user profile, disk, subsystem, server type, job priority) with the format "[metric] for [category]" or "[metric] for one [category]".  This could be for more than one pool, job, etc, or it may specify "for one". 

An example of a primary perspective would be "CPU Utilization by Thread or Tasks", which displays the CPU utilization (metric) of threads and tasks (category) with the highest percentage during the collection. Users can then click on as many specific threads or tasks as they want and navigate to the "CPU Utilization for Threads or Tasks" drilldown graph. The chosen threads and tasks are now individual series plotted on a stacked bar chart against each other by time. The user can further drilldown by choosing two bars of the same thread or task and navigating to "CPU Utilization for One Thread or Task" to view the CPU of only that thread during that period of time. The primary perspective shows the total impact of each thread by the end of the collection, whereas the drilldown chart shows each thread's impact at every time interval during the collection.

Another aspect of the filtering that can be done on drilldown secondary perspectives is by time.  Selecting a metric on one interval will filter by that time interval.  Selecting the same metric on multiple intervals will filter by the time between the smallest and largest intervals chosen. 


Drilldown - required selection

Secondary perspectives require selection before drilling down from a primary perspective.  

Before Q2 2024, PDI would allow you to launch to these pages without checking for unresolved variables.  This could result in a skewed and incorrect graph.  With the Q2 2024 HTTP group PTF installed, a message will be shown if no selections are made before attempting to launch to a chart that has required variables:
Chart requested is missing fields for the correct results. Select a data point on the previous chart to provide the required context information.

Drilldown with multiple selections

The ones we are discussing for this section are not the "for one" perspectives which only allow (or adhere to) a single selection.  With multiple selections, there were potential visual issues with secondary charts that were fixed in Q3 2025.  

When multiple category entries are selected (threads, tasks, jobs, pools, etc).  In cases where the selected category entries did all not contain data at the same time intervals, the x-axis labels would become skewed and not line up with the display.  Additionally, if some selected categories contained more data than others (as a result of existing in the collection for more intervals than others), some intervals might be skipped or plotted on the wrong point on the x-axis.  When this occurs, the data in the table is correct, but the chart view is misleading.  You may notice this by the hover text interval data not matching the x-axis where that data is plotted.

This could happen when a thread started part way through the collection cycle, or ended before the collection cycle was completed, but other threads (also selected for drilldown) existed across the full collection.  

One way this may manifest is if you are on a "by" chart (CPU Utilization by Thread or Task), you select multiple entities (thread, task, etc), and drilldown to a "for" version of that chart (CPU Utilization for Threads or Tasks).  A breakdown dimension is used to show each of the entities, and if the selected entities do not all have metrics for the same intervals where data is charted, the values may not be correctly lined up with the x-axis labels.  This can be noticed if you hover over a data point (bar or line) and view the date/time stamp and compare with the value on the x-axis label for the date/time stamp.
If this situation happens, the data in the table is all correct.  It is only the chart view that does not line up correctly.  This is corrected in the Q3 2025 PTFs.  
This can be avoided by only selecting one "entity" - thread, task, pool before drilling down to a "for" chart.  It won't be an issue if all items selected have metrics available for all the same intervals.  

Here are examples of perspectives that this may happen for from Collection Services package:

  • CPU Utilization for Jobs or Tasks
    • for Threads or Tasks
    • for Generic Jobs or Tasks
    • for Job User Profiles
    • for Job Current User Profiles
    • for Subsystems (from CPU Utilization by Subsystem)
    • for Server Types
    • for Pools
  • Physical Disk I/O for Jobs or Tasks (from Job Statistics by Job or Task or other)
    • for Threads or Tasks - Advanced, Basic, Detailed
    • for Generic Jobs or Tasks - Advanced, Basic, Detailed
    • for Job User Profiles - Advanced, Basic, Detailed
    • for Job Current User Profiles - Advanced, Basic, Detailed
    • for Subsystems - Advanced, Basic, Detailed
    • for Server Types - Advanced, Basic, Detailed
  • Page Faults for Jobs or Tasks (drilldown from Job Statistics by Job or Task or other)
    • for Threads or Tasks
    • for Generic Jobs or Tasks
    • for Job User Profiles
    • for Job Current User Profiles
    • for Subsystems
    • for Server Types
    • for Pools
  • Logical Database I/O for Jobs
    • for Generic Jobs
    • for Job User Profiles
    • for Job Current User Profiles
    • for Subsystems
    • for Server Types
  • 5250 Display Transactions for Jobs
    • for Generic Jobs
    • for Job User Profiles
    • for Job Current User Profiles
    • for Subsystems
  • Disk Details for IOPs
    • for Adapters
    • for Disk Pools
    • for Disk Units
    • for Disk Paths
  • Disk Overview for IOPs
    • for Adapters
    • for Disk Pools
    • for Disk Units
    • for Disk Paths
  • Database package perspectives:
    • Physical Database I/O for Jobs or Task - Basic, Detailed
      • for Threads or Tasks - Basic, Detailed (drilldown from Physical Database I/O by Thread or Task - Basic)
      • for Generic Jobs or Tasks - Basic, Detailed
      • for Job User Profiles - Basic, Detailed
      • for Job Current User Profiles - Basic, Detailed
      • for Subsystems - Basic, Detailed
      • for Server Types - Basic, Detailed
    • Logical Database I/O for Jobs -Detailed
      • for Multiple Generic Jobs - Detailed
      • for Multiple  Job User Profiles - Detailed
      • for Multiple Job Current User Profiles - Detailed
      • for Multiple Subsystems - Detailed
      • for Multiple Server Types - Detailed
    • SQL Cursor and Native DB Opens for Jobs
      • for Generic Jobs
      • for Job Current User Profiles

Selectable Sort Perspectives (Collection Services package only)
See notes for information on memory pools charts and timeline x-axis labels.

Packages & Perspectives
Package Folder or Category Perspective Names (highlights, not all inclusive) Requirements
General Health Indicators
System Resources Health Indicators
  • System Resources Health Indicators is an amalgamation of the 5 topic health indicators perspectives.  This one will only support two (2) simultaneous collections for one query.  The limitation is from Db2 because of the complexity of the query.  The following message will appear in the Navigator log file: [SQL0101] SQL statement too long or complex 
  1. CPU Health Indicators
  2. Disk Health Indicators
  3. Memory Pools Health Indicators
  4. Response Time Health Indicators
  5. Database Health Indicators
Base OS
Collection Services Disk
Disk Reads and Writes Detail contains the following views:
  • IBM i Model DSS 
  • Read/Write Rate and Response Time
  • Read/Write Transfer Size and Rate
  • Installed Disk Hardware
Base OS
Storage Allocation
Memory  Memory Pool Activity Levels
Timeline
  • Timeline Overview for Threads or Tasks
  • Timeline Overview for Jobs or Tasks
  • Timeline Overview for one Thread or Task
Physical System
  • Full System I/O Architecture
  • All 12X Loops
  • All PCIe Gen2
Workload Group
Collection Services Database Files QAPMCONF
Monitors System Monitors 7.2 and later only - Comes with the IBM i base OS
Graph History
  • Summary
  • Detailed
7.3 and later only - Comes with the IBM i base OS
Disk Watcher
NONE
(7.2 and earlier require 5770PT1 Option 1 - Manager Feature)
Performance Explorer
Database
Job Watcher  Storage Allocation
NONE
(7.2 and earlier Require Performance Tools LPP (5770PT1) Option 3 - Job Watcher)
Waits - All Waits by Thread or Task Sorted by Non-idle Waits
All Waits for One Thread or Task->
Interval Details for One Thread or Task->
Wait Buckets

File Level
The collectors assign file levels to the database files based on release/version.
Some perspectives require a certain file level and will not be available to a collection not at the required level.
This table shows what file level a collector at each release will give to each collection:
Release Collection Services Job Watcher Disk Watcher PEX Historical Data
6.1 28 3 1 27 -
7.1 36 6 6 29 -
7.2 42 8 6 30 -
7.3 48 48 48 48 1
7.4 54 54 48 54 2
7.5 60 60 48 60 3
PML Single Source
The perspectives are defined with an XML-derivative called PML. 
Perspectives for all releases are defined with one PML file. Within it, there are file level requirements impacted by the releases and files required.  Because not all perspectives are valid for all collections. An older collection might not include files or fields required for a newer collection. 
When the perspective and collection are not compatible, the Display button is not active.  Also, note that a view for a perspective (single chart or table) may be different depending on the collection that is being displayed. See more information in Single Source Packages

Changes in support from Database
A database enhancement affected the PDI queries in Dec 2018. Changes to Db2 support caused some keywords (INNER and OUTER) to not be allowed in places that were previously acceptable. 
The correlation name is no longer required after a derived table. Some correlation names are still allowed, but INNER and OUTER cannot be allowed.  Both INNER and OUTER are keywords that are valid syntax (that is, for INNER JOIN) at this position in the statement.
  • For PDI, we removed the use of INNER in some of our queries to fix this problem. 
  • Another approach is to change it to "INNER" (with delimiters) or change to some other name.
  • To have the query work on a system that doesn't have the enhancement that caused this change, you might need to leave something at this spot in the query.  Changing OUTER to simply O works on all releases.

Additional Perspectives (PML):

Download the latest SSD analyzer PML files for use with Performance Data Investigator:  SSD_analysis.pml__0.xml
Note: Rename to SSD_analysis.pml before uploading to your IBM i and putting in the PML director.
This version has several updates from the original.  The last couple are documented here:
  1. In March 2020 to fix the drilldowns from the first two perspectives
  2. In Jan 2020 for the Db2 changes that required the "OUTER" keyword to be changed to "O".
Description of the perspectives:
    • The SSD Analysis Overview perspective provides a high-level overview of the relative likeliness for SSDs to provide a performance improvement.
    • Disk Read Time depicts average read response time for the selected collection.
    • Disk Read Time by Job and Task is a table showing a subset of the information available for the jobs running during the collection.

[{"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB68","label":"Power HW"}}]

Document Information

Modified date:
12 August 2025

UID

ibm11127175