Product Documentation
Abstract
This document contains migration APARs for IBM MQ for z/OS.
Content
How to use these tables:
1. This is a list of recommended fixes for customers planning to migrate between versions of IBM MQ for z/OS.
2. For clarity, if a PTF is PE or superseded, only the fixing or superseding PTF is listed.
3. Please read the full APAR text carefully as many of these fixes need to be applied before migration to the new release.
4. As a general rule, you should apply all the PTFs listed for the release to which you are migrating and, if you also need to fall back, then all the PTFs listed for your current release.
LAST UPDATE: 19th September 2025
1. This is a list of recommended fixes for customers planning to migrate between versions of IBM MQ for z/OS.
2. For clarity, if a PTF is PE or superseded, only the fixing or superseding PTF is listed.
3. Please read the full APAR text carefully as many of these fixes need to be applied before migration to the new release.
4. As a general rule, you should apply all the PTFs listed for the release to which you are migrating and, if you also need to fall back, then all the PTFs listed for your current release.
LAST UPDATE: 19th September 2025
Note: The fixes for IBM MQ for z/OS V9.4.0 are currently under development. This table is provided for customer awareness, and updates will be made as fixes become available.
|
Migration APARs for IBM MQ for z/OS V9.4.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
PH65347
|
25/06/18
|
HIPER
|
Application puts to QSGDISP(SHARED), clustered queues start failing with MQRC_EXPIRY_ERROR after migrating to IBM MQ 9.4. Altering the queue description will resolve the problem. | ||
|
PH65320
|
25/03/28
|
HIPER
|
A memory leak when using dynamic queues after enabling STATQ. Each open of a dynamic queue leaks ~900 bytes of 64-bit private memory. Can be worked around by disabling STATQ at either the QMGR or QUEUE level. | ||
|
PH65348
|
25/04/15
|
An S0C4 abend in load module CSQXBNTM when CHINIT trace is enabled and trace route messages are routed through the CHIN. | |||
|
PH65143
|
25/06/27
|
CHIN startup fails with an S5C6-00E7000F abend. The error condition which results in this abend would have resulted in message CSQX571E during CHIN startup at earlier releases. | |||
|
PH65546
|
25/07/03
|
HIPER
|
Puts to a QSGDISP(SHARED) queue on a V9.4 queue manager will not honor a custom capexpry value from the queue if it was set by a queue manager running an earlier version of MQ. Altering the queue from a V9.4 queue manager will resolve the issue. | ||
|
PH65835
|
25/05/08
|
MQCONN with blank queue manager name fails MQCC_FAILED MQRC_Q_MGR_NOT_AVAILABLE when called from a channel exit after migrating to 9.4. | |||
|
PH65669
|
TBC
|
Certain API calls fail with an S5C6-EBEBEBED abend when an application using the V940 libraries connects to a pre-V940 QMGR. | |||
|
PH65916
|
25/05/30
|
CSQ1LOGP EXTRACT abends S0C4 when processing a message with message properties when certain message headers are in a different CCSID. If there is no requirement to replay messages with message properties, then an older version of CSQ1LOGP can be used instead. | |||
|
PH65886
|
25/04/22
|
The CHIN cluster repository manager abends S0C4 in CSQXRFXC when a queue or topic is defined multiple times in the cluster with different QSGDISP. | |||
|
PH66518
|
25/05/30
|
HIPER
|
Queues that have, or previously had, CUSTOM(CAPEXPRY(xx)) set can revert to an previously set value, leading to messages expiring unexpectedly, or failing to expire when expected. | ||
|
PH67117
|
25/08/01
|
FFST occur in xcsWaitThreadEvent followed by a TLS channel ending abnormally when a client initiates an SSL key reset. | |||
|
PH67086
|
25/08/20
|
An S0C4 abend occurs in CSQAVICM when a channel puts a message with a little-endian MQIMSVS message header. | |||
|
PH67216
|
25/08/07
|
Running channels cannot be adopted by a newer instance, and any other attempt to do so fails with CSQX514E. | |||
|
PH65320
|
25/03/28
|
HIPER
|
A storage leak is caused by Queue Statistics creating and not deleting STATQ blocks for Dynamic Queues when a model queue is opened. | ||
|
PH65348
|
25/04/15
|
An 0C4 abend may occur when putting a trace route message to a queue with CHINIT trace enabled. | |||
|
PH65546
|
25/07/03
|
HIPER
|
A queue defined at version 9.3.0 or earlier with a CAPEXPRY value set, would apply the CAPEXPRY value to messages put to the queue via a version 9.3.0 queue manager, but not to messages put to the queue from a 9.4.0 queue manager. | ||
|
PH67852
|
25/08/28
|
Attempts to connect to a queue manager from an application server using the MQ resource adapter can fail due to exception MQJCA1011. Trace and/or linked exceptions show the failure is due to an unexpected MQRC_HCONN_ERROR (MQRC2018). | |||
|
PH67912
|
TBC
|
FFST and SNAP output are being issued for reason BPHDR_LOWER_BOUNDARY_ERROR due to a memory error. An FFST can also be generated with error rrcE_BAD_DATA_RECEIVED. | |||
|
PH67963
|
TBC
|
CSQ1LOGP EXTRACT jobs show 5C6-00F10019 abends. | |||
|
PH68154
|
TBC
|
DISPLAY TPSTATUS('#') fails with CSQU053E when issued from CSQUTIL utility. | |||
|
Migration APARs for IBM MQ for z/OS V9.3.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
23/04/18
|
UI91476
|
After migration to IBM MQ 9.3, CSQ1LOGP EXTRACT(YES) jobs abend 0C1 if CSQCMT, CSQBACK and CSQINFLT DD statements are not used. | |||
|
22/08/23
|
HIPER
|
2210
|
Message CSQO096E issued when interacting with queues in the MQ panels. Message CSQU053E issued when using CSQUTIL COMMAND or SDEFS. SDEFS MAKEDEF output has ACCTQ(QMGR) and CLWLUSEQ(QMGR) for migrated queues. Migrated queues have CLWLUSEQ reset to QMGR after being altered. | ||
|
Migration APARs for IBM MQ for z/OS V9.2.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
21/08/19
|
HIPER
|
2110
|
CSQM095I message and MQRC 2008, MQRC_CHAR_ATTRS_TOO_SHORT received for a SVRCONN channel when doing a backward migration from IBM MQ 9.2. | ||
|
21/06/30
|
HIPER
|
2108
|
After migration to IBM MQ 9.2 MQOPEN, MQPUT and MQPUT1 for cluster objects might take 10 seconds to complete on full repositories (symptoms externally similar to PH34589). | ||
|
21/04/12
|
Doc APAR
|
At IBM MQ 9.2.0, users can no longer bypass protocol selections by directly specifying a Hex Cipher value for SSLCIPH for an IBM MQ channel | |||
|
21/03/10
|
2104
|
On IBM MQ 9.2 messages CSQX207E, CSQX504E TYPE=0000000B DATA=00000000, and CSQX053E occur for back-level SSL client connections. |
|||
|
21/03/10
|
HIPER
|
2104
|
Potential clustering performance problem following migration to IBM MQ 9.2 on z/OS. | ||
|
21/01/27
|
2106
|
When running CSQUTIL SCOPY against a pageset with non-empty queues defined at earlier versions of IBM MQ, an abend 0C4 occurs. |
|||
New: Backward migration option
After migrating to IBM MQ for z/OS 9.2.0 LTS or IBM MQ for z/OS 9.2.0 CD, from either IBM MQ for z/OS 9.0.0 or IBM MQ for z/OS 9.1.0, you can backward migrate, or fallback, to the version you were using prior to migration, using the BACKMIG option on the START QMGR command.
This new option means that backward migration/compatibility APARs are not required for the version being migrated from. Backwards migration is not supported for a CD release such as IBM MQ for z/OS 9.1.5.
For information on how to revert to a previous version of a z/OS queue manager read this IBM Documentation link.
|
Migration APARs for IBM MQ for z/OS V9.1.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
18/09/11
|
Various problems encountered in the QMGR and CHIN late in the final test cycle. Fix needed for stability and migration | ||||
|
18/08/30
|
Various problems encountered in the QMGR and CHIN late in the final test cycle. Required for enablement of cluster workload exit | ||||
|
Migration APARs for IBM MQ for z/OS V9.0.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
18/03/29
|
BACKWARDS MIGRATION FROM V910 AND COEXISTENCE WITH V910 | ||||
|
16/08/12
|
HIPER
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR AND CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY AND MIGRATION | |||
|
Migration APARs for IBM MQ for z/OS V8.0.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
18/03/29
|
BACKWARDS MIGRATION FROM V910 AND COEXISTENCE WITH V910 | ||||
|
16/08/10
|
BACKWARDS MIGRATION FROM V9 AND COEXISTENCE WITH V9 | ||||
|
15/08/21
|
WMQ 800 SAMPLE MEMBER CSQ45MQS REQUEST FOR A COMMENT UPDATE | ||||
|
15/06/15
|
AN INVALID DEFPUTRESPONSE FIELD IN CLUSTERED QMGR ALIASES | ||||
|
15/03/31
|
IBM MQ V8: SECURITY EXIT CSQ4BCX3 ABEND S0C4-10 AFTER MIGRATION | ||||
|
15/01/29
|
WMQ V8.0 Z/OS: PROVIDE A SERVICE PARAMETER TO AVOID EXTRA CHECKING CAUSING CSQX631E FOR DATAPOWER SSL CONNECTIONS | ||||
|
14/09/02
|
HIPER
|
1410
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR AND CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY AND MIGRATION | ||
|
Migration APARs for Websphere MQ for z/OS V7.1.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
16/08/10
|
BACKWARDS MIGRATION FROM V9 AND COEXISTENCE WITH V9 | ||||
|
16/01/14
|
WMQ UNABLE TO GET V7 MESSAGE AFTER BACKWARDS MIGRATION FROM V8.0 TO V7 | ||||
|
15/05/28
|
AN INVALID DEFPUTRESPONSE FIELD IN CLUSTERED QMGR ALIASES | ||||
|
14/11/19
|
HIPER
|
CSQY291E CSQWDSDM SDUMPX FAILED, RC=B08 5C6-00C94300 DMC-CSQIRRSI,M=CSQGFRCV, LOC=CSQ This APAR fixes PE'd APAR PI14223 Note: UI22852 does not supersede UI21877 so both are required |
|||
|
14/09/30
|
CSQM095I +MQOX CSQMAQLC QLOCAL QSGDISP(SHARED) ALREADY EXISTS This APAR fixes PE'd APAR PI19721 |
||||
|
14/10/02
|
BACKWARDS MIGRATION FROM V8 AND COEXISTENCE WITH V8 | ||||
|
12/04/30
|
1209
|
V710 CSQ5PQSG MIGRATE DSG/QSG incorrectly reporting that the DSG is ready to be migrated |
|||
|
12/03/21
|
HIPER
|
1204
|
Repackaging PTFs for APAR PM55455 due to shipping error This APAR fixes PE'd APAR PM55455 |
||
|
HIPER
|
1204
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR AND CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY AND MIGRATION | |||
|
Migration APARs for Websphere MQ for z/OS V7.0.1
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
14/09/30
|
CSQM095I +MQOX CSQMAQLC QLOCAL QSGDISP(SHARED) ALREADY EXISTS This APAR fixes PE'd APAR PI19721 |
||||
|
14/10/02
|
BACKWARDS MIGRATION FROM V8 AND COEXISTENCE WITH V8 | ||||
|
13/10/31
|
1403
|
WMQ abend 5C6 00D10345 on Queue Manager startup after upgrade ABN=5C6-00D10345 RLMC-CSQJLGR M=CSQJRE01,LOC=CSQJL002.CSQJR003 | |||
|
12/03/07
|
1206
|
701 BACKWARDS MIGRATION FROM 710 AND COEXISTENCE WITH 710 | |||
|
11/05/18
|
1106
|
Enhancement to aid migration of applications using messages that contain RFH2 headers. | |||
|
10/03/31
|
1005
|
ABN=5C6-00C90D05 occurs in CSQIMGE5 for an MQGET of a message that is greater than 4K with an MDE or V2 MQMD and that was put to the queue when the queue manager was running MQ V6 | |||
|
09/10/15
|
HIPER
|
0911
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR AND CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY | ||
|
Migration APARs for Websphere MQ for z/OS V7.0.0
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
|
08/11/20
|
1003
|
FIX REQUIRED FOR BACKWARD MIGRATION FROM AND COEXISTENCE WITH WEBSPHERE MQ FOR Z/OS V7.0.1 | |||
|
08/08/01
|
HIPER
|
0809
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR AND CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY | ||
|
09/03/09
|
HIPER
|
0906
|
DISPLAY QCLUSTER(*) ALL DISPLAYS INCORRECT ALTDATE, ALTTIME AND CLUSQMGR INFORMATION AFTER MIGRATION FROM WMQ V6 TO V7 |
||
|
09/06/30
|
0912
|
FIX REQUIRED FOR MIGRATION DIRECTLY FROM VERSION 531 TO 700 | |||
|
09/07/31
|
0909
|
APAR TO INCLUDE HOLD INFORMATION FOR UK47861 | |||
|
Migration APARs for Websphere MQ for z/OS V6
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
RSU level
|
Description/comments
|
| MESSAGES IN SYSTEM.DURABLE.SUBSCRIBER.QUEUE REMAIN IN THE PAGE SET DURING BACKWARDS MIGRATION PROCESSING | |||||
|
1206
|
600 BACKWARDS MIGRATION FROM 710 AND COEXISTENCE WITH 710 | ||||
|
11/09/07
|
HIPER
|
1110
|
WMQ: A LOOP OCCURS IN CSECT CSQ5ROBJ OF LOAD MODULE CSQ5LPLM | ||
|
08/09/11
|
1109
|
TITLE=CSQ1,ABN=5C6 00D10301 U=SYSOPR ,C=L8200.600.RLMC- CSQJOLGR,M=CSQJRE01,LOC=CSQJL002.CSQJR001+ |
|||
|
08/09/11
|
1109
|
CSQ1,ABN=5C6-00C91600,U=SYSOPR, CSQIERS3, M=CSQGFRCV, LOC=CSQILPLM.CSQIERS3 | |||
|
08/09/11
|
0810
|
MQ SHOULD DISCARD INVALID CLUSTER SUBSCRIPTIONS WITH GARBAGE QMGR NAMES | |||
|
08/11/20
|
1003
|
FIX REQUIRED FOR BACKWARD MIGRATION FROM AND COEXISTENCE WITH WEBSPHERE MQ FOR Z/OS V7.0.1 | |||
|
08/11/20
|
0903
|
FIX REQUIRED FOR BACKWARD MIGRATION FROM WEBSPHERE MQ FOR Z/OS V7 | |||
|
08/11/20
|
0903
|
FIX REQUIRED FOR COEXISTENCE OF V7 AND V6 QMGRS IN A QSG | |||
|
05/07/15
|
HIPER
|
0508
|
VARIOUS PROBLEMS ENCOUNTERED IN THE CHIN LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY | ||
|
05/07/06
|
HIPER
|
0508
|
VARIOUS PROBLEMS ENCOUNTERED IN THE QMGR LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY | ||
|
05/07/04
|
HIPER
|
0508
|
VARIOUS PROBLEMS ENCOUNTERED IN THE JAVA FEATURE LATE IN THE FINAL TEST CYCLE. FIX NEEDED FOR STABILITY | ||
|
Migration APARs for Websphere MQ for z/OS V5.3.1
|
|||||
|
APAR
|
CLOSE
DATE yy/mm/dd |
PTF #
|
HIPER or SPEC/ATTN
|
Description/comments
|
|
|
07/03/20
|
0705
|
AFTER POR, RECOVERY OF AN APPLICATION STRUCTURE MAY NOT COMPLETE UNTIL AFTER AN EXTRA RECYCLE OF THE QUEUE 07/03/16 PTF PECHANGE NOTE: This APAR fixes a second error in fallback APAR PK16673 |
|||
|
06/03/20
|
HIPER
|
0605
|
ABN=5C6 00C5103A LOC=CSQELPLM.CSQEQSR1+111A NOTE: This APAR fixes error in fallback APAR PK16673 |
||
|
05/07/04
|
0512
|
FIX REQUIRED FOR WMQ V5 QMGRS USING SSL TO COEXIST WITH WMQ V6 QMGRS. | |||
|
05/11/17
|
0512
|
FIX REQUIRED FOR BACKWARD MIGRATION FROM WEBSPHERE MQ FOR Z/OS V6. | |||
|
05/01/28
|
SPEC/ATTN
|
0509
|
FIX REQUIRED FOR COEXISTENCE OF V6 AND V5.3 QMGRS IN A QSG. | ||
|
04/02/23
|
DOC only
|
SYSTEM.CLUSTER.REPOSITORY.QUEUE SHOULD HAVE AN INDXTYPE OF CORRELID FOR MQ V5 | |||
|
03/09/29
|
0403
|
START CHINIT RECEIVED CSQX027E XXXX CSQXREPO UNABLE TO GET STORAGE, RC=00000004. | |||
|
PQ75075
|
03/09/03
|
HIPER
|
0310
|
CSQX112E REASON=0C4 WHEN STARTING MQ APPC CHANNEL AFTER UPGRADE OF QMGR FROM V5.3 TO V5.3.1 | |
|
03/05/01
|
0309
|
ABEND 0C4 (00000011) IN MQCHIN CSQXPRCR AFTER MIGRATION TO 5.3.1. | |||
Click [here] to return to the summary page.
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"ARM Category":[{"code":"a8m0z00000008MVAAY","label":"Install-\u003EUpgrade"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"8.0.0;9.0.0;9.1.0;9.2.0;9.3.0;9.4.0"},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Component":"APAR \/ Maintenance","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"9.1;9.0;8.0;7.1;7.0.1;7.0;6.0;5.3.1","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]
Product Synonym
IBM MQ; WMQ; WebSphere MQ
Was this topic helpful?
Document Information
Modified date:
14 October 2025
UID
swg27006519