VM65680: MULTITHREADING PRORATED CORE TIME SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR contains the z/VM Multithreading Prorated Core Time
  Support and also resolves the ABENDSRN005 problem reported by
  APAR VM65613.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All z/VM users when multithreading is        *
  *                 enabled                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  The purpose of APAR VM65680 is to calculate and report prorated
  core time for all users and use it for CPU pooling improvements.
  Prorated core time is only used when multithreading is enabled.
  This support enforces capacity limits using core time rather
  than thread time so that a CPU Pool will not be limited
  prematurely.
  

Problem conclusion

Temporary fix

Comments

• When the PTF for APAR VM65680 is applied and multithreading is
  enabled, CP provides support for multithreading prorated core
  time. Prorated core time is a method that provides reports and
  caps based on core utilization regardless of the multithreading
  benefit, which might be used as a means of distributing charges
  for subcapacity based products that are based on core capacity.
  Time is charged by dividing the time the core was dispatched
  evenly among the threads dispatched in that interval. Under this
  method, the total time charged to all guests equals the total
  time the logical cores of the z/VM partition were dispatched.
  Prorated core time is calculated for all users only when
  multithreading is enabled, and used in the limiting calculations
  of CPU pools and guests with individual LIMITHARD shares.
  
  With this support, the prorated core time fields that were added
  to accounting records and monitor records for multithreading
  support will now be populated with data when multithreading is
  enabled.
  
  The following CP interfaces have been updated:
  1. DEFINE CPUPOOL command
  2. QUERY CPUPOOL command
  3. SET CPUPOOL command
  4. SET SHARE command
  5. Virtual Machine Resource Usage 2 (Type F) accounting record
  6. Store hypervisor information (STHYI) instruction
  7. Monitor records:
     - Domain 2 Record 13 - MRSCLALL - Add VMDBK to the limit list
       (Event Record)
     - Domain 2 Record 14 - MRSCLDLL - Drop VMDBK from the limit
       list (Event Record)
     - Domain 5 Record 19 - MRPRCCPU - CPU Pool Utilization
       (Sample Record)
  
  For more information, see:
  
    z/VM: CP Commands and Utilities Reference
    z/VM: CP Planning and Administration
    z/VM: CP Programming Services
  ×**** PE15/10/21 FIX IN ERROR. SEE APAR VM64952  FOR DESCRIPTION
  

APAR Information

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

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

  UM34666 UM34667

Modules/Macros

• CPUPOOL  HCPBVM   HCPCCFBK HCPCORBK HCPCPU
  HCPDSB   HCPDSP   HCPHIS   HCPINFBK HCPLIMBK HCPLMC   HCPMES
  HCPMESA  HCPMESB  HCPMNE   HCPMNP   HCPMPS   HCPMTC   HCPMTO
  HCPPFX   HCPPFXPG HCPRLG   HCPSCI   HCPSCJ   HCPSCK   HCPSGP
  HCPSHI   HCPSRN   HCPSZD   HCPSZE   HCPSZK   HCPSZL   HCPVMDBK
  HCPWHI   MRPRCCPU MRSCLALL MRSCLDLL SHARE
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• RA63 PSY UM34666

     UP16/03/30 P 1601

• R630 PSY UM34667

     UP15/09/10 P 1601

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.