Performance Toolkit for VM Feature: Output Collectors

Performance Toolkit for VMTM has introduced a set of formatted output collectors. These collectors place processed report data from Performance Toolkit into a Discontiguous Shared Segment (DCSS). The FC MONCOLL SEGOUT controls the enablement of and population of this DCSS.

The PERFOUT DCSS contains all the data provided by the formatted output collector code. The format of this data is documented at the following:

APAR VM66285 is available on z/VM 7.2 for Performance Toolkit and provides support for Dynamic Memory Reconfiguration. With this support, fields DPAFRAMS and SYSDPAP in the PERFOUT DCSS will always have a value of zero.

The new support is provided in

  • PTF UM35662 for z/VM 7.2.0

APAR VM66292 is available on z/VM 7.1 for Performance Toolkit and provides updates to the formatted output collectors. OMEGAMON XE for z/VM and Linux 4.3.0 Fixpack 5 takes advantage of this update.

APAR VM66292 enables Performance Toolkit to display data for up to 80 logical processors per LPAR, and changes the display of processor IDs to hexadecimal values. The hexadecimal processor IDs have been added to the PERFOUT DCSS.

This APAR is required if you are running OMEGAMON XE for z/VM and Linux 4.3.0 Fixpack 5. Likewise, if this APAR is applied for Performance Toolkit, OMEGAMON XE for z/VM and Linux 4.3.0 Fixpack 5 is required.

The new support is provided in

  • PTF UM35501 for z/VM 7.1.0
This code is included in the base of z/VM 7.2.0 Performance Toolkit.

APAR VM65959 is now available on z/VM 6.3 and 6.4 for the Performance Toolkit and provides updates to the formatted output collectors. OMEGAMON XE on z/VM and Linux 4.30 Fixpack 3 takes advantage of this update.

APAR VM65959 enables the Performance Toolkit to populate the DCSS with information on CPU Pooling from both the CPU Pool Activity screen and the CPU Pool Configuration screen. It also adds additional data to the DCSS for LPARS and Processors, including Group Capping parameters and Multithreading Depth. These values are all used by OMEGAMON XE 4.3.0 Fixpack 3.

The new support is provided in

  • PTF UM35065 for APAR VM65959 for z/VM 6.4
  • PTF UM35064 for APAR VM65959 for z/VM 6.3

APAR VM65344 and APAR VM65345 are now available on z/VM 6.2 for the Performance Toolkit and provide updates to the formatted output collectors.

APAR VM65344 enables the Performance Toolkit for VM to monitor the Live Guest Relocation (LGR) activity in the z/VM SSI cluster. OMEGAMON XE 4.3.0 takes advantage of this update.

APAR VM65345 enables the Performance Toolkit to populate the PERFOUT DCSS with the Live Guest Relocation (LGR) activity in the z/VM SSI cluster.

The new support is provided in

  • PTF UM33999 for APAR VM65344 z/VM 6.2.0
  • PTF UM34032 for APAR VM65345 z/VM 6.2.0

APAR VM65172 is now available on z/VM 5.4, 6.1, and 6.2 for the Performance Toolkit and provides updates to the formatted output collectors. OMEGAMON XE 4.2.0 (IF4 and IF5) takes advantage of this update.

Some fields were limited to 4 bytes in size. With larger processors and faster networks, some values were exceeding the maximum value that a 4 byte integer could hold, and were appearing as negative numbers. These fields needed to be expanded to hold 8 byte integer values. OMEGAMON XE 4.2.0 (IF4 and IF5) takes advantage of this update.

Fifty-five (55) attributes were changed. Most remained in the same attribute table, but some attributes were moved from the SYSTEM table to the SYSTEM2 table. These attributes are

  • Avg_Frames_2G
  • Avg_Avail_Pages_2G
  • Dynamic_Frames
  • Free_Storage_Used
  • Page_Rate
  • Total_Available_Storage
  • Offline_Storage_Size
  • Sysgen_Storage_Size
  • Pageable_Storage
  • Avg_Frames
  • Deferred_Pages
  • Avg_Avail_Pages
  • Avail_LowThresh
  • Avail_Low_Thresh_2G
  • Total_XSTORE_Available
  • Total_XSTORE_User

Additionally, a new table was added to the formatted output collector DCSS. The new KVLCPC table contains a summary of the usage of real processors across the CPC.

The new support is provided in

  • PTF UM33715 for z/VM 6.2.0
  • PTF UM33714 for z/VM 6.1.0
  • PTF UM33716 for z/VM 5.4.0
