IBM Support

VM65417: GUEST SUPPORT OF ZEDC EXPRESS AND 10GBE ROCE FEATURES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Guest Support of zEDC Express and 10GbE RoCE features
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: zVM users with zEDC Express or               *
    *                 10GbE RoCE Express features.                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION: APPLY PTF                                    *
    ****************************************************************
    With the PTF for APAR VM65417, z/VM V6.3 guests will be allowed
    to dedicate PCIe adapters to their virtual machines.
    
    Note: For specific information about enabling and configuring
    z/VM for guest exploitation of PCIe adapters see the following
    website:  http://www.vm.ibm.com/zvm630/apars.html
    
    Note: DVF APAR VM65572 and TCPIP APAR PI20509 are required for
    this support if DVF and/or TCPIP is used on your system.
    
    The minimum hardware requirement for the zEDC Express and 10GbE
    RoCE Express features is a zEnterprise EC12 or BC12 at driver
    level D15 with a minimum bundle level.  At the time of the
    closing of this PTF, not all of the required firmware updates
    are available.  See the PSP bucket for availability information
    of required firmware.
    
    z/OS V2.1 guests (with required PTFs) running under z/VM V6.3
    can exploit the zEDC Express and 10GbE RoCE features. See the
    PSP bucket for specific details.
    
    
     - zEDC Express feature
    
       IBM zEnterprise Data Compression (zEDC) for z/OS V2.1 and
       the zEDC Express feature are designed to support a new data
       compression function to help provide high-performance,
       low-latency compression without significant CPU overhead.
       This can help to reduce disk usage, provide optimized
       cross-platform exchange of data, and provide higher write
       rates for SMF data.
    
     - 10GbE RoCE Express feature
    
       The term RoCE refers to Remote Direct Memory Access over
       Converged Ethernet. The 10 Gigabit Ethernet (10GbE) RoCE
       Express feature is designed to help reduce consumption of
       CPU resources for applications utilizing the TCP/IP stack
       (such as WebSphere Application Server accessing a DB2
       database). Use of the 10GbE RoCE Express feature is designed
       to help reduce network latency with memory-to-memory
       transfers utilizing Shared Memory Communications-Remote
       Direct Memory Access (SMC-R) in z/OS V2.1. It is transparent
       to applications and can be used for LPAR-to-LPAR
       communication on a single system or server-to-server
       communication in a multiple-CPC environment.
    

Problem conclusion

Temporary fix

Comments

  • Updated publications can be found at the IBM Publications Center
    at http://www-05.ibm.com/e-business/linkweb/
    publications/servlet/pbi.wss
    
    For latest enabling and configuration information see the
    following website:  http://www.vm.ibm.com/zvm630/apars.html
    This information supercedes what is found in the publications.
    
    For more information about guest support for PCIe functions,
    see z/VM CP Planning and Administration, Chapter 16 -
    "Using PCIe Functions for z/VM Guests".
    
    The following system configuration statements have been updated
    for this support:
    
    - FEATURES
    - STORAGE
    
    The following CP commands have been added for this support:
    
    - DEFINE PCIFUNCTION
    - DELETE PCIFUNCTION
    - DETACH PCIFUNCTION
    - LOCATE RPCI
    - LOCATE VPCI
    - MODIFY PCIFUNCTION
    - QUERY IOASSIST (The function of this command is similar
                      to but different from the QUERY IOASSIST
                      command that was removed in V5.1.)
    - QUERY PCIFUNCTION
    - QUERY VIRTUAL PCIFUNCTION
    - SET IOASSIST (The function of this command is similar to but
                    different from the SET IOASSIST command that was
                    removed in V5.1.)
    - VARY PCIFUNCTION
    
    The following CP commands have been updated for this support:
    
    - ATTACH
    - DEFINE CHPID / PATH
    - MONITOR
    - QUERY CHPID
    - QUERY FRAMES
    - QUERY MONITOR
    - QUERY TRFILES
    - QUERY TRSOURCE
    - RESET
    - SET CPTRACE
    - TRSOURCE ENABLE
    - TRSOURCE ID
    - VMRELOCATE
    
    
    PCIFUNCT has been added to the list of restricted user IDs.
    
    
    The following CP monitor records have been added for this
    support:        .
    
    - Domain 1 Record 27 -
               MRMTRPCI - PCI function Configuration Data
    - Domain 6 Record 36 -
               MRIODPAT - Attach PCI Function
    - Domain 6 Record 37 -
               MRIODPDT - Detach PCI Function
    - Domain 6 Record 38 -
               MRIODPEN - Guest Enables a PCI Function
    - Domain 6 Record 39 -
               MRIODPAC - PCI Activity
    - Domain 6 Record 40 -
               MRIODPDS - Guest Disables a PCI Function
    - Domain 6 Record 41 -
               MRIODPER - PCI function error
    - Domain 6 Record 42 -
               MRIODPAD - PCI function added to the system
    - Domain 6 Record 43 -
               MRIODPDL - PCI function deleted from the system
    - Domain 6 Record 44 -
               MRIODPMD - PCI function program controls modified
    - Domain 6 Record 45 -
               MRIODPON - Real PCI function varied on
    - Domain 6 Record 46 -
               MRIODPOF - Real PCI function varied offline
    
    The following CP monitor records have been updated:
    
    - Domain 0 Record 3 - MRSYTRSG - Real Storage Data (global)
    - Domain 1 Record 4 - MRMTRSYS - System Configuration Data
    - Domain 1 Record 7 - MRMTRMEM - Memory Configuration Data
    
    The following DIAGNOSE code has been updated for this support:
    
    - DIAGNOSE Code X'2AC'
    
    Trace codes in the range 1200 - 123F have been added for this
    support (For more information about these trace codes, see
    z/VM: Diagnosis Guide).
    
    The following dynamic I/O return codes have been modified
    for adding, deleting, or changing a PCI function:
    
    - 0106
    - 0107
    - 010A
    - 010D
    - 010F
    - 0110
    - 0112
    - 011C
    - 011D
    

