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

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 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