IBM Support

IT20669: MQ does not include samples Bin64 folder in the default PATH environment variable on Windows

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 status

  • Closed as program error.

Error description

  • After upgrading from MQ v7.5 or earlier to MQ v8 or v9, the
    amqsmon sample application shipped with MQ fails to run.
    .
    In MQ V7.5, amqsmon.exe is in the Tools\c\Samples\Bin directory.
    This Samples\Bin path was set in the PATH environment variable
    by MQ installation. Therefore, amqsmon sample runs without
    explicitly editing the path to include Samples\Bin folder.
    .
    In MQ V8, amqsmon.exe is in the Tools\c\Samples\Bin64 directory,
    however Samples\Bin64 path is not set in the PATH environment
    variable by MQ  installation. Therefore, amqsmon samples fails
    to run without explicitly editing the PATH to include
    Samples\Bin64 folder.
    .
    In MQ v8, after MQ installation, one possible PATH output is as
    following:
    --
    C:\Users\XXX>set PATH
    Path=C:\Program Files (x86)\IBM\WebSphere MQ\java\lib;C:\Program
    Files (x86)\IBM\WebSphere
    MQ\java\lib64;C:\Windows\system32;C:\Windows;C:\Windows\System32
    \Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program
    Files(x86)\IBM\WebSphere MQ\bin64;C:\Program Files
    (x86)\IBM\WebSphere MQ\bin;C:\Program Files(x86)\IBM\WebSphere
                          MQ\tools\c\samples\bin
    .
    The above PATH output shows that Tools\c\Samples\Bin64 is not
    included to the PATH output by MQ after installation.
    

Local fix

  • Include <MQ_Install_DIR>\Tools\c\Samples\Bin64 to the PATH
    environment variable.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Those using MQ samples supplied with MQ installation.
    
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    A coding error in the MQ installation routines meant that the
    Tools\c\Samples\Bin was included in the PATH although windows
    queue manager were 64-bit and most of the samples are available
    in Tools\c\Samples\Bin64 folder.
    

Problem conclusion

  • The MQ product installation routines have been corrected to
    include Tools\c\Samples\Bin64 to the PATH environment variable.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.8
    v9.0 CD    9.0.4
    v9.0 LTS   9.0.0.2
    
    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

    IT20669

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-05-18

  • Closed date

    2017-05-31

  • Last modified date

    2017-07-25

  • 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

    5724H7251

Applicable component levels

  • R800 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
25 July 2017