IBM Support

PI38522: WEBSPHERE MQ ON ZOS: STATE OF CFSTRUCT INCORRECTLY SET TO INRECOVER.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If the automatic recovery processing detects a structure in
    FAILED status, it schedules another attempt to recover the
    structure.
    If the automatic recovery fails for any reason, the CFSTRUCT
    status remains in INRECOVER state instead of being set back to
    FAILED status.
    As consequence any further RECOVER CFSTRUCT commands fail due to
    the incorrect state.
    

Local fix

  • run following command to set manually the state to FAIL:
    
       RESET CFSTRUCT(struct_name) ACTION(FAIL)
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 1 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: A failed structure is left in           *
    *                      STATUS(INRECOVER) following abends      *
    *                      while attempting to recover the         *
    *                      structure, leading to subsequent        *
    *                      attempts to recover the structure       *
    *                      failing with error:                     *
    *                      "CSQE102E xxxx CSQERCFS Unable to       *
    *                      recover structure struc-name, not in    *
    *                      failed state".                          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    After an initial failure to recover the structure, RECOVER
    CFSTRUCT was called to attempt recovery again, however it
    failed before resetting status flags in the BRCB.
    During recovery from the failure, CSQERRPB checked the BRCB
    flags, and incorrectly determined that it did not need
    to reset the structure state back to FAILED. This caused
    the status to be left in INRECOVER.
    

Problem conclusion

  • CSQERCF1 and CSQERCFT have been changed to initialise the BRCB
    status flags earlier in structure recovery processing, closing
    the window where CSQERRPB could fail while the flags still
    represented the state of the previous structure recovery
    attempt.
    100Y
    CSQERCFT
    CSQERCF1
    CSQERRPB
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PI38522

  • Reported component name

    WMQ Z/OS V7

  • Reported component ID

    5655R3600

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-04-07

  • Closed date

    2015-04-27

  • Last modified date

    2015-07-01

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

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

    PI39528 UI27087

Modules/Macros

  • CSQERCFT CSQERCF1 CSQERRPB
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R100 PSY UI27087

       UP15/06/04 P F506 ¢

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 July 2015