A fix is available
APAR status
Closed as program error.
Error description
A transaction is run right after region startup that sometimes runs before the MQ subsystem is started. The transaction makes MQOPEN calls and if it fails, within a specified time frame, it does another MQOPEN call and continues this process until successful. Before installing PM68981 the MQOPEN would fail with code 2059 - Q-MGR-NOT-AVAILABLE. But after applying PM68981 the MQOPEN fails with code 2204 - ADAPTER-NOT-AVAILABLE. Also, it does not allow future MQOPEN requests, for the same task, to complete successfully once the MQ connection is established. The task just keeps failing with the return code 2204. The task has to be canceled and restarted to allow the MQOPEN call to be successful. The fix provided by PM68981 appears to be causing this problem. It should be possible for a task to connect to a queue manager that it had previously failed against. Additional Symptom(s) Search Keyword(s): KIXREVACC
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users with UK82953, UK82954 or * * UK92497 applied. * **************************************************************** * PROBLEM DESCRIPTION: WMQ API commands fail repeatedly with * * reason code MQRC_ADAPTER_NOT_AVAILABLE. * **************************************************************** * RECOMMENDATION: * **************************************************************** A CICS task issues a WMQ API command, which causes CICS to check the status of its connection to WMQ. WMQ is unavailable and as a result, CICS returns response MQCC_FAILED with reason code MQRC_ADAPTER_NOT_AVAILABLE. CICS later connects to WMQ and the same task issues another WMQ API command. CICS checks the status of its connection to WMQ again but due to residual data, CICS believes it is not connected and returns MQCC_FAILED with reason code MQRC_ADAPTER_NOT_AVAILABLE once more. Such a response is returned for all future WMQ API commands from this task. Other tasks are not affected.
Problem conclusion
UK82953 UK82954 UK92497 DFHMQTRU has been modified to ensure no residual data remains in lReturnCode and lReason. The contents of lReason are passed into lAPIReason, and if that is MQRC_CONNECTION_BROKEN, the contents are changed in line with other DFHMQXRC calls.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM88203
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-05-01
Closed date
2013-06-18
Last modified date
2013-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM88860 PM89416 UK95232 UK95233
Modules/Macros
DFHMQTRU
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2013