IBM Support

PH23044: MQ Z/OS: ABEND5C6-00C5101F IN CSQERADM AND CSQX609E MQCC=2 MQRC=2350 (MQRC_CONN_TAG_NOT_USABLE)

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The MSTR joblog contains the error:
    
    *CSQV086E QUEUE MANAGER ABNORMAL TERMINATION REASON=00C94510
    IEA794I SVC DUMP HAS CAPTURED:
    
    DUMP TITLE=ssid,ABN=5C6-00C5101F,U=SYSOPR  ,C=MQ900.910.CFM -CS
    QERADM,M=CSQGFRCV,LOC=CSQELPLM.CSQERADM+000016EC
    
    Afterwards, the CHIN joblog contained:
    
    CSQX609E CSQXRESP Resources in recovery,
    channel <channel-name>
    MQCC=2 MQRC=2350 (MQRC_CONN_TAG_NOT_USABLE)
    
    ABEND5C6 Reason code 00C5101F means CSQE_Invalid_URState_Rad1.
    It was issued by routine Reconcile_A_UOWD in CSQERADM because
    it found a UOW with:
    - IUWE status = 'NC' = ur_incomplete
    - eMUSE status = eMUSE_begin_in_commit
    
    That is not considered a valid state, because in order to get
    into the ur_incomplete state, a UOW must have gotten to the
    point of committing work and then lost connectivity to a CF
    structure during the commit. The UOW status in the eMUSE
    control block by that point should be eMUSE_in_commit.
    
    However, the update to the eMUSE was lost because connectivity
    to the CSQ_ADMIN structure was lost during commit. The joblog
    from when the queue manager was last running confirms that
    connectivity was lost to the admin structure at the same time
    as the application structures:
    
    CSQE007I CSQESTE EEPLLOSSCONN event received for
     structure CSQ_ADMIN <connection-name>
    IXL016I CONNECTOR <connector> TO STRUCTURE qsgCSQ_ADMIN
     TERMINATING:
     JOB ssidMSTR ASID ssid REQUESTED DISCONNECT REASON=FAILURE.
    CSQE007I CSQESTE EEPLLOSSCONN event received for
     structure <connection-name>
    
    The consistency checks in CSQERADM need to take this situation
    into account.
    

Local fix

  • A ++APAR is available
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 0 Modification 0, Release 1          *
    *                 Modification 0, and Release 2                *
    *                 Modification 0.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Following loss of connectivity to the   *
    *                      administrative CF structure (CSQ_ADMIN) *
    *                      and the queue manager terminating       *
    *                      (either due to system failure or the    *
    *                      setting of the CFCONLOS queue manager   *
    *                      attribute), the queue manager cannot be *
    *                      restarted and abend 5C6 is seen in      *
    *                      CSQERADM with reason code 00C5101F      *
    *                      during restart. If other queue managers *
    *                      remain active in the QSG following the  *
    *                      initial loss of connectivity failure,   *
    *                      peer level recovery for the failed      *
    *                      queue manager's connections to          *
    *                      application structures might fail with  *
    *                      abend 5C6 with reason code 00C5101D in  *
    *                      CSQERWI1.                               *
    ****************************************************************
    If connectivity is lost to the administrative CF structure
    during commit processing, updates to the admin structure might
    fail, causing admin structure entries to indicate the a UOW is
    still in begin commit state, while the UOW has in fact
    progressed to in commit and then UR incomplete state.
    CSQERADM and CSQERWI1 detect this difference in state
    during admin structure reconciliation and peer-level
    recovery respectively, and abend as the situation is unexpected.
    

Problem conclusion

  • CSQERADM and CSQERWI1 are changed to tolerate admin
    structure entries in begin commit state for units of work in UR
    incomplete state.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH23044

  • 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

    2020-03-08

  • Closed date

    2020-11-02

  • Last modified date

    2021-01-04

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

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

    UI71585 UI71586 UI72357

Modules/Macros

  • CSQERADM CSQERWI1
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI71586

       UP20/11/02 P F010 ¢

  • R100 PSY UI71585

       UP20/11/02 P F010 ¢

  • R200 PSY UI72357

       UP20/12/07 P F012 ¢

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.

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"100"}]

Document Information

Modified date:
05 January 2021