VM66433: FLASHCOPY PRESERVE MIRROR AND GLOBAL MIRROR SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This new functionality exploits Flashcopy's preserve mirror
  capability to avoid potential PPRC suspend conditions.
  Flashcopy operations where the source and target devices are
  both PPRC primaries often result in the target device hitting a
  PPRC suspend condition while the data transfers over to the PPRC
  secondary.  Support is also added to allow Flashcopy to Global
  Mirror primary devices.
  

Local fix

• Before this support, customers would have to exploit Flashcopy
  commands via z/OS or ICKDSF to avoid the PPRC suspend
  conditions.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the z/VM FlashCopy Command          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  z/VM's Flashcopy commands do not currently exploit the
  hardware's ability to preserve the mirroring state of the target
  device while the Flashcopy operation completes.  Flashcopy
  to Global Mirror primary devices is also not supported.
  

Problem conclusion

Temporary fix

• FOR RELEASE VM/ESACP/ESAR710 :
  PREREQ: VM66242 VM66112 VM66343
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE VM/ESA CP/ESA R720 :
  PREREQ: NONE
  CO-REQ: NONE
  IF-REQ: NONE
  

Comments

• Support is being added to allow z/VM's FLASHCOPY ESTABLISH and
  FLASHCOPY vdev commands to include Preserve Mirror capability.
  This allows a Flashcopy between two PPRC/Metro Mirror primary
  devices to complete without affecting the PPRC state of the
  target devices.
  
  Flashcopy was also updated to support using Global Mirror
  devices as the target of a Flashcopy relationship.
  
  THE FOLLOWING CHANGES HAVE BEEN MADE TO THE SYSTEM REFERENCE
  LIBRARIES:
  ***START PUBLICATION CHANGE*************************************
  PUBLICATION TITLE: CP Commands and Utilities Reference
  
            RELEASE: 7.2
  
  ORDER NUMBER: SC24-6268-06
  
  -------------------------------------------
  CHAPTER: 2. CP Commands
  PAGE: 462
  ABSTRACT:
  Addition of Preserve Mirror related
  operands to Flashcopy vdev
  BODY:
  Addition of PRESERVemirror and
  NOPRESERVemirror operands and their related
  usage notes.
  
  Addition of the following new messages
  issued by Flashcopy commands:
  
  HCP2471E At least one of the specified
  devices does not support PRESERVEMIRROR.
  Retry the command specifying
  NOPRESERVEMIRROR.
  
  HCP3201E DASD Error: Command Reject
  Message F: Status not as required
  Reason 89: Establish FlashCopy specified a
  preserve mirror operation.  A condition
  prevents the preserve mirror operation from
  being successful. Reason Code Qualifier: rq
  
  -------------------------------------------
  CHAPTER: 2. CP Commands
  PAGE: 474
  ABSTRACT:
  Addition of Preserve Mirror related
  operands to Flashcopy ESTABLISH
  BODY:
  Addition of PRESERVemirror and
  NOPRESERVemirror operands and their related
  usage notes.  New usage notes (identical in
  content also included in FLASHCOPY vdev):
  
  18. If PRESERVemirror and NOPRESERVemirror
      are not specified, the Flashcopy
      operation is attempted first as a
      PRESERVemirror request.  If the first
      attempt fails, the I/O is retried one
      time as a NOPRESERVemirror request.
  
  19. FLASHCOPY to Global Mirror
      (asynchronous PPRC) primary devices is
      supported.
  
  ***END PUBLICATION CHANGE***************************************
  
  ***START PUBLICATION CHANGE*************************************
  PUBLICATION TITLE: CP Messages and Codes
  
            RELEASE: 7.2
  
  ORDER NUMBER: GC24-6270-05
  
  -------------------------------------------
  CHAPTER: 3. System Messages
  PAGE: 539
  ABSTRACT:
  Addition of new message HCP2471E
  BODY:
  HCP2471E At least one of the specified
  devices does not support PRESERVEMIRROR.
  Retry the command specifying
  NOPRESERVEMIRROR.
  
  Explanation
  
  A FlashCopy command was specified with the
  PRESERVemirror operand, but one of the
  specified devices does not support the
  PRESERVemirror feature.
  
  System action
  
  The FlashCopy command does not run. System
  operation continues.
  
  User response
  
  Issue the FlashCopy command again and
  specify the NOPRESERVemirror option.
  -------------------------------------------
  CHAPTER: 3. System Messages
  PAGE: 646
  ABSTRACT:
  Addition of new version of existing message
  HCP3201E
  BODY:
  -DASD Error: Command Reject
  Message F: Status not as required
  Reason 89: Establish Flashcopy specified a
  preserve mirror operation.  A condition
  prevents the preserve mirror operation from
  being successful.  Reason Code Qualifier:
  rq
  
  ***END PUBLICATION CHANGE***************************************
  ×**** PE20/11/13 FIX IN ERROR. SEE APAR VM66477  FOR DESCRIPTION
  

APAR Information

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

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

  UM35762 UM35763

Modules/Macros

• ESTABLIS HCPMES   HCPMESA  HCPMESB  HCPMXRBK HCPNFC   HCPPFC
  HCPSDU   HCP2471E HCP3201E VDEV
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• R710 PSY UM35762

     UP20/10/15 P 2101

• R720 PSY UM35780

     UP20/12/03 P 2101

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.