PI84948: ABENDSM0002 FREEMAIN OF RMOFRMLK SUBPOOL (RMLINK) FAILS QUICKCELL_FREEMAIN_QPF_ALREADY_FREE. CLS2 DFHRMLSO DFHCR2U

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RMLINK address is double freemained.
  CLS2 is processing CR2U PERFORM COMMIT for LU62 in DFHRMLSO.
  The trace for the CLS2 task shows the RMLINK is added and
  deleted prior to DFHRMLSO issuing a second freemain.
  .
  DFHZARL has issued a ZISP FREE followed by ZRST RESETSR
  which results in a RMLN DELETE_LINK.
  Then ALP RESET_AID_QUEUE results in ZISP LU62 ALLOCATE.
  We return to DFHRMLSO and issue the second freemain !
  .
  ADDITIONAL SYMPTOMS
  A program using an APPC (LU62 LUTYPE62) connection
  to a partner ends the task while still in receive mode.
  During task termination, DFHZUSR ZUSR checks to see
  if it can issue a FREE request while in ALLOC_RCV
  ALLOCATE RECIEVE state.
  .
  At earlier releases, CICS detected that it could not FREE it
  and issued an abend ISSUE_ABD ISSUE_ABEND to end the session.
  .
  At R5.4, instead of issuing the abend,
  the code tries to SET the conversation to FREE.
  DFHZARL detects an Invalid Request INVREQ.
  DFHCR2U does not deal with it correctly.
  Instead of abending the conversation,
  it is simply detached the LU62 session.
  This left the task information in these two fields:
  .
  +x'10'   TCTTECA        Address of TCA using this terminal
  +x'14'   TCTE_TRANNUM   Trannum (task number)
  .
  This makes it look like the session was never released,
  so they can never be allocated again.
  .
  If this happens to all of the Sessions on a Connection,
  then all tasks future tasks that need to use that Connection
  will wait in suspend wait state type ALLOCATE.
  .
  No changes were made to the APPC code.
  But, a new PLX compiler was used
  that expanded the DFHLUC parameter list incorrectly,
  causing an new error in the base level code for R5.4.
  This showed up in a DTP (Distributed Transaction Processing)
  program.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS suffers DFHSM0002 - severe error   *
  *                      code X'030F' (double freemain)          *
  *                      in module DFHSMGF while allocating      *
  *                      an LU 6.2 connection after an           *
  *                      emergency restart.                      *
  ****************************************************************
  * RECOMMENDATION: .                                            *
  ****************************************************************
  When CICS allocates an LU 6.2 connection to another region
  after an emergency restart, DFHCR2U issues a DFHLUC macro
  to request some Terminal Control processing.
  The DFHLUC macro generated an incorrect option request byte
  causing Terminal Control to take an invalid path into the
  Recovery Manager Domain, causing RM to freemain a RMOFRMLK
  control block twice.
  
  Additional keywords: SM0002
                       Quickcell_freemain_QPF_already_free
                       DFHRMLINK
  

Problem conclusion

• DFHCR2U has been changed to ensure that the DFHLUC
  macro generates a valid option request byte.
  

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:

  UI49489

Modules/Macros

• DFHCR1U  DFHCR2U  DFHCRBU  DFHCRIU
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI49489

     UP17/08/15 P F708 ¢

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.