PK69985: QCF DOES NOT CLEANUP/RELEASE TIB OR YTIB WHEN SYNCHRONOUS OTMA OR APPC MESSAGE IS UNLOADED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• QCF does not cleanup/release TIB or YTIB when synchronous
  OTMA or APPC message is unloaded.
  .
  This is a forward fit co-req of IMS V9 : PK67440 & PK67507
  This is a forward fit co-req of IMS V10 : PK67918 & PK61923
  This is the only QCF APAR/PTF that is needed to work in
  conjunction with the above mentioned IMS APAR's for either IMS
  release.
  KEYWORDS: IMSV10TGT/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All  users of APPC/OTMA using the            *
  *                 Queue Control Facility (QCF) tool            *
  *                 V3R1 to unload or delete                     *
  *                 APPC or OTMA messages.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: APPC TIBs and OTMA YTIBs are not freed  *
  *                      after QCF unloads transaction messages  *
  *                      leaving APPC/OTMA client hung as        *
  *                      viewed from IMS.                        *
  ****************************************************************
  * RECOMMENDATION: Install the APAR.                            *
  ****************************************************************
  The control blocks TIB and YTIB are not freed when QCF deletes
  transactions entered by APPC/OTMA clients.. This leaves
  the TIBs and YTIBs orphaned.
  QCF UNLOAD or DELETE will invoke a new IMS function to delete
  the IMS internal control blocks TIB for APPC transaction
  messages, and YTIB for OTMA transaction messages. This is to
  keep the control blocks from being orphaned until an IMS
  restart is performed. This function is invoked for IMS
  shared queues and non-shared queues systems, but not for a
  APPC/OTMA transaction queued in a remote multiple systems
  coupling (MSC) IMS. The new IMS function, added by PK67440
  must be applied.  See that APAR for details.
  
  IQCQMR5X was modified to call DFSCIO50 for APPC or OTMA
  transaction messages to determine if cleanup is needed. If it
  is needed, DFSCIO50 will enqueue an AWE to initiate the
  cleanup.
  

Problem conclusion

• This is a FFIT for PK67507 (IMS 9.1 APAR)
  

Temporary fix

Comments

APAR Information

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

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

  UK40592

Modules/Macros

• IQCMRAEQ IQCQMR5A IQCQMR5X IQCQMR58 IQCQMR59
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R310 PSY UK40592

     UP08/10/10 P F810

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.