VM64815: NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HYPERSWAP                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  This APAR provides RAS improvements for z/VM Hyperswap support.
  

Problem conclusion

Temporary fix

• FOR RELEASE VM/ESA CP/ESA R540 :
  PREREQ: VM64709 VM64794 VM64453 VM64814 VM64446 VM64787
  PREREQ: VM64791
  PREREQ: VM64858 VM64830 VM64803 VM64783 VM64698 VM64683
  PREREQ: VM64647
  PREREQ: VM64826 VM64772 VM64449 VM64526 VM64798
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE VM/ESA CP/ESA R610 :
  PREREQ: VM64709 VM64794 VM64814 VM64787 VM64791 VM64858
  PREREQ: VM64830
  PREREQ: VM64803 VM64783 VM64698 VM64683 VM64647 VM64826
  PREREQ: VM64772
  PREREQ: VM64780 VM64798
  CO-REQ: NONE
  IF-REQ: NONE
  

Comments

• The following RAS improvements have been made:
  
  The HYPerswap command has been enhanced to add the INCLUDE and
  EXCLUDE functions.  The INCLUDE function indicates the devices
  can be automatically quiesced on a missing interrupt condition.
  The numMIH parameter specified on the INCLUDE function
  indicates the number of times missing interrupt recovery will
  take place before a HyperSwap is initiated by an automatic
  quiesce.  The EXCLUDE function indicates a missing interrupt
  condition will not trigger an automatic quiesce for the
  specified devices.  The default for all DASD is that MIH would
  would not trigger an automatic quiesce.  The QUERY HYPERSWAP
  command has been updated to include the MIH trigger information.
  
  HYPERSWAP ENABLE, INCLUDE, QUIESCE, and SWAP are not allowed for
  a static Parallel Access Volume (PAV) or HyperPAV base device
  with a guest dedicated or guest exploited alias configuration.
  For a base PAV, this means the specified RDEV/VOLID is either
  dedicated to a guest with at least one alias associated with
  the base PAV also dedicated to the guest or is system attached
  and has one or more alias PAVs defined using DEFINE PAVALIAS,
  DASDOPT PAVALIAS, or MINIOPT PAVALIAS. For a base HyperPAV,
  this means the RDEV/VOLID is either dedicated to a guest with
  at least one alias associated with the base HyperPAV also
  dedicated to the guest  or is system attached and has one or
  more alias HyperPAVs defined using DEFINE HYPERPAVALIAS which
  reside in the same  pool as the specified base HyperPAV.
  Message HCP6429E has been added for this condition.
  
  An alias HyperPAV or alias PAV device can no longer be
  specified on the HYPERSWAP command.  Message HCP6428I has been
  added for this condition.
  
  When HYPERSWAP SWAP and RESUME is issued, we will ensure the
  same number of aliases for the target are already online and
  attached to SYSTEM, or we will attempt to bring free/offline
  alias devices online and attach them to SYSTEM until the number
  of aliases matches the current configuration or we run out of
  aliases.
  
  HYPERSWAP RESUME has been updated to ensure all I/O is
  resumed in the correct order and in as timely a manner as
  possible.
  
  The ATTACH, DEFINE PAVALIAS and DEFINE HYPERPAVALIAS commands
  have been changed.  PAV alias devices cannot be
  attached to a guest while the associated base device is
  quiesced for HyperSwap.  HyperPAV alias devices cannot be
  attached to a guest while any base device in the HyperPAV pool
  is quiesced for HyperSwap.  PAV alias devices cannot be DEFINED
  for a guest while the associated base device is quiesced for
  HyperSwap.  HyperPAV alias devices cannot be DEFINED for a
  guest while any base device in the HyperPAV pool is quiesced
  for HyperSwap.  Message HCP6430E has been added for the above
  conditions.
  
  HCPHOTBX and its callers were modified to add improved
  reasons for the boxing of the device for the SVMR LOGREC
  record. This will improve debug in determining the reason
  a device was boxed.
  
  New wait state 9060 has been added.  This wait state will be
  loaded when a CP abend or SHUTDOWN occurs during Hyperswap
  processing (after the first device has been quiesced and before
  the last device is resumed).  It is unknown how many devices,
  if any have been swapped, no dump is taken and no checkpoint
  information is written.  If there is dedicated dump space, a
  system restart can be used to obtain a dump. Otherwise, a
  stand-alone dump must be taken. The system will be restarted by
  GDPS which will IPL the system with the correct volumes.
  
  A new reason, "NON-DEDICATED DUMP SPACE DURING HYPERSWAP" has
  been added to message HCP9250E.  This is when the system is
  unable to generate an abend dump during Hyperswap processing
  because the available dump space is non-dedicated.
  
  The help files for the associated documentation updates are
  shipped with this APAR.  The z/VM 6.1.0 publication changes
  can also be viewed at the z/VM web site:
     http://www.vm.ibm.com/library/
  The z/VM 5.4.0 publication changes are the same as the z/VM
  6.1.0 publication changes.
  ž**** PE11/12/13 FIX IN ERROR. SEE APAR VM65102  FOR DESCRIPTION
  

APAR Information

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

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

  UM33236 UM33237 UM33238 UM33239 UM33240

Modules/Macros

• ATTACH   CPSYNCHK DEFINE   HCPATD   HCPATR
  HCPCDT   HCPCPN   HCPCUIBK HCPCWB   HCPDDP   HCPDFN   HCPDIO
  HCPDMP   HCPDPD   HCPDTD   HCPERR   HCPGER   HCPHOT   HCPHPV
  HCPIFI   HCPIIO   HCPIOJ   HCPIORBK HCPIQM   HCPMDT   HCPMES
  HCPMESA  HCPMESB  HCPMESE  HCPMHT   HCPMSS   HCPMXRBK HCPOM1
  HCPPAV   HCPPRF   HCPRDEV  HCPRFC   HCPRP    HCPSDV   HCPSPC
  HCPSRB   HCPSTDBK HCPSUB   HCPSYS   HCPSYSCM HCPSZP   HCPTDD
  HCPVDS   HCPWRP   HCPWRPBK HCPZPP   HCPZSF   HCPZSR   HCP6428I
  HCP6429E HCP6430E HCP9060W HCP9250E HYPERSWA SVMREC
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• RA54 PSY UM33236

     UP11/04/11 P 1101

• RA61 PSY UM33239

     UP11/07/22 P 1101

• RE54 PSY UM33237

     UP11/04/11 P 1101

• R540 PSY UM33238

     UP10/11/03 P 1101

• R610 PSY UM33240

     UP10/11/03 P 1101

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.