OA48281: IOSHM0308I PPRC SUSPENSION DETECTED FOR REPLICATION SESSION RUN FAILED. REASON: 0000 15/07/24 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• For a PPRC suspension event, the run (or unfreeze) actions for a
  Basic HyperSwap session with "Stop: no" defined will fail.  This
  can leave PPRC primary devices in an extended long busy state
  until the ELB timer expires, which blocks all I/O to those
  devices for that time.
  
  PE Information:
  
  User's Affected: This problem affects HyperSwap configurations
  defined from TPC-R sessions of type Basic HyperSwap, with
  OA44240 applied (PTF UA90740 (HBB7780) or UA90741 (HBB7790)).
  
  Users with session type "Metro Mirror with HyperSwap", "Metro
  Global Mirror with HyperSwap", and "Metro Global Mirror with
  Practice and with HyperSwap" are unaffected.
  
  User Impact:
  APAR OA44240 provided new functions but introduced a
  new problem as described above. Customers are
  better off with keeping APAR OA44240 on their systems
  for the following reasons:
  - The new problem is experienced only by customers that
  use HyperSwap configurations of Basic HyperSwap type
  (FreezeAll: No, Stop: No). The problem can be resolved
  with ++APARs that can be obtained from IBM L2 Support.
  - APAR OA44240 provided infrastructure updates to
  IOS and Basic HyperSwap to allow new enhancements
  such as Multi-Target PPRC and other IOS functions.
  - Since the updates in APAR OA44240 have been used
  as the basis for other IOS enhancements, removing
  the PTFs for APAR OA44240 would require the
  removal of other PTFs as well.
  
  Local Fix:
  ++APARs are available from IBM L2 Support.
  
  EXTERNAL SYMPTOMS:
  SYSLOG will show the following
    IOSHM0501I Response from API for FC = 18, RC = 83, Rsn = 0
    IOSHM0308I PPRC suspension detected for replication session
    xxxx
               Run failed. Reason: 0000
    IOSHM0819I Configuration xxxx is not preferred for HyperSwap
  
  VERIFICATION STEPS:
   - Verify the HyperSwap settings from D HS,STATUS.  This problem
     can occur in a session with "FreezeAll: No" and "Stop: No".
   - Verify that a Run was attempted but failed after a PPRC
     suspension event. The PPRC suspension events will be seen
     with messages such as IEA494I or IEA075I
  

Local fix

• In preparation of this type of problem occurring, a Basic
  HyperSwap user can define a DSCLI script to:
   - suspend all PPRC pairs in order to prevent additional ELB
     conditions from being raised.  This can be perfomed using the
     pausepprc command.
   - unfreeze all PPRC primary devices, to clear ELB conditions
     that were already raised.  This can be performed using the
     unfreezepprc command.
  
  For pausepprc and unfreezepprc syntax examples, please refer to
  "IBM DS8870 Copy Services for IBM z Systems" (SG24-6787-07)
  section 20.4.3 "Managing a Metro Mirror environment with DS CLI"
  
  This script should be run at the user's discretion if this
  problem is encountered, in order to minimize the I/O user impact
  time.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users at HBB7780 and above with PTFs         *
  *                 UA90740, UA90741 or UA90742 applied and      *
  *                 using Basic HyperSwap only mode              *
  *                 (FreezeAll=No). GDPS users are not affected  *
  *                 by this issue.                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a configuration is in Basic        *
  *                      HyperSwap mode (FreezeAll=No),          *
  *                      UnFreeze is not performed after a PPRC  *
  *                      suspension event. MSGIOSHM0501I with    *
  *                      RC = 83 and MSGIOSHM0308I with          *
  *                      Reason: 0000 are issued.                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Multi-target PPRC support (OA44240) introduced a configuration
  name in the parameter block that is to be used for a HyperSwap
  API request. When a PPRC suspension is detected, an UnFreeze
  is issued to the suspended LSS by sending the request to the
  HyperSwap API. However, a configuration name and the offset
  to the PPRC array is not being set. The UnFreeze request is
  skipped because no matching configuration can be found for the
  uninitialized configuration name. The following messages will
  be issued:
   IOSHM0501I Response from API for FC = 18, RC = 83, Rsn = 0
   IOSHM0308I PPRC suspension detected for replication session xxx
              Run failed. Reason: 0000
  
  Additionally, PPRC query continues to be issued to secondary
  devices after the PPRC suspension which will show the session
  remains full duplex.
  

Problem conclusion

• Processing is updated to set the configuration name and the
  offset to the PPRC array in the HyperSwap API parameter block.
  
  PPRC query for Basic HyperSwap configuration will be issued
  to both primary and secondary devices so that correct session
  status can be determined.
   KEYWORDS: HYPERSWP/K
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UA79249 UA79250 UA79251

Modules/Macros

• IOSHMCMT IOSHMEPT
  

Fix information

• Fixed component name

  IOS

• Fixed component ID

  5752SC1C3

Applicable component levels

• R7A0 PSY UA79249

     UP15/10/14 P F510 ®

• R780 PSY UA79250

     UP15/10/14 P F510 ®

• R790 PSY UA79251

     UP15/10/14 P F510 ®

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.