VM66506: PERFORMANCE TOOLKIT DIVIDE EXCEPTION AT FCXEVS+752

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Performance Toolkit for VM may experience a divide exception at
  FCXEVS+752 while processing VSWITCH monitor data.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users who are running Performance        *
  *                 Toolkit for VM in an environment with        *
  *                 Virtual Switches (VSwitches) defined.        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  The problem, "DIVIDE EXCEPTION AT FCXEVS+752", occurs when
  Performance Toolkit for VM is processing VSWITCH monitor data.
  
  When gathering data for the VSWITCH, EVSWITCH, and GVSWITCH
  reports, Performance Toolkit for VM collects data from monitor
  records:
    D6 R21 Sample data - Virtual Switch Activity
    D6 R22 Event data  - Virtual Switch Failover
    D6 R23 Event data  - Virtual Switch Recovery
    D6 R33 Event data  - Virtual Switch Bridge Port Activation
    D6 R34 Event data  - Virtual Switch Bridge Port Deactivation
    D6 R35 Sample data - Virtual Switch Bridge Port Activity
  
  The content of the subject reports should be generated using
  only the Sample (Activity) data from the above list of monitor
  records.  The divide exception may result when the Event data
  is processed.
  

Problem conclusion

• The code to gather data for the VSWITCH, EVSWITCH, and GVSWITCH
  reports has been changed to no longer gather data from the
  following I/O Event monitor records:
  
    D6 R22 Event data  - Virtual Switch Failover
    D6 R23 Event data  - Virtual Switch Recovery
    D6 R33 Event data  - Virtual Switch Bridge Port Activation
    D6 R34 Event data  - Virtual Switch Bridge Port Deactivation
  
  The following updates were made:
  
    FCXVLN ASSEMBLE
  
     - Remove branch addresses corresponding to the above event
       monitor records from the MONIODBT branch table.
  
     - Remove subroutines that processed data from the above
       event records:
       + NEWDR22 (Process VSWITCH Failover record)
       + NEWDR23 (Process VSWITCH Recovery record)
       + NEWDR33 (Process VSWITCH Bridge Port Activation record)
       + NEWDR34 (Process VSWITCH Bridge Port Deactivation record)
  
    FCXPMO ASSEMBLE
  
     - Remove the calls to FCXVLNCO for the above Event records:
       + after label I_OREC23
       + after label I_OREC34
  
  Additionally, the table defined to map the internal
  representation of the three reports (VSWITCH/EVSWITCH/GVSWITCH)
  was not correctly defined.
  
  To resolve this, the following update was made:
  
    FCXVLN ASSEMBLE
  
     - After label BLDSTOR3, when calculating the table size,
       add an entry to the size to accommodate a 'fence indicator'
       when the table is filled to capacity.
  

Temporary fix

• FOR RELEASE PERFKIT-6.4.0 :
  PREREQ: VM66198
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE PERFKIT-7.1.0 :
  PREREQ: VM66198
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE PERFKIT-7.2.0 :
  PREREQ: VM66215
  CO-REQ: NONE
  IF-REQ: NONE
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UM35844 UM35845 UM35846

Modules/Macros

• FCXPMO   FCXVLN
  

Fix information

• Fixed component name

  PERF TOOLKIT

• Fixed component ID

  568411218

Applicable component levels

• R640 PSY UM35844

     UP21/03/31 I 1000

• R710 PSY UM35845

     UP21/03/31 P 2101

• R720 PSY UM35846

     UP21/03/31 P 2102

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.