PH56833: BACKUP CFSTRUCT KEEPS FAILING WITH CSQE106E CSQELBK1 UNABLE TO BACKUP STRUCTURE STRNAME, REASON=00C50D00

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is unable to backup CF structures. The reason for this
  is because SMDS dataset couldn't be dynamically allocated by
  the queue manager, thus leaving the dataset unavailable and in
  an ALLOCFAIL state. This was indicated by the earlier CSQE222E
  messages with reason code 02540000 when connecting to the
  structure which indicates that the required ENQ was
  unavailable. Unfortunately the cause and duration of the
  SYSZTIOT ENQ contention is often outside of the control of MQ.
  
  At present, the queue manager handles this by automatically
  retrying the allocation request on subsequent attempts to
  access the SMDS, for example following a put or get but not for
  a BACKUP CFSTRUCT. This APAR was raised to extend this
  behaviour for a BACKUP CFSTRUCT. This APAR will result in the
  dynamic allocation also being automatically retried in this
  scenario.
  

Local fix

• Issue the MQ command
    START SMDSCONN(*) CFSTRUCT(structure-name)
  Then issue:
    BACKUP CFSTRUCT(structure-name)
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0,                    *
  *                 Release 3 Modification 0 and                 *
  *                 Release 4 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: When attempting to backup a CF          *
  *                      structure, it is possible to fail       *
  *                      with message:                           *
  *                                                              *
  *                      CSQE106E CSQELBK1 UNABLE TO BACKUP      *
  *                      STRUCTURE STRNAME, REASON=00C50D00      *
  *                                                              *
  *                      This is due to a required SMDS data set *
  *                      not being available. This can occur     *
  *                      due to a failed attempt to dynamically  *
  *                      allocate the data set, indicated by     *
  *                      message CSQE222E with reason code       *
  *                      02540000 which occurs due to a          *
  *                      required ENQ being unavailable. This    *
  *                      may be accompanied by messages          *
  *                      CSQE246I/247I indicating SMDS           *
  *                      STATUS(ALLOCFAIL) and AVAIL(ERROR).     *
  ****************************************************************
  The code that handles a BACKUP CFSTRUCT didn't attempt to
  automatically retry the allocation request. This resulted in the
  BACKUP CFSTRUCT command continuing to fail as the required SMDS
  remained in a failed state.
  

Problem conclusion

• The code has been changed to automatically retry the allocation
  request on subsequent attempts to access the SMDS for a
  BACKUP CFSTRUCT command.
  

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:

  UI98423 UI98424 UI98425

Modules/Macros

• CSQELBK1
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UI98425

     UP24/09/25 P F409

• R300 PSY UI98424

     UP24/09/25 P F409

• R400 PSY UI98423

     UP24/09/25 P F409

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.