IBM Support

VM66823: Z/VM SUPPORT FOR THE IBM Z17 AND IBM LINUXONE EMPEROR 5 SERVERS D/T9175

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR provides z/VM compatibility and EQDIO exploitation
    support for the IBM z17 and IBM LinuxONE Emperor 5 servers.
    The IBM z17 and IBM LinuxONE Emperor 5 servers make up the
    IBM z17 family of servers D/T9175.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All installations of z/VM planning to move   *
    *                 to the IBM z17 family ( D/T9175 ).           *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION: APPLY PTF                                    *
    ****************************************************************
    With the applicable PTFs and all required pre-requisite
    service applied z/VM will provide support for the following
    IBM z17 family ( D/T9175 ) server hardware facilities:
    
    Guest enablement to exploit the following facilities:
    
     -Vector-Enhancements Facility 3 - New
      instructions intended to provide performance
      improvements.
    
     -Vector-Packed-Decimal-Enhancement 3 -
      Intended to provide performance improvements
      of COBOL programs when compiled using the
      NUMCHECK option to detect and convert data.
    
     -Workload-Instrumentation - Provides a means of
      classifying and sampling workloads to enhance
      the z/OS pricing model.
    
     -Message-Security-Assist Extensions -
      Enhancements that allow the use of XTS and
      HMAC algorithms and allow for generation of
      XTS and HMAC encryption keys while using
      AES algorithms.
    
     -Perform Lock Operation (PLO) - Provides operations
      for managing locks in storage to replace capabilities
      provided previously by the constrained transactional
      execution (CTX) facility.
    
     -Concurrent-Functions - Provides new instructions
      intended to replace the use of TX for software
      serialization.
    
    Host support for the following new facilities:
    
     -CPU Measurement Facility (CPU-MF)
      enhancements - Provide CPU-MF-specific
      support for IBM z17 family server.
    
     -Data Processing Unit (DPU) Next Generation
      I/O accelerator instrumentation provided
      within the z/VM monitor - Collects FCP, FICON,
      and OSA instrumentation data within the z/VM
      monitor for the IBM z17 family server DPUs.
    
    Real device support - Allows the following to be attached for
    guest exploitation:
    
     - Enhanced QDIO (OSH) devices.
    
     - Network Express Hybrid (NETH) devices.
    
    Dynamic I/O and HCD support added for:
    
     - Enhanced QDIO (OSH) CHPIDs and subchannels
    
     - CL6 coupling adapter CHPIDs
    
     - Network Express Hybrid (NETH) PCIe Functions
    
    Guest exploitation support for EQDIO devices -
    Allows guests to directly exploit the OSH
    functionality of the Network Express Adapter.
    
    Extension of CP VSWITCH logic for Network
    Express Adapter EQDIO support within the z/VM
    VSwitch - Allows customers to configure the
    VSwitch to take advantage of lower latency and
    higher bandwidths provided by networking EQDIO
    devices within their data center. The VSwitch EQDIO
    exploitation includes QDIO-to-EQDIO translation,
    allowing guests that do not support EQDIO to directly
    take advantage of this networking support.
    
    Reduced support for transactional execution (TX) -
    Non-constrained transactions will result in unconditionally
    aborting with condition code 1 (CC1) and no TDB stored.
    
    Power Consumption metrics provided within z/VM monitor -
    enhancements to the z/VM monitor to include entire CPC
    and LPAR specific level power consumption information.
    This information includes power metrics for CPU, I/O, and
    Memory usage. Consumers of z/VM monitor, such as the
    z/VM performance datapump, can be enhanced to
    calculate/approximate guest level apportionment.
    APAR VM66825 provides support for a Performance
    Datapump Power Metric Dashboard.
    
    ----
    Please note the following:
    There are source code recompile requirements specific
    to users of the HCPVINOP MACRO and vendor products that
    use the macro.  Any users of the HCPVINOP MACRO are required
    to recompile their local updates before using this service.
    For users of vendor products, please contact the vendor to
    inquire whether they use the HCPVINOP macro. If so, obtain
    recompiled source from the vendor.
    

Problem conclusion

Temporary fix

Comments

  • The following publications were updated for this support:
    Connectivity
    CP Commands and Utilities Reference
    CP Messages and Codes
    CP Planning and Administration
    CP Programming Services
    Diagnosis Guide
    General Information
    I/O Configuration
    Installation Guide
    Migration Guide
    Performance
    Performance Toolkit Guide
    Performance Toolkit Reference
    Systems Management Application Programming
    ×**** AE25/06/17 FIX IN ERROR. SEE APAR VM66853  FOR DESCRIPTION
    ×**** PE25/06/26 FIX IN ERROR. SEE APAR VM66861  FOR DESCRIPTION
    