APAR VM64811 is now available on z/VM 5.4 and 6.1 for the Performance Toolkit and provides updates introducing additional data in the formatted output collectors for virtual disks (VDISKs) and minidisk cache. Also, new data is added in the formatted output collectors in support of a new "z/VM System Health Workspace" in Omegamon XE 4.2.0. This new support consists of data to prime
  • CPU Utilization bar chart that displays the total CPU utilization for the system and its component parts; overhead and virtual CPU
  • real Memory Overcommit bar chart that displays the ratio of virtual memory to available real main storage
  • DASD Page Space Utilization bar chart that displays the utilization percent of the defined paging space on disk
  • Main Storage Page Space Utilization bar chart that displays the overall system paging rate for each system
  • Highest Workload Wait Reason bar chart that displays the highest wait reason found for a single user on each system
  • All Systems table displays a list of system attributes collected for each z/VM system

The new support is provided in

  • PTF UM33034 for z/VM 6.1.0
  • PTF UM33033 for z/VM 5.4.0

APAR VM64732 is now available on z/VM 5.3, 5.4, and 6.1 for the Performance Toolkit and provides updates to add support to collect resource constraint analysis data from USTAT and to correct a potential problem when issuing the "PRINT ALL" command before the UCONF data has been collected.

The new support is provided in

  • PTF UM32849 for z/VM 6.1.0
  • PTF UM32848 for z/VM 5.4.0
  • PTF UM32847 for z/VM 5.3.0

APAR VM64699 is now available on z/VM 5.3, 5.4, and 6.1 for the Performance Toolkit and provides updates to correct the cylinder start/end values on CPOWNed devices, provide values missing for the number of virtual processors per user, and provide information missing for message FCX773E.

The new support is provided in

  • PTF UM32799 for z/VM 6.1.0
  • PTF UM32798 for z/VM 5.4.0
  • PTF UM32797 for z/VM 5.3.0

APAR VM64500 is now available on z/VM 5.3 for Performance Toolkit and provides support for Channel Cache, DASD Cache, Spin Locks, and Virtual Disks in Storage.

The new support is provided in

  • PTF UM32473 for z/VM 5.3.0

If you are migrating to the OMEGAMON XE on z/VM and Linux 4.1.2 product, you must apply this PTF to your z/VM system.

This code is included in the base level z/VM 5.4.0 Performance Toolkit.

APAR VM64337 is now available on z/VM 5.2 and 5.3 for Performance Toolkit and provides support for Channels, LCHANNELS, FCHANNELS and Minidisk Cache. This APAR includes the previously released VM64299.

The new support is provided in

  • PTF UM32234 for z/VM 5.3.0
  • PTF UM32233 for z/VM 5.2.0

If you are migrating to the OMEGAMON XE on z/VM and Linux 4.1.1 product, you must apply one of the above PTFs to your z/VM system.

APAR VM64299 is available on z/VM 5.2 and 5.3 for Performance Toolkit as follows

  • PTF UM32170 for z/VM 5.3 provides the update for normalizing Linux data and provides support for mixed processor types in the formatted output.

  • PTF UM32169 for z/VM 5.2 provides the base function for the formatted output collectors and provides an update for normalizing Linux data in the formatted output.

If you are using OMEGAMON XE on z/VM and Linux and you apply either of the PTFs for VM64299 to your z/VM system, then you must apply IBM Tivoli OMEGAMON XE on z/VM and Linux v4.1.0 (4.1.0-TIV-KVL-FP0003). Download a copy of the fixpack from IBM Tivoli OMEGAMON XE on z/VM and Linux Product Support

Before you install the Performance Toolkit code, please read through all the instructions.

Planning

Before you install the Performance Toolkit code:

  • You must have a valid product license for Performance Toolkit for VM. You must also have ordered and installed the PTF which applies to your z/VM level. See above.

  • You need to be able to LOGON to the Performance Toolkit virtual machine on your z/VM system.

Install using VMSES/E

Refer to the Program Directory for Performance Toolkit for your z/VM release and follow the instructions for Servicing Performance Toolkit for VM in Chapter 7. The Program Directories are

Go to Verify the install to make sure the Performance Toolkit code was installed properly.

Verify the install

To verify that the install process completed successfully:

  1. IPL CMS.

  2. Start Performance Toolkit.

    perfkit

  3. Try to start the formatted output collectors.

    fc moncoll segout on perfout

    You should receive the message

    FCXOMB779E Error locating DCSS, unable to find segment: PERFOUT as the collector DCSS has not been created yet.

  4. You can now complete the installation and set up by referring to the FCONTROL MONCOLL SEGOUT command in the "Performance Toolkit Reference".