APAR Information

  • APAR number

    VM65417

  • Reported component name

    VM CP

  • Reported component ID

    568411202

  • Reported release

    630

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-09-16

  • Closed date

    2014-07-16

  • Last modified date

    2017-12-11

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

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

    UM34343 306PC1Ÿ UM34402 306PC1Ÿ 306PC1Ÿ

Modules/Macros

  • ATTACH   CBITABLE CHPID    CP       CPLOAD
    CPQUERY  CPSET    CPSYNTAX CPTRACE  DEFINE   DELETE   DETACH
    FRAMES   HCPALE   HCPARD   HCPATC   HCPBVM   HCPB9S   HCPCBI
    HCPCCG   HCPCCN   HCPCCQ   HCPCCS   HCPCFD   HCPCIO   HCPCPS
    HCPCQG   HCPCQO   HCPDBFBK HCPDEF   HCPDMP   HCPDPB   HCPDSP
    HCPDTC   HCPDTFBK HCPEQUAT HCPFRMTE HCPGETFR HCPHCD   HCPHCQ
    HCPHPM   HCPHSH   HCPIDF   HCPIFI   HCPIIO   HCPIOX   HCPIPQBK
    HCPISH   HCPLAL   HCPLPC   HCPMCV   HCPMDLAT HCPMEO   HCPMES
    HCPMESA  HCPMESB  HCPMFF   HCPMFO   HCPMFW   HCPMND   HCPMNDBK
    HCPMNF   HCPMNH   HCPMNJ   HCPMNO   HCPMNQBK HCPMNW   HCPMOD
    HCPMOL   HCPMOM   HCPMONEQ HCPMOPBK HCPMXD   HCPMXD$  HCPMXI
    HCPMXQ   HCPMXRBK HCPOM1   HCPPCB   HCPPCCBK HCPPCF   HCPPCH
    HCPPCI   HCPPCIHQ HCPPCJ   HCPPCK   HCPPCM   HCPPCO   HCPPCRBK
    HCPPCV   HCPPCW   HCPPFXPG HCPPRV   HCPPTE   HCPQPA   HCPQPS
    HCPQUY   HCPRES   HCPRLI   HCPRLV   HCPRP    HCPRPCI  HCPRSC
    HCPRSM   HCPRSMBK HCPRST   HCPSCFBK HCPSEI   HCPSET   HCPSWH
    HCPSXV   HCPSYS   HCPSYSCM HCPTRCBK HCPTSABK HCPTSJ   HCPTSR
    HCPTSW   HCPTTA   HCPTTABK HCPTXC   HCPTXCCM HCPTXD   HCPTXE
    HCPTXF   HCPTXJ   HCPTXL   HCPTXO   HCPTXP   HCPTXQ   HCPTXR
    HCPTXS   HCPTXW   HCPTXZ   HCPTXZ$  HCPUSP   HCPUTR   HCPVAI
    HCPVAP   HCPVDEV  HCPVII   HCPVINOP HCPVIS   HCPVLC   HCPVMDBK
    HCPVMN   HCPVPCI  HCPVPLBK HCPVQB   HCPVQU   HCPZDR   HCPZPP
    HCPZSC   HCPZSI   HCP021E  HCP022E  HCP040E  HCP046E  HCP1003E
    HCP1006E HCP1161I HCP1163E HCP1164I HCP1165I HCP1166E HCP120E
    HCP121E  HCP122E  HCP140E  HCP2162I HCP371I  HCP400I  HCP401I
    HCP6000E HCP6240I HCP6241I HCP6790I HCP6806E HCP6818E ID
    IOASSIST LOCATE   MODIFY   MONITOR  MRIODPAC MRIODPAD MRIODPAT
    MRIODPDL MRIODPDS MRIODPDT MRIODPEN MRIODPER MRIODPMD MRIODPOF
    MRIODPON MRMTRDDR MRMTRMEM MRMTRPCI MRMTRSYS MRSCLSRM MRSYTRSG
    PCIF     QUERY    RESET    RPCI     SET      TRFILES  TRSOURCE
    VARY     VARYPCIF VIRTPCIF VIRTUAL  VMRELOCA VPCI
    

Publications Referenced
SC24617505GC24617705SC24617806SC24617905GC24618703
GC24619306SC24619803SC24620805GC24620105 

Fix information

  • Fixed component name

    VM CP

  • Fixed component ID

    568411202

Applicable component levels

  • RA63 PSY UM34402

       UP15/09/22 P 1502

  • R630 PSY UM34343

       UP14/07/17 P 1501

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"630","Edition":"","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
11 December 2017