IBM Support

IT16297: dspmqver hangs if mqinst.ini contains comment or blank lines

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • MQ 8.0 dspmqver hangs when running by user or when invoked
    indirectly by utilities such as rpm in Linux.
    .
    There are no FDC files, no error messages.
    .
    Upon further investigation, it was found that the there was an
    extra blank line at the end of the MQ installation ini file:
    /etc/opt/mqm/mqinst.ini
    .
    After removing the extra blank line, then dspmqver worked fine
    and the rpm command in Linux was able to work fine too. This
    problem might
    also occur if there is a comment line instead of a blank line.
    
    Examples:
    
    Primary:
       <blank line>
       Name=Installation16
    
    Primary:
       Name=Installation16
      <blank line>
    
    Primary:
      #comment
       Name=Installation16
    
    Primary:
       Name=Installation16
         #comment
    
    Other MQ commands - setmqinst, dspmqinst, dspmq (dspmq -o all) -
    are also affected by this problem.
    

Local fix

  • Check if there is an extra blank line at the end of the file:
      /etc/opt/mqm/mqinst.ini
    If affirmative, remove it. Then try dspmqver or rpm again.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users using MQ commands with blank or comment lines in the
    Primary stanza in mqinst.ini
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    A coding error meant that MQ utility routines did not correctly
    handle blank lines or lines with comments in the mqinst.ini
    file.
    

Problem conclusion

  • MQ has been modified to correctly handle the blank lines or
    lines with comment in the mqinst.ini file.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.1       7.1.0.8
    v7.5       7.5.0.8
    v8.0       8.0.0.6
    v9.0 CD    9.0.1
    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

    IT16297

  • 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

    2016-07-26

  • Closed date

    2016-09-22

  • 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

    WMQ BASE MULTIP

  • Fixed component ID

    5724H7251

Applicable component levels

  • R800 PSY

       UP

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

Document Information

Modified date:
10 September 2020