PM88860: WITH APAR PM68981 INSTALLED CAUSES AN MQOPEN TO FAIL WITH ADAPTER-NOT-AVAILABLE EVEN WHEN THE MQ CONNECTION IS ESTAB

Obtain the fix for this APAR.

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

• 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 is sysrouted FROM one or more of the following:

  PM88203

• APAR is sysrouted TO one or more of the following:

  UK95282

Modules/Macros

• DFHMQTRU
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UK95282

     UP13/06/29 P F306

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.