IBM Support

SE30965 - MQM400 WMQ CHANNEL PROBLEMS WITH HRTBTINT > 999999

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 WMQ CHANNEL PROBLEMS WITH HRTBTINT > 999999

Error Description

WMQ V5.3 allows a channel Heartbeat Interval to be set to 999  
999 999. If migrating such a channel to WMQV6, the channel      
fails to migrate. STRMQM_R performs the channel migration, does
not report any errors but does report all channels successfully
migrated.                                                      
.                                                              
Also, if at WMQV6, creating a channel or changing a channel to  
have a heartbeat > 999 999 will cause message AMQ8101 WebSphere
MQ error (X'00000FED').                                        
                                                               
Trying to alter or create in MQSC at V6 will give AMQ8412:      
Numeric Range Error.                                            

Problem Summary

****************************************************************
USERS AFFECTED:                                                
All WMQ users on iSeries platform migrating to WMQ V6 and WMQ v6
users specifying a HRTBTINTVL value greater than 999 999 in    
CRTMQMCHL/CHGMQMCHL/CPYMQMCHL commands.                        
                                                               
Platforms affected:                                            
iSeries                                                        
                                                               
****************************************************************
PROBLEM SUMMARY:                                                
The value of the channel parameter HRTBTINTVL can be in the    
range 0-999 999 999 as per the WMQ Documentation and OS/400 Help
"Heartbeat interval (HRTBTINTVL)                                
The possible values are: ...                                    
heart-beat-interval                                            
    Specify a value in the range zero through 999 999 999.      
Note: For implementation reasons, the maximum heartbeat interval
that can be used is 999 999; values exceeding this are treated  
as 999 999.                                                    
A value of zero means that no heartbeat exchanges are to take  
place."                                                        
                                                               
During the CRTMQMCHL/CHGMQMCHL/CPYMQMCHL or migration,          
validation routine checks for the validity of parameters and    
this check fails for HRTBTINTVL parameter if it is more than 999
999, because this is a limitation imposed by the current        
implementation.                                                

Problem Conclusion

Code changes made ensures that all values specified in          
HRTBTINTVL which greater than 999 999  will be treated as 999  
999. As a consequence of this code change, DSPMQMCHL of the    
corresponding channel will show the HRTBTINTVL as 999 999. Same
logic applies to the channels with HRTBTINTVL greater than 999  
999 which undergoes migration to WMQv6.                        
                                                               
Going by the documentation in (MQSC command reference) that says
"MQSC commands provide a uniform method of issuing              
human-readable commands on WebSphere MQ platforms", a user is  
allowed to specify a value up to 999 999 in HRTBTINTVL on the  
runmqsc command prompt.                                        
                                                               
---------------------------------------------------------------
The fix is targeted for delivery in the following PTFs:        
                                                               
                   v6.0                                        
Platform           Fix Pack 6.0.2.4                            
--------           --------------------                        
iSeries            SI31813                                      
                                                               
The latest available maintenance can be obtained from          
'Websphere MQ Recommended Fixes'                                
http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
                                                               
If the maintenance level is not yet available, information on  
its planned availability can be found in 'Websphere MQ          
Planned Maintenance Release Dates'                              
http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
---------------------------------------------------------------

Temporary Fix

Comments

Circumvention


None                                                            

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