IBM Support

PH47782: RECOVER CFSTRUCT FAILS WHEN RECOVERING MANY MESSAGES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Processing of a RECOVER CFSTRUCT command uses storage in the
    queue manager MSTR address space to track messages that are
    being recovered.
    
    If the command is issued for a structure which has held a very
    large number of messages since the last structure backup, the
    storage allocated to RPLE control blocks can exhaust the
    31 bit private storage of the MSTR address space causing the
    structure recovery to fail.
    .
    Additional symptoms and keywords:
    Subpool 229 SP 229 SP229
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 1 Modification 0, Release 2          *
    *                 Modification 0 and Release 3 Modification 0  *
    ****************************************************************
    * PROBLEM DESCRIPTION: When running a RECOVER CFSTRUCT         *
    *                      command for a structure to which        *
    *                      a large number of messages have been    *
    *                      put since the last backup, it's         *
    *                      possible for the RECOVER CFSTRUCT to    *
    *                      fail.                                   *
    ****************************************************************
    Code involved in the recovery of messages from a CFSTRUCT
    uses 31-bit storage to track message recovery. If a
    large number of messages in the CFSTRUCT have not been
    backed up at the time of recovery, the 31-bit storage
    can be exhausted, causing the RECOVER CFSTRUCT to fail.
    

Problem conclusion

  • The code that allocates storage to track message recovery
    has been changed to use 64-bit storage, allowing the
    recovery of large structures.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH47782

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-07-06

  • Closed date

    2023-04-26

  • Last modified date

    2023-07-03

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

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

    UI91565 UI91566 UI91567

Modules/Macros

  • CSQERCF1 CSQERCF2 CSQERRPB
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R100 PSY UI91567

       UP23/06/15 P F306 ¢

  • R200 PSY UI91566

       UP23/06/15 P F306 ¢

  • R300 PSY UI91565

       UP23/06/15 P F306 ¢

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M","label":"IBM MQ"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"100"}]

Document Information

Modified date:
03 July 2023