PH03207: NEW FUNCTION - DFSORT exploitation of the IBM Integrated Accelerator for Z Sort on z15

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  SMFREC/K
  
  
  ADDITIONAL KEYWORDS:
  ZSORT/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of DFSORT on zOS V2.3 and V2.4                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function:                                                *
  * DFSORT exploits the IBM Integrated Accelerator for Z Sort on *
  * z15. The IBM Integrated Accelerator for Z Sort, a new CPU    *
  * co-processor, provides the new SORTL instruction.  Use of    *
  * the SORTL instruction allows DFSORT to use a hardware        *
  * accelerated approach to sorting.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

Temporary fix

• New Function in support of the IBM Integrated Accelerator for Z
  Sort on z15
  

Comments

• This PTF provides the DFSORT exploitation of the IBM Integrated
  Accelerator for Z Sort on z15. The IBM Integrated Accelerator
  for Z Sort, a new CPU co-processor, provides the new SORTL
  instruction. Use of the SORTL instruction allows DFSORT to use a
  hardware accelerated approach to sorting.
  
  For information on the documentation updates related to the
  DFSORT support of the IBM Integrated Accelerator for Z Sort,
  please refer to the DFSORT User Guide For APAR PH03207 on zOS
  V2R3 and V2R4 PTFs UI90067 and UI90068. The User Guide for APAR
  PH03207 can be found on the DFSORT home page at URL:
  http://www.ibm.com/storage/dfsort .
  
  Documentation for this new function will be updated in the next
  refresh of the V2R4 publications:
  z/OS DFSORT Application Programming Guide (SC23-6878)
  z/OS DFSORT Messages, Codes and Diagnosis Guide (SC23-6879)
  z/OS DFSORT Installation and Customization (SC23-6881)
  z/OS DFSORT Tuning Guide (SC23-6882)
  
  Message changes could affect your automated operations.
  
  Message ICE130I was modified
  Message ICE267I is new
  Message MSG=ICE268I is new
  Message MSG=ICE269I is new
  Message MSG=ICE399I is new
  Message MSG=ICE808I  is new
  
  In order for this PTF to be fully effective, an IPL with CLPA is
  required.
  
  KEYWORDS
  E8561/K - IBM.Device.Server.z15-8561.Exploitation
  E8562/K - IBM.Device.Server.z15T02.8562.Exploitation
  
  In order to take advantage of the IBM Integrated Accelerator for
  Z Sort, a z15 or later processor is required. DFSORT was
  enhanced to use the latest I/O technologies available.  When
  using the new function and if DFSORT is not able to contain a
  SORT workload entirely in memory, storage devices that support
  zHPF (z High Performance FICON) are required and must be
  enabled. Please refer to the documentation provided for this
  support on Memory Requirements.  When using the new function,
  ensure your system is configured with the proper amount of
  memory for your sort workloads and zHPF (z High Performance
  FICON) is enabled.
  
  In order for SMF analysis programs to report on the new ZSORT
  statistics, a reserved field ICERES1B has been changed to
  ICEHDRLN that contains the length of the header/self-defining
  section and can be used to determine if the new triplet is
  present.  Evaluate your applications using DFSORT's ICESMF macro
  to determine if modifications are required.
  ×**** PE20/12/10 FIX IN ERROR. SEE APAR PH32571  FOR DESCRIPTION
  ×**** PE21/01/07 FIX IN ERROR. SEE APAR PH33133  FOR DESCRIPTION
  ×**** PE21/04/08 FIX IN ERROR. SEE APAR PH29959  FOR DESCRIPTION
  

APAR Information

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

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

  UI90067 UI90068

Modules/Macros

• ICEKPUT  ICEDSVD  ICEINIC  ICEIPUM  ICEFXIT  ICEINID  ICEMPUT
  ICEXPUB  ICECYLP  ICESMF   ICECYLN  ICEMAC   ICEFXA   ICEINIF
  ICEMSGA  ICEMPUM  ICEDYN1  ICEZGLOB ICEMAN   ICEDSVB  ICEMSGS
  ICETD1   ICETD2   ICEINIV  ICEMDEV  ICEZLFQ  ICETD3   ICEIPUT
  ICETD4   ICETRYB  ICEMTS   ICEZTHRD ICEINTF  ICEFPUB  ICEINTD
  ICEISAM  ICEMSET  ICEFPDT  ICEBLDX  ICEOUTF  ICEIPDM  ICEVPUT
  ICEZDSKL ICEFPUT  ICEZSWRK ICEZSORT ICEIEFS  ICEF64B  ICEF64C
  ICEMOS   ICEFXPB  ICEOPUT  ICEFORM  ICEINT1  ICEPL64  ICEDEV
  ICEFVL2  ICEINSE  ICEINSC  ICEINSD  ICEZRUN  ICEINTC  ICECPUM
  ICEINTA  ICEAM1   ICEAM2   ICEFVLD  ICEFVLE  ICEAM3   ICEAM4
  ICEV64Y  ICEPRML  ICEIPVM  ICEZCALL ICEZERR  ICEV640  ICEEXIN
  ICEEXIO  ICETOOL  ICETRYP  ICEINSA  ICEV64D  ICEZMEM  ICEDEC
  ICEINSB  ICEOVLR  ICEV64B  ICEDEF   ICEMCDU  ICEIPVT  ICEZEVCT
  ICECRE   ICEFIXM  ICECRO   ICELIM   ICEVRN   ICEVRO   ICEVIM
  ICEVRE   ICEDED   ICE15V   ICEIPDT  ICEDYNA  ICENPUT  ICESTG5
  ICEKPUM  ICECOBV  ICELIV   ICECPUT  ICEPPUT  ICEDSVA  ICEDSVC
  ICEDSVY  ICEDSVZ  ICEZPUT  ICEOPFT  ICEF64A  ICEINSF  ICEIPFT
  ICEZPUM  ICEINTB  ICENVLR  ICEFPFT  ICEIPFM  ICEKVLR  ICEV64A
  

Fix information

• Fixed component name

  DATA FACILITY S

• Fixed component ID

  5740SM105

Applicable component levels

• RN00 PSY UI90067

     UP20/09/25 P F009  

• RP00 PSY UI90068

     UP20/09/25 P F009  

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.