Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  The existing EWLM instrumentation in DB2 DDF reduces the DB2
  throughput considerably. The internal throughput reduction is
  caused by the increased granularity of instrumentation on the
  network flow level and the additional pathlength in the WLM
  services.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS 1.6 and above              *
  *                 exploiting EWLM on z/OS in combination       *
  *                 with DB2 DDF as an EWLM instrumented         *
  *                 middleware.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: The existing EWLM instrumentation in    *
  *                      DB2 DDF reduces the DB2 throughput      *
  *                      considerably. The internal throughput   *
  *                      reduction is caused by the increased    *
  *                      granularity of instrumentation on the   *
  *                      network flow level and the additional   *
  *                      pathlength in the WLM services.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  WLM must provide a lightweight version of the EWLM Enclave
  services with a limited functionality for environments like
  DB2 DDF where the pathlength of the full-functional WLM services
  is too long compared to the actual application pathlength.
  
  This APAR must also support Virtualization Engine EWLM V2.1.0
  (Program Numbers 5655-EWM and 5655-S01) by providing a higher
  precision (MicroSeconds instead of MilliSeconds) for measured
  response times, blocked times and queue times.
  
  The following problems will also be fixed:
  - A problem in EWLM function ewlm_get_completions, where
    the function may return an undocumented internal function
    code -4011
  - A problem in IWMWMWRS when a correlator of length > 64 Bytes
    is passed in the classification parameter list (EWLM_CORR).
    This error can result in an ABEND1C7,REASON=03520019
  

Problem conclusion

Temporary fix

Comments

• OA12005 supports two new options for the ESTRT keyword  on the
  IWMECREA/IWM4ECRE service: ESTRT=EXPLICIT_SINGLE | NEVER.
  For all EWLM related Enclave services (IWMESTRT, IWMESTOP,
  IWMEBLK, IWMEUBLK, IWMEGCOR) a new keyword EWLMMODE was
  introduced, that allows to select the restricted lightweight
  version of the services or the full functional implementation.
  
  New modules IWMW2EFE and IWMW2EFP implement the lightweight
  version of the services with a dramatically reduced pathlength
  compared to the full-blown version of the services.
  The new module IWMA3RQH implements the asynchronous handler for
  the terminated transactions that writes the completion records
  to the EWLM completion buffer.
  
  Module IWMA3QSC and several internal methods were changed to
  support the VE EWLM 2.1.0 interface changes. Moreover the
  C header files EWLMPLAT, EWLMPOLS and EWLMPLOS were updated
  to support the EWLM V2.1.0 interface changes.
  
  The z/OS V1R7.0 MVS Programming: Workload Management Services
  book (SA22-7619-10) is affected by this APAR (changes to
  IWMECREA, IWMESTRT, IWMESTOP, IWMEBLK, IWMEUBLK, IWMEGCOR,
  IWM4ECRE services). The V1R7 softcopy of the manual is refreshed
  and available on the Internet at:
  http://www.ibm.com/servers/eserver/zseries/zos/bkserv/
  The V1R6 online manuals are no longer updated, but the changes
  are exactly identical to the V1R7 version, so V1R6 customers can
  also refer to the V1R7 manuals.
  

APAR Information

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

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

  UA22388 UA22389

Modules/Macros

• EWLMPLAT EWLMPLOS EWLMPOLS IRAENCB  IRAENEF
  IRAENELM IRAENERP IRAEVEDL IWMAMCT  IWMAMEWL IWMA3ACE IWMA3ADB
  IWMA3AED IWMA3ASP IWMA3AST IWMA3A4E IWMA3BLK IWMA3BND IWMA3BRI
  IWMA3CLC IWMA3CLS IWMA3COR IWMA3DEF IWMA3DIS IWMA3DPD IWMA3DTR
  IWMA3EAC IWMA3ECN IWMA3END IWMA3ENQ IWMA3EPO IWMA3ERC IWMA3EVR
  IWMA3EWT IWMA3GCD IWMA3GCO IWMA3GLS IWMA3GQV IWMA3HID IWMA3INA
  IWMA3INT IWMA3IN1 IWMA3LCI IWMA3PAC IWMA3PBB IWMA3PCR IWMA3POL
  IWMA3PRC IWMA3PRT IWMA3Q   IWMA3QRM IWMA3QSC IWMA3QSS IWMA3RAC
  IWMA3RAP IWMA3RC1 IWMA3RC2 IWMA3RM  IWMA3RME IWMA3RQ  IWMA3RQH
  IWMA3RTR IWMA3STA IWMA3STO IWMA3SYT IWMA3TRN IWMA3TSK IWMA3UBL
  IWMA3UBN IWMA3UNI IWMA3UPD IWMA3UTL IWMA3WSA IWMCLSFP IWMCLSFY
  IWMCTMOD IWMEBLK  IWMEBLKP IWMECREA IWMECREP IWMEGCOP IWMEGCOR
  IWMESTOP IWMESTPP IWMESTRP IWMESTRT IWMEUBLK IWMEUBLP IWMI2LPA
  IWMI2MAN IWMI2NUC IWMI2TSK IWMMT    IWMO2DIS IWMPOOL  IWMWCDA
  IWMWMVT  IWMW2CON IWMW2CRE IWMW2DEL IWMW2DIS IWMW2EFE IWMW2EFP
  IWMW2GCR IWMW2RPE IWMW2TR  IWMW2WRB IWMW2WRP IWMW2WRS IWMW2WRU
  IWMX2ISW IWMX2RXF IWMYCON  IWM4ECRE IWM4ECRP SGIIWM
  

Publications Referenced

SA22761910

Fix information

• Fixed component name

  WORK LOAD MANAG

• Fixed component ID

  5752SCWLM

Applicable component levels

• R709 PSY UA22388

     UP05/11/23 P F511

• R720 PSY UA22389

     UP05/11/23 P F511

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:

709

Reference #:

OA12005

IBM Group:

IBM Server Group

Modified date:

2005-12-03