IT22657: The runmqras utility fails to execute diagnostic commands

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 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