IBM Support

IT34002: IBM MQ adding/removing features from a Windows installation can damage the Web Console installation.

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

  • If one removes certain components from a Windows 9.1 LTS
    installation (e.g., MFT), this can make the web console
    unusable.
    

Local fix

  • MQ v9.1 - Uninstall and reinstall the web feature or look to
    modify Installation again, but do not change anything.  This
    should put back the WebConsole/REST API binary files.
    MQ v9.2 - Uninstall and reinstall the web feature or look to
    update the file <MQ_program_directory>\web\etc\server.env reads:
    
    ########
    # comment block
    ########
    WLP_SKIP_UMASK=true
    
    and needs to have two lines added at the end:
    
    JAVA_HOME=<MQ_program_directory>\java\jre
    WLP_USER_DIR=<MQ_data_directory>\MQ\web\installations\<MQ_instal
    lation_name>
    
    eg.  The file contents need to look like:
    ########
    # comment block
    ########
    WLP_SKIP_UMASK=true
    JAVA_HOME=C:\Program Files\IBM\MQ\java\jre
    WLP_USER_DIR=C:\ProgramData\IBM\MQ\web\installations\Installatio
    n1
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the IBM MQ on Windows and if they
    are modifying an existing installation adding/removing features
    from the installation.
    
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    If you install MQ Server on Windows, and then look to modify the
    installation by adding/removing features. The result is that the
    MQ WebConsole binary files are removed or will no longer run.
    
    eg.
    
    C:\dspmqweb
    'dspmqweb' is not recognized as an internal or external command,
    operable program or batch file.
    
    or
    
    C:\dspmqweb
    '"java"' is not recognized as an internal or external command,
    operable program or batch file.
    "java"
    '"java"' is not recognized as an internal or external command,
    operable program or batch file.
    "java"
    

Problem conclusion

  • The Installation process has been updated to prevent the Web
    Console binary files being removed or them being unable to run
    after modifying an existing installation adding/removing
    features from the installation.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.1 LTS   9.1.0.7
    v9.2 LTS   9.2.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

    IT34002

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7271

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-08-25

  • Closed date

    2020-09-08

  • Last modified date

    2020-10-05

  • 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

    IBM MQ BASE MP

  • Fixed component ID

    5724H7271

Applicable component levels

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

Document Information

Modified date:
06 October 2020