IBM Support

IT30487: dmpmqcfg generates incorrect commands for MQ z/OS queues that are in a Queue Sharing Group (QSG)

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

  • Running the dmpmqcfg utility from an MQ installation on a
    distributed platform against a z/OS generates incorrect commands
    for queues that are in a Queue Sharing Group (QSG)
    

Local fix

  • Use the SDEFS function of CSQUTIL on z/OS to produce a list of
    DEFINE commands describing the queue manager and queue sharing
    group objects.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users that use dmpmqcfg over a client connection to a z/OS queue
    manager in a queue sharing group are potentially affected.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The MQSC script generated by dmpmqcfg is built from PCF inquiry
    data, when querying a z/OS queue manager that is a member of a
    queue sharing group this data returned definitions that were
    defined with QSGDISP(QMGR) and QSGDISP(COPY). Replaying the
    QSGDISP(COPY) definitions failed as the QSGDISP(GROUP) object
    had not been configured in the queue sharing group.
    

Problem conclusion

  • The inquiries used by dmpmqcfg were altered to only inquire
    QSGDISP(QMGR) definitions by default, additional definitions may
    be inquired using a new environment variable
    "AMQ_DMPMQCFG_QSGDISP_DEFAULT" which may be set to one of the
    following values;
    
    "LIVE" - only include objects defined with QSGDISP(QMGR) or
    QSGDISP(COPY).
    "ALL" - include objects defined with QSGDISP(QMGR) and
    QSGDISP(COPY). If the queue manager is a member of a queue
    sharing group QSGDISP(GROUP) and QSGDISP(SHARED) are also
    included.
    "COPY" - only include objects defined with QSGDISP(COPY).
    "GROUP" - only include objects defined with QSGDISP(GROUP), the
    target queue manager must be a member of a queue sharing group.
    "QMGR" - only include objects defined with QSGDISP(QMGR). Note
    that this is the new default behaviour.
    "PRIVATE" - only include objects defined with QSGDISP(QMGR) or
    QSGDISP(COPY).
    "SHARED" - only include objects defined with QSGDISP(SHARED).
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.14
    v9.0 LTS   9.0.0.9
    v9.1 CD    9.1.5
    v9.1 LTS   9.1.0.5
    
    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

    IT30487

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-10-02

  • Closed date

    2020-01-13

  • Last modified date

    2020-01-13

  • 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

    5724H7251

Applicable component levels

[{"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:
13 January 2020