OA59563: SUPPORT FOR NEW Z/VM AGENT MESSAGES TDMF/K

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• New messages will be issued by the z/VM agent for TDMF related
  to the migration of VM page volumes. TDMF/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All z/VM Agent for TDMF users                *
  ****************************************************************
  * PROBLEM DESCRIPTION: New messages will be issued by the z/VM *
  *                      agent for TDMF related to the migration *
  *                      of VM page volumes.                     *
  ****************************************************************
  Before the VM agent for TDMF is swapping amigration source with
  a target volumes both volumes will be quiesced. It was possible
  to specify all active VM page volumes in a single migration
  session. This could effectively lead to the situation that all
  VM page volumes are quiesced at the same time and prevent CP
  from resolving any page faults or page-out operations.
  If the source volume is a VM page volume and a page fault for
  the TDMF server virtual machine requires CP to perform a page-in
  operation from the quiesced volume the VM agent will hang.
  This will also leave the quiesced page volume unusable and will
  probably affect other virtual machines unusable/hanging.
  

Problem conclusion

• The VM agent has been changed to temporarily drain page volumes
  while they get migrated. Additionally the VM agent always keeps
  at least one page volume undrained to cover for the page slots
  which are temporarily unavailable due to the draining of those
  page volumes currently being migrated.
  The VM agent also enures that all page slots residing on a
  page volume it drained will be moved off of those page volumes
  in order to prevent a page fault on its behalf during the time
  the page volume is quiesced.
  Consequently the migration of VM page volumes is serialized and
  require at least 2 page volumes which contain sufficient
  available page slots to cover for the temporary unavailability
  of page volumes drained by the VM agent. The serialization
  implemented for VM page volumes also prevents these volumes to
  be grouped in TDMF volume groups. A volume migration can be
  terminated if the number of used page slots on a migration page
  volume exceeds the number of available slots on other VM page
  volumes.
  

Temporary fix

Comments

APAR Information

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

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

  UJ03169 UJ03170 UJ03171

Modules/Macros

• GTDAVOL  GTDCDDT  GTDMSGN  GTDMSGV  GTDQVOL  GTDRTNV  GTDTVOL
  GTDVUCB
  

Fix information

• Fixed component name

  TDMF Z/OS

• Fixed component ID

  TDMFZOS01

Applicable component levels

• R570 PSY UJ03169

     UP20/06/09 P F006

• R580 PSY UJ03170

     UP20/06/09 P F006

• R590 PSY UJ03171

     UP20/06/09 P F006

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.