PI95765: MULTI-LPAR RESTORE AND OFFLOAD FAILS WITH ENQ_SYSTEMS ERR FOR CA-MIM ENVIRONMENT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In a CA-MIM 12.5 environment, when performing a MULTI-LPAR SLB
  Restore of Offload the user receives the
  ARY#RIO TASK nn ENQ_SYSTEMS ERR message.
  During MULTI_LPAR processing to avoid a UCB scan issue ARY
  obtains a series of enqueues; STEP, SYSTEM, and SYSTEMS.
  When GRSRNL=EXCLUDE (i.e. - CA-MIM 12.5 environment) GRS
  changes a SCOPE=SYSTEMS to a SCOPE=SYSTEM.  Because of this,
  we effectively enqueue on SCOPE=SYSTEM twice.
  The second SCOPE=SYSTEM receives a RC=8 (i.e. - this task
  already requested an enqueue on this resource).
  When CA-MIM processes the SCOPE=SYSTEMS, it propogates the
  request even though the calls receives a RC=8.  So the fix
  is to ignore RC=8 because the call does get propogated and
  in this case does not indicate an error.
  Note: This bugfix resolves the issue in a CA-MIM 12.5
  environment only.  Recovery Expert does not support releases
  of CA-MIM before 12.5.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM Db2 Recovery Expert z/OS.       *
  ****************************************************************
  * PROBLEM DESCRIPTION: In a CA-MIM 12.5 environment, when      *
  *                      performing a MULTI-LPAR SLB Restore of  *
  *                      Offload the user receives the ARY#RIO   *
  *                      TASK nn ENQ_SYSTEMS ERR message.        *
  *                      During MULTI_LPAR processing to avoid   *
  *                      a UCB scan issue ARY obtains a series   *
  *                      of enqueues; STEP, SYSTEM, and SYSTEMS. *
  *                      When GRSRNL=EXCLUDE (i.e. - CA-MIM      *
  *                      12.5 environment) GRS changes a         *
  *                      SCOPE=SYSTEMS to a SCOPE=SYSTEM.        *
  *                      Because of this, we effectively         *
  *                      enqueue on SCOPE=SYSTEM twice.          *
  *                      The second SCOPE=SYSTEM receives a      *
  *                      RC=8 (i.e. - this task already          *
  *                      requested an enqueue on this resource). *
  *                      When CA-MIM processes the               *
  *                      SCOPE=SYSTEMS, it propogates the        *
  *                      request even though the calls receives  *
  *                      a RC=8.  So the fix is to ignore RC=8   *
  *                      because the call does get propogated    *
  *                      and in this case does not indicate an   *
  *                      error.                                  *
  *                      Note: This bugfix resolves the issue    *
  *                      in a CA-MIM 12.5                        *
  *                      environment only.  Recovery Expert      *
  *                      does not support releases               *
  *                      of CA-MIM before 12.5.                  *
  ****************************************************************
  * RECOMMENDATION: APPLY the PTF.                               *
  ****************************************************************
  Code has been changed to correct this condition.
  

Problem conclusion

• APPLY the PTF.
  

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:

Modules/Macros

•    ARY$BPAU
  

Fix information

• Fixed component name

  DB2 REC EXPERT

• Fixed component ID

  5697H7400

Applicable component levels

• R320 PSY UI56490

     UP18/06/21 P F806

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.