IBM Support

IT22657: The runmqras utility fails to execute diagnostic commands

Subscribe

You can track all active APARs for this component.

 

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":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 August 2018