Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New function to update WLM to calculate the 4 hour rolling
  average for LPARS even if no capacity limit is defined.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of z/OS V1R1 (JBB7713) and above       *
  ****************************************************************
  * PROBLEM DESCRIPTION: New function to update WLM to calculate *
  *                      the 4 hour rolling average for LPARS    *
  *                      even if no capacity limit is defined.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1. Workload License Charges (WLC) pricing changes in the
     sub-capacity reporting tool (SCRT) V3 and higher are not
     supported.
  2. When a system IPLs the 4 hour rolling average is calculated
     over too short of a time period. This can cause the system to
     be capped during IPL.
  3. The value of the 4 hour rolling average does not reflect the
     fact if it was calculated or not.
  

Problem conclusion

Temporary fix

Comments

• 1. The 4 hour MSU average is now calculated for LPARs whenever
     the hardware supports the enhanced diagnose 204 and diagnose
     304 instructions. So, the following fields are now available
     for LPARs without a defined capacity limit, as is already
     available for LPARs with a defined capacity limit:
     - the service table entries in the LPAR Capping control table
       and the average service rate LCCTAVGMSU,
     - the field RCTLACS in the system resource manager resource
       control table,
     - the SMF 99 subtype 1 Software licensing information area,
     - the return area of SYSEVENT REQLPDAT (which is mapped by
       IRALPDAT).
     In addition, the mapping of the SYSEVENT REQLPDAT return area
     has changed. The new flag LpDatDefCapDataValid was introduced
     in IRALPDAT, which indicates if data is available in
     LpDatDefCapData without signaling that the LPAR has a
     capacity limit defined, like LpDataDefCapSet does.
  2. IEAVNP10 was expanded to initialize each of the 48 service
     table entries with the value of one uncapped CPU service unit
     for 5 minutes (These are 48 entries of 5 minute intervals
     which agrees 4 hours). So, the calculation of the 4 hour
     rolling average during IPL is now based on the assumption
     that the system would have run for 4 hours without load.
  3. The 4 hour rolling average has at least value 1 if
     calculated.
  

APAR Information

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

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

  UW95560 UW95561 UW95562 UW95563

Modules/Macros

•    IEAVNP10 IRAEVLPD IRALPDAT IRAPADRV IRAPALCD
  IRAPASMF IRAPASM2 IRAPASS1 IRARCT   IRASR304
  

Publications Referenced

GA22758202

GA22758203

Fix information

• Fixed component name

  5752 SYS RSRCE

• Fixed component ID

  5752SC1CX

Applicable component levels

• R705 PSY UW95560

     UP02/11/27 P F211

• R706 PSY UW95561

     UP02/11/27 P F211

• R707 PSY UW95562

     UP02/11/27 P F211

• R713 PSY UW95563

     UP02/11/28 P F211

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.

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Product categories:

Software

Operating System

z/OS family

APARs - z/OS environment

Operating system(s):

MVS, z/OS

Software version:

713

Reference #:

OW55509

IBM Group:

IBM Server Group

Modified date:

2003-04-02