APAR status
Closed as program error.
Error description
The runmqras utility did not capture the expected information on Windows. The command output of one or more commands reports an error resolving the command path. The console.log file for runmqras shows: running on Windows Server 2008 error from commonservices: java.net.InetAddress$InetAddressHolder Filestring for class: 'file:\D:\Program%20Files\IBM\WebSphere%20MQ\java\lib\com.ibm.mq .tools.ras.jar!\crtmqras\Registry.class' Filestring for install directory: 'D:\Program%20Files\IBM\WebSphere%20MQ\java\lib\..\..' ... MQ Install Directory = D:\Program%20Files\IBM\WebSphere%20MQ MQ Exe Directory = D:\Program%20Files\IBM\WebSphere%20MQ\bin MQ General Directory = D:\Program Files\IBM\WebSphere MQ ... Found platform=Windows, matches=true MQStringSub:Old Line: "MQ::\bin\dspmqver" MQStringSub:New Line: "D:\Program%20Files\IBM\WebSphere%20MQ\bin\dspmqver" ... ERROR: runCommand: process exitValue = 1
Local fix
Resolved path is now being decoded and cleared of escaped symbols before being used as a command path.
Problem summary
**************************************************************** USERS AFFECTED: IBM MQ users making use of the runmqras utility to collect diagnostic data.	 Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: The runmqras utility contains logic to infer the MQ installation path by interrogating the Java Virtual Machine. This logic is used as a backup mechanism if the installation path cannot be obtained from the environment configuration. When this logic was used, a "%20" string was incorrectly appended to the path in places where there was a space in the name of the folder or file (e.g. D:\Program%20Files\IBM\WebSphere%20MQ). These invalid escape characters caused the runmqras utility to fail to invoke commands from the installation correctly. The same behavior would be seen for any other characters in a directory path which must be escaped in order to be represented as a URI.
Problem conclusion
The resolved path is now being decoded and cleared of escaped symbols before being used as a command path. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v7.5 7.5.0.9 v8.0 8.0.0.8 v9.0 CD 9.0.5 v9.0 LTS 9.0.0.3 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
APAR Information
APAR number
IT22657
Reported component name
WMQ BASE MULTIP
Reported component ID
5724H7241
Reported release
750
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-10-03
Closed date
2017-10-12
Last modified date
2018-08-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
WMQ BASE MULTIP
Fixed component ID
5724H7241
Applicable component levels
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
31 March 2023