IBM Support

IT18131: runmqras fails when '$' character present in the MQ install or data path

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Running the runmqras tool against an MQ 7.5 installation on
    Windows results in
    a error which shows:
    
     Running on Windows
     Executing command: net | find
     Processing File: *.log
     error: crtmqras: error: XML parser has failed: Illegal group
    reference
    
    java.lang.IllegalArgumentException: Illegal group reference
     at java.util.regex.Matcher.appendReplacement(Matcher.java:724)
     at java.util.regex.Matcher.replaceAll(Matcher.java:824)
     at java.lang.String.replaceAll(String.java:1589)
     at
    crtmqras.StringSubstitution.replace(StringSubstitution.java:55)
     at
    crtmqras.MQStringSubstitution.processLine(MQStringSubstitution.j
    ava:85)
     at crtmqras.myHandler.startFile(myHandler.java:486)
     at crtmqras.myHandler.startElement(myHandler.java:339)
    
    The console.log shows:
     qmDataPath: '\\hostname\directory$\IBM\WMQ\qmgrs\qmgr name'
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of runmqras on Windows
    
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    A coding error within the runmqras utility caused the Java
    Virtual Machine to incorrectly attempt to perform a regular
    expression substitution when expanding keywords in the isa.xml
    configuration file.
    
    If one or more of the paths to be used during expansion
    contained a "$" character, such as if using a hidden Windows
    network share, then the substitution failed as with a pattern
    matching error.
    
    Additionally, certain Windows paths, in particularly UNC paths,
    were escaped incorrectly, which caused some of the data capture
    activities to silently fail to gather the expected data. In this
    scenario, files such as installDirFiles.stderr and
    explorerFiles.stderr would be generated reporting "The specified
    path is invalid." and the corresponding *.stdout files remain
    empty within the runmqras output.
    

Problem conclusion

  • The string substitution routines used by runmqras have been
    updated to avoid the incorrect regular expression matching, and
    remove the incorrect path escaping in order to support UNC
    paths.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.8
    v8.0       8.0.0.7
    v9.0 CD    9.0.2
    v9.0 LTS   9.0.0.1
    
    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

    IT18131

  • Reported component name

    WEBSPHERE MQ 7.

  • Reported component ID

    5724H7240

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-11-28

  • Closed date

    2017-01-09

  • Last modified date

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

    WEBSPHERE MQ 7.

  • Fixed component ID

    5724H7240

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