A fix is available
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":"LOB45","label":"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