IBM Support

SE29770 - MQM400 : Queue manager migration failed with MCH0601 and
channels are missing

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 APAR (Authorized Program Analysis Report)

Abstract

MQM400 : Queue manager migration failed with MCH0601 and
channels are missing

Error Description

Queue Manager migration to WMQv6 failed with MCH0601 and        
channels were missing. The joblog for STRMQM_R reports MCH0601.
                                                               
MCH0601                                                        
Escape   40   06/23/07  14:57:06.073664                        
<EAOHighUse             000364   LIBMQMR_R   QMQM              
*STMT                                                          
From user . . . . . . . . . :   QMQM                            
From Program  . . . . . . . :   stringEAOHighUse                
To module . . . . . . . . . :   AMQRCOBA_R                      
To procedure  . . . . . . . :   rrxMapCDToSelectors            
Statement . . . . . . . . . :   146                            
Message . . . . :   Space offset X'000057CB' or                
X'0000000000000000' is outside current limit for object        
STRMQM_R  MQCMS     802409.                                    

Problem Summary

Queue Manager migration to WMQv6 failed with MCH0601 and        
channels were missing. The joblog for STRMQM_R reports MCH0601.
                                                               
MCH0601                                                        
Escape   40   06/23/07  14:57:06.073664                        
<EAOHighUse             000364   LIBMQMR_R   QMQM              
*STMT                                                          
From user . . . . . . . . . :   QMQM                            
From Program  . . . . . . . :   stringEAOHighUse                
To module . . . . . . . . . :   AMQRCOBA_R                      
To procedure  . . . . . . . :   rrxMapCDToSelectors            
Statement . . . . . . . . . :   146                            
Message . . . . :   Space offset X'000057CB' or                
X'0000000000000000' is outside current limit for object        
STRMQM_R  MQCMS     802409.                                    
                                                               
The function rrxMapCDToSelectors results in MCH0601 during      
migration and leads to migration failure of the queue manager.  
Pre-existing corruption in the channel exit fields of the      
channel on the queue manger being migrated lead to this        
failure.                                                        
                                                               
Before migration, this corruption can be noticed using          
DSPMQMCHL where the channel exit fields will show garbage      
characters.                                                    

Problem Conclusion

MQ has been modified in two parts:                              
                                                               
1. The first part avoids the MCH0601 and logs information about
the corrupted channel names to the Queue manager error log and  
continues with the migration of the remaining healthy channels  
and the other objects. Any channel affected will not be        
migrated.                                                      
                                                               
2. The second part gives an option of forcing a migration of    
any                                                            
channels found corrupted during PART I, but this will throw    
away any valid exit and exit data information from the channel  
which will subsequently need to be manually redefined.          
                                                               
Details of Part I and Part II as follows:-                      
                                                               
Part I                                                          
------                                                          
If WMQ finds corruption in the channel exit fields then it      
stops the migration of that particular channel and logs AMQ8057
                                                               
                                                               
in the Queue manager error logs and continues with the          
                                                               
migration of the healthy channels. The AMQ8057 reports the      
                                                               
channel name and the reason behind the failure i.e. AMQ9517 or  
                                                               
20009517. The error message looks like as below:-              
                                                               
----------------------------------------------------------------
                                                               
07/09/27 12:09:29 - Process(1924.1) User(QMQM) Jobname          
                                                               
(021238/SUPPORT/STRMQM_R  )                                    
                                                               
AMQ8057: Object CHL. Unable to create or replace.              
                                                               
                                                               
                                                               
EXPLANATION:                                                    
                                                               
Cause . . . . . :   While creating or replacing the default    
                                                               
object CHL for WebSphere MQ queue manager QM55 an error        
                                                               
occurred. The error was due to invalid records in the channel  
                                                               
definition file. The error code is 536909079 (X'X'20009517'').  
                                                               
----------------------------------------------------------------
                                                               
                                                               
                                                               
The channel for which AMQ8057 is reported will be missing after
                                                               
                                                               
STRMQM. Channel migration statistics will give the count of the
                                                               
                                                               
channels failed to migrate and the failing channel details can  
                                                               
be found from the logs.                                        
                                                               
                                                               
                                                               
Part II (Optional)                                              
                                                               
-------                                                        
                                                               
Any missing channels can be migrated by adding an environment  
                                                               
variable (AMQ_DROP_EXITS), followed by re-attempt of channel    
                                                               
migration. This will throw away any valid exit or exit data    
                                                               
from these channels and will need to be manually fixed.        
                                                               
                                                               
                                                               
After completing Part I, the steps require to for Part II.      
                                                               
1.) Quiesce the Qmgr.                                          
                                                               
2.) Rename Channel Table file in queue manager library from    
    AMQRFOLD to AMQRFCD4                                        
                                                               
3.) ADDENVVAR ENVVAR(AMQ_DROP_EXITS) VALUE(Y) LEVEL(*JOB)      
                                                               
    ADDENVVAR ENVVAR(AMQ_MIGFORCE_CHANNEL) VALUE(Y) LEVEL(*JOB)
                                                               
4.) Start the Qmgr.                                            
                                                               
5.) Once all the corrupted channels are recovered, remove      
                                                               
    these environment variables using RMVENVVAR command.        

Temporary Fix

Comments

Circumvention


Failure can be circumvented using the steps below:-            

1.) Backup the Qmgr channels using MS03.                        
2.) Take appropriate backup of the Qmgr before attempting the  
    below steps.                                                
3.) If cluster channels involves here then please also consider
                                                               
                                                               
    the extra steps of cluster maintenance.                    
                                                               
4.) Delete all the channels at WMQv5.3 ( ensure none of the    
                                                               
    channels in RUNNING state ) before quiescing the qmgr.      
                                                               
5.) Install WMQv6.0.2.1.                                        
                                                               
6.) Migrate the Qmgr. Check for the WMQ error directory.        
                                                               
7.) Customer will not find any channels in this Qmgr.          
                                                               
8.) End the Qmgr.                                              
                                                               
9.) STRMQM MQMNAME(<Qmgr-name>) RDEFSYS(*YES)                  
                                                               
10.)STRMQM <Qmgr-name>.                                        
                                                               
11.)Recreate the channels using MS03 saved image.              
                                                               
12.)Start the listeners.                                        
                                                               
13.)If qmgr was moved out of cluster for this maintenance then  
                                                               
    bring it back to cluster.                                  
                                                               
14.)Ensure everything is running. If any issues then please    
                                                               
    preserve the WMQ error directory.                          

PTFs Available

R600 SI47898 PTF Cover Letter   1000

Affected Modules

         
         

Affected Publications

Summary Information

Status............................................ CLOSED PER
HIPER........................................... No
Component.................................. 5724H7206
Failing Module.......................... RCHMGR
Reported Release................... R600
Duplicate Of..............................




System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15Q","label":"APARs - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V6R0M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
11 December 2012