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":"LOB45","label":"Automation"}}]
Document Information
Modified date:
13 January 2020