APAR status
Closed as program error.
Error description
While executing the dmpmqcfg command with client connection (-c), MQRC_ENVIRONMENT_ERROR (rc=2012) error is returned, when SHARECNV(0) is set on SVRCONN Channel definition used by dmpmqcfg. [root@~]# dmpmqcfg -m QMGR -c default AMQ8921E: MQCB call failed with reason code 2012. [root@~]#
Local fix
When executing the dmpmqcfg with the -c flag, use a SVRCONN channel with SHARECNV(1) or greater.
Problem summary
**************************************************************** USERS AFFECTED: Users of MQ who uses "dmpmqcfg" to connect to a queue manager with client connection (-c) option and the SHARECNV is "0" on the SVRCONN channel definition in use. Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: dmpmqcfg uses MQ's asynchronous consume feature to retrieve PCF responses from the command server. When SHARECNV(0) was set on the channel, aysnchronous consume operations are not available, and synchronous MQGET calls should be used instead. The dmpmqcfg utility failed to handle this scenario correctly, and incorrectly attempted an asynchronous operation, resulting the in the <span style="background-color:rgb(255, 255, 255)">MQRC_ENVIRONMENT_ERROR response.</span>
Problem conclusion
The dmpmqcfg utility has been modified to revert to using MQGET API calls if asynchronous consume is not available. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v9.0 LTS 9.0.0.12 v9.1 LTS 9.1.0.9 v9.2 LTS 9.2.0.3 v9.x CD 9.2.4 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
IT35459
Reported component name
IBM MQ BASE M/P
Reported component ID
5724H7261
Reported release
900
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-01-08
Closed date
2021-06-30
Last modified date
2021-06-30
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 M/P
Fixed component ID
5724H7261
Applicable component levels
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Version":"All Versions"}]
Document Information
Modified date:
01 July 2021