PH50568: QCF UNLOAD FAILS WITH MSGIQC4999E RC=0008 AIBRC=00F0 AIBRS=A004

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A response message from a conversational transaction is stuck in
  the shared message queues and has not yet been displayed on the
  terminal that is signed on. When QCF Unload deletes this message
  and terminates the conversation, the next terminal name scan
  process returns RC=24 from DFSSCBT0. As a result, QCF Unload
  terminates with RC=8 and AIBREASN=A004 which is displayed via
  error message IQC4999E.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM IMS Queue Control Facility for z/OS  *
  *                 Version 3 Release 2 (FMID=H0GN320) users.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: A response message from a               *
  *                      conversational transaction is stuck in  *
  *                      the shared message queues and has not   *
  *                      yet been displayed on the terminal that *
  *                      is signed on. When QCF Unload deletes   *
  *                      this message and terminates the         *
  *                      conversation, the next terminal name    *
  *                      scan process returns RC=24 from         *
  *                      DFSSCBT0. As a result, QCF Unload       *
  *                      terminates with RC=8 and AIBREASN=A004  *
  *                      which is displayed via error message    *
  *                      IQC4999E.                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  QCF owns the INSUE on a local CNT to prevent it from being
  deleted by other tasks when scanning the LTERM. When it
  completes scanning a LTERM, it releases the INUSE and owns the
  INUSE for the next LTERM.
  When deleting a conversational message destined for the LTERM,
  QCF releases the INUSE and calls DFSCONX0 to force the
  conversation state to terminate. Then when QCF tries to release
  INUSE with LTERM scan process, RC=24 is returned by DFSSCBT0
  because it has already been freed.
  

Problem conclusion

• QCF has been changed to call DFSCONX0 without releasing the
  INUSE it owns.
  

Temporary fix

Comments

• ×**** PE24/06/24 FIX IN ERROR. SEE APAR PH62015  FOR DESCRIPTION
  

APAR Information

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

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

  UI90435

Modules/Macros

• IQCQMR5E IQCQMR5F
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R320 PSY UI90435

     UP23/02/10 P F302

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.