APAR Information

  • APAR number

    VM66823

  • Reported component name

    VM CP CP

  • Reported component ID

    568411202

  • Reported release

    730

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2025-02-20

  • Closed date

    2025-06-12

  • Last modified date

    2025-08-01

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

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

    UM90511

Modules/Macros

  • CBITABLE CHPID    CONTROLL CPLOAD   CPQUERY  CPTRACE  DEFINVSW
    DYNIO    HCPABN   HCPACT   HCPADQ   HCPALE   HCPAMD   HCPAPI
    HCPARD   HCPARDBK HCPARF   HCPARP   HCPARR   HCPARS   HCPASD
    HCPASI   HCPASR   HCPATD   HCPAXL   HCPAXR   HCPBID   HCPBIS
    HCPBVM   HCPB9S   HCPCBI   HCPCCF   HCPCCG   HCPCCN   HCPCCS
    HCPCFM   HCPCFR   HCPCFS   HCPCLS   HCPCNF   HCPCONSL HCPCOUNT
    HCPCPF   HCPCPL   HCPCPN   HCPCPS   HCPCPU   HCPCQE   HCPCQT
    HCPCSA   HCPCSIBK HCPCTC   HCPCTS   HCPCTV   HCPCVT   HCPCVU
    HCPDA0   HCPDCT   HCPDEC   HCPDFN   HCPDGB   HCPDGG   HCPDGQ
    HCPDGR   HCPDIR   HCPDMD   HCPDROP  HCPDSX   HCPDTD   HCPDTFBK
    HCPDTS   HCPDVT   HCPDVTYP HCPD5C   HCPEBS   HCPEND   HCPEQA
    HCPEQL   HCPEQS   HCPEQUAT HCPESS   HCPETHBK HCPEWL   HCPEXC
    HCPFCP   HCPFMV   HCPFQC   HCPFQL   HCPFST   HCPGIR   HCPGIS
    HCPGOTO  HCPGRD   HCPGSP   HCPHCD   HCPHDS   HCPHOT   HCPHPV
    HCPHVD   HCPHVR   HCPICP   HCPIDX   HCPIFI   HCPIIO   HCPIMT
    HCPIOP   HCPIOS   HCPIOT   HCPIOX   HCPIPM   HCPIPN   HCPIPNBK
    HCPIPT   HCPIPY   HCPIQC   HCPIQD   HCPIQE   HCPIQG   HCPIQH
    HCPIQM   HCPIQN   HCPIQN$  HCPIQO   HCPIQP   HCPIQQ   HCPIQR
    HCPIQS   HCPIQT   HCPIQV   HCPIQX   HCPIRBLK HCPISL   HCPIST
    HCPIUA   HCPIUB   HCPIUP   HCPIUY   HCPIVA   HCPIVC   HCPIVF
    HCPIVG   HCPIVH   HCPIVL   HCPIVQ   HCPIVS   HCPKAB   HCPKAD
    HCPKAE   HCPKAP   HCPKAQ   HCPKAR   HCPKAT   HCPKAU   HCPKAV
    HCPKCD   HCPKFL   HCPKFR   HCPLAL   HCPLAN   HCPLANBK HCPLBY
    HCPLCK   HCPLDF   HCPLGN   HCPLLNBK HCPLLT   HCPLLX   HCPLPC
    HCPLSP   HCPMCB   HCPMCH   HCPMDLAT HCPMEO   HCPMES   HCPMESB
    HCPMFA   HCPMFB   HCPMFE   HCPMFF   HCPMFJ   HCPMFK   HCPMFO
    HCPMFW   HCPMFX   HCPMFY   HCPMF1   HCPMHT   HCPMIHDR HCPMINUS
    HCPMLM   HCPMNO   HCPMNP   HCPMNU   HCPMOL   HCPMOM   HCPMONEQ
    HCPMPA   HCPMPG   HCPMPX   HCPMSVBK HCPMTS   HCPMVN   HCPMXD
    HCPMXI   HCPMXL   HCPMXP   HCPMXRBK HCPNDC   HCPNDF   HCPNDM
    HCPNDMBK HCPNDQ   HCPNEM   HCPNIC   HCPNICBK HCPNID   HCPNIDBK
    HCPOM1   HCPOM2   HCPOPTNS HCPPCB   HCPPCI   HCPPCJ   HCPPCK
    HCPPCW   HCPPDR   HCPPED   HCPPFXPG HCPPIS   HCPPLM   HCPPLSBK
    HCPPOD   HCPPOW   HCPPOWBK HCPPRG   HCPPRV   HCPPSW   HCPPTE
    HCPPTF   HCPPXI   HCPPXJ   HCPPXQ   HCPQDIO  HCPQDO   HCPQFC
    HCPQIO   HCPQOS   HCPQPS   HCPQSBLK HCPQSEBK HCPQSEND HCPQUY
    HCPQVA   HCPQVD   HCPQYA   HCPRCC   HCPRCCBK HCPRCS   HCPRDEV
    HCPRDI   HCPRDM   HCPREI   HCPRES   HCPRFI   HCPRID   HCPRLA
    HCPRLE   HCPRLG   HCPRLI   HCPRLJ   HCPRLM   HCPRLP   HCPRLR
    HCPRLS   HCPRLZ   HCPRP    HCPRPCI  HCPRPE   HCPRPP   HCPRST
    HCPRUN   HCPSCD   HCPSCFBK HCPSDD   HCPSDN   HCPSDNX  HCPSDU
    HCPSFB   HCPSFC   HCPSGP   HCPSGR   HCPSHI   HCPSI2GB HCPSLB
    HCPSLMBK HCPSNP   HCPSNSEQ HCPSOI   HCPSREBK HCPSRF   HCPSRM
    HCPSSI   HCPSSIBK HCPSTP   HCPSWA   HCPSWB   HCPSWC   HCPSWD
    HCPSWF   HCPSWG   HCPSWH   HCPSWI   HCPSWIBK HCPSWL   HCPSWM
    HCPSWO   HCPSWP   HCPSWQ   HCPSWR   HCPSWS   HCPSWU   HCPSWY
    HCPSXL   HCPSXP   HCPSYE   HCPSYM   HCPSYN   HCPSYS   HCPSYSCM
    HCPSZD   HCPSZE   HCPSZK   HCPSZL   HCPTGD   HCPTGF   HCPTGL
    HCPTGR   HCPTKM   HCPTMR   HCPTPA   HCPTPI   HCPTPO   HCPTPR
    HCPTPS   HCPTPT   HCPTPX   HCPTPY   HCPTRA   HCPTRD   HCPTRF
    HCPTRI   HCPTRP   HCPTRR   HCPTRT   HCPTRW   HCPTRX   HCPTRXBK
    HCPTRY   HCPTSC   HCPTSD   HCPTSN   HCPTSZ   HCPTTA   HCPTTABK
    HCPTVS   HCPUCP   HCPUCQ   HCPUDU   HCPUSING HCPUSR   HCPVAI
    HCPVAP   HCPVDB   HCPVDEV  HCPVDG   HCPVDM   HCPVER   HCPVINOP
    HCPVIR   HCPVLC   HCPVLE   HCPVLF   HCPVLG   HCPVLI   HCPVLM
    HCPVLQ   HCPVLS   HCPVLU   HCPVMABK HCPVMP   HCPVNC   HCPVNS
    HCPVOF   HCPVOL   HCPVOP   HCPVOPBK HCPVOS   HCPVOT   HCPVQA
    HCPVQB   HCPVQE   HCPVQF   HCPVQG   HCPVQH   HCPVQO   HCPVQP
    HCPVQQ   HCPVQR   HCPVQS   HCPVQT   HCPVQU   HCPVTX   HCPWIS
    HCPWPR   HCPWRU   HCPWSI   HCPWVS   HCPXAB   HCPXAC   HCPXAI
    HCPXAT   HCPXLK   HCPZDR   HCPZPR   HCPZPU   HCPZRP   HCPZSI
    HCPZSR   HCPZXU   HCP1167E HCP1705I HCP1706I HCP1995I HCP278
    HCP2832E HCP3172E HCP3226E HCP3227I HCP3228I HCP3229E HCP3231E
    HCP3234E HCP3240E HCP3241E HCQINT   HCQMN730 HCWAI7   HCWAI8
    HCWA12   IPWEQDIO IPWEQDI6 IPWIFV4  IPWIFV6  IPWIZARD IPWIZXED
    LGRSDNX  MNEMONI2 MODIFPOR MRIODBPS MRIODPAC MRIODQDA MRIODQDD
    MRIODQDS MRIODVSE MRIODVSW MRMTRQDC MRMTRSYS MRPRCAPM MRSYTEPM
    MRSYTPOW MRUSEACT MRUSELOF NICDEF   OSA      OSAINFO  PCIFUNCT
    PORT     RDEVICOM RESPONSE SERIALOP SPECIAL  SRM      TRACE
    TRSOURCE TXBEGIN  TXEND    TXSUSP   VIRTOSA  VMRELOCA VSWITCH
    

Publications Referenced
SC24626773SC24626873GC24627073SC24627173SC24627273
GC24628073GC24628673SC24629173GC24629204GC24629473
SC24630173SC24630273SC24630373SC24632773 

Fix information

  • Fixed component name

    VM CP CP

  • Fixed component ID

    568411202

Applicable component levels

  • R730 PSY UM90511

       UP25/06/17 I 1000

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.

[{"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SG27M","label":"APARs - z\/VM Environment"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
02 August 2025