Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Fixes for defects that were detected during SVT and AVT.
  
  1.  ABEND15F rc10 due to an ABEND0C4 rc4 in IRAENRST JBB772S +
      x'1EC' during an enclave restart because the
      Encb_OffloadTablePtr is zero.
      ABEND0C4 rc4 in IRAENCLS JBB772S + x'058C' during an
      enclave classify if the Encb_OffloadTablePtr is zero.
      If the abend occurs duing policy activation this will result
      in a WAIT08E.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of JBB77S9, JBB772S and HBB7730    *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1) Enclaves that execute work on zIIPs  *
  *                         may loose the zIIP eligibility for   *
  *                         some time when they are              *
  *                         reset/restarted.                     *
  *                                                              *
  *                      2) IIPCP is zero in RMF WLMGL report    *
  *                         but there was zIIP work scheduled    *
  *                         and PROJECTCPU was active.           *
  *                                                              *
  *                      3) Parameter ZIIPQUALTIME of IWMEQTME   *
  *                         is shown as a version 0 parameter    *
  *                         but it is supported with version 1   *
  *                         only.                                *
  *                                                              *
  *                      4) RMF reports show zIIPCP service that *
  *                         is higher than the overall service   *
  *                                                              *
  *                      5) SMF99 records have a record version  *
  *                         21 for JBB77S9, it should be 20.     *
  *                                                              *
  *                      6) IWM4EOCT return code 4 is ambiguous. *
  *                                                              *
  *                      7) Sysevent REQSVDAT returns 0 RQSVSRV. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1) Service times are accumulated in the ENCB and are reset when
     a transaction is restarted. The zIIP offload algorithm
     depends on those times, but the offload definition table is
     not updated when they are reset.
  
  2) When PROJECTCPU=YES is specified in an enviroment without
     zIIP processors configured, any zIIP work is to be reported
     as zIIP_on_CP work to the WLM external interfaces. In
     IRAENTRX the accumulation of on_cp work is done only if the
     corresponding processor (zAAP, zIIP) is configured.
  
  3) The version indicator is incorrect in the AMG of IWMEQTME.
  
  4) The calculation of service units is not 100% accurat, but
     precision is lost. An attempt was made to compensate for this
     loss through rounding. Because the rounding is applied only
     once for the overall service units, but separately for
     special processor service units, it is possible for the sum
     of the special processor units to become larger than the
     overall service unit amount.
  
  5) The SMF99 record version is incorrect for JBB77S9.
  
  6) Return code 4 of IWM4EOCT indicates that the request was
     accepted but there are no zIIPs configured. This return code
     is given no matter what the setting of PROJECTCPU is. The
     result of the IWM4EOCT request, however, is different
     depending on this OPT parameter setting. If PROJECTCPU is
     YES, zIIP usage is projected, otherwise the IWM4EOCT request
     has no effect at all.
  
  7) Sysevent REQSVDAT returns a 0 value for total accumulated
     service (RQSVSRV) during jobstep termination. OUCBWMS is
     not updated if there is no SRB time present for the address
     space.
  

Problem conclusion

• 1) IHAOCT is enhanced to provide a new function ResetOCT which
     updates the enclave offload definition table to reflect the
     clearing of zIIP service times in the ENCB.  IRAXMAC is
     modified to invoke ResetOCT during RESTART processing.
     IRAENCLS, IRAENRST and IRAOPRES are recompiled to pick up the
     IRAXMAC modifications.
  
  2) IRAENTRX is modified to accumulate processor_on_cp times
     unconditionally.
  
  3) Mark ZIIPQUALTIME as a version 1 parameter in IWMEQTME.
  
  4) IRAXMAC is changed back to the original algorithm for service
     unit calculation. Rounding is not done anymore.  IRAENTRX,
     IRARMWL2 and IRAEVEDL are recompiled.
  
  5) Change SMF99_current_ver in IRASMF99 to 20 for JBB77S9.
     Regen/recompile the following parts: IRAPASS1 IRAPASS2
     IRAPASS3 IRAPASS5 IRAPASS6 IRAPASS8 IRAPAS2D IRARMSMF
  
  6) A new reason code is introduced for IWM4EOCT that indicates -
     in case that no zIIPs are configured - whether projection is
     enabled or not.  IRAWLMPL is enhanced with a new
     EncOct_Projected flag in the ENCOCT parameter list. IRAENOCT
     returns the projection setting to IWMW2EOT via the new flag.
     IWMW2EOT returns the new reason code to the caller depending
     on new flag. IWMYCON is enhanced with the new reason code
     IWMRsnCodeNoProjection.
  
  7) IRARMWL2 is changed to update OUCBWMS unconditionally.
  KEYWORDS: ZIIP/K
  D/T2096 D/T2094
  

Temporary fix

Comments

APAR Information

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

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

  UA26745 UA26748 UA26753

Modules/Macros

• IHAOCT   IRAENCLS IRAENOCT IRAENRST IRAENTRX
  IRAEVEDL IRAOPRES IRAPASS1 IRAPASS2 IRAPASS3 IRAPASS5 IRAPASS6
  IRAPASS8 IRAPAS2D IRARMSMF IRARMWL2 IRASMF99 IRAWLMPL IRAXMAC
  IWMEQTME IWMEQTMP IWMW2EOT IWMYCON
  

Fix information

• Fixed component name

  5752 SYS RSRCE

• Fixed component ID

  5752SC1CX

Applicable component levels

• R7S9 PSY UA26748

     UP06/06/27 P F606

• R72S PSY UA26753

     UP06/06/27 P F606

• R730 PSY UA26745

     UP06/06/27 P F606

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:

730

Reference #:

OA16005

IBM Group:

IBM Server Group

Modified date:

2008-11-18