IBM Support

IT15157: addmqinf fails in a Windows multi-instance environment when the queue manager is created with the -ar option

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After creating a queue manager (qmgr) with the -ar option,
    dspmqinf is run to display the multi-instance qmgr configuration
    information.  When using the addmqinf command to copy the
    configuration data to other systems, the following error is
    seen:
    AMQ6245: Error executing system call 'CreateFile' on file
    '\\server\mqdata\qmgrs\QMGR_NAME\amqprobe.amq' error '1337'.
    AMQ7001: The location specified for the queue manager is not
    valid.
    Windows error 1337 translates to ERROR_INVALID_SID (The security
    ID structure is invalid).
    MQ trace of the addmqinf process shows the following:
    -------{  xcsCreateFile
    File: '\\server\mqdata\qmgrs\QMGR_NAME\amqprobe.amq', access:
    -1073741824, sharing: 4, permissions: 5, disposition: 2,
    attributes: 67108992, ffstOnError: FALSE fd: -1, error: 1337
    -------}! xcsCreateFile (rc=lpiRC_FILE_TREE_CREATION_ERROR)
    CreateFile failed: 1337
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users configuring multi instance queue manager at IBM MQ V8
    
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The problem would be seen only if the queue manager was created
    using -ar option.
    
    This APAR is related to the APAR IT10185.  Changes were made
    under IT10185 to alter the Access Control List (ACL) of process
    handles when the queue manager was created with the -ar option.
    An omission in this APAR change meant that the addmqinf process
    did not access the correct configuration data when determining
    if the queue manager had been created with the -ar option.
    
    Because the correct configuration data was not checked, the SID
    of the local mqm group was not removed from the Access Control
    List (ACL) of the addmqinf process handle and so this process
    reported an error while accessing the queue manager data
    directories on which the mqm group did not have access
    permission.
    

Problem conclusion

  • The IBM MQ queue manager has been updated so that the addmqinf
    process checks the correct configuration data, to ensure that
    the SID of the local mqm group was removed from the Access
    Control List (ACL) of the addmqinf process handle if the queue
    manager was originally created with -ar option.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    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

    IT15157

  • 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-05-06

  • Closed date

    2016-09-30

  • 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

[{"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:
01 June 2017