PM55736: DFHSM0002 030D QUICKCELL GETMAIN INVALID QPH CAUSED BY EZACIC22 ONE BIT OVERLAY. CICS MUST BE CANCELLED AS A RESULT.

APAR status

• Closed as program error.

Error description

• The CICS TCPIP sockets interface is stopped via the EZAO
  transaction.  If any tasks using the interface are hung,
  message EZY1342I is issued:
  EZY1342I DISABLE DELAYED UNTIL ALL TASKS COMPLETE.
  If the EZAO transaction is ended before the CICS sockets
  interface is stopped, then the potential exists for a
  one bit overlay of CICS private storage leading to
  unpredictable results.
  
  problem recreate:
  EZACIC00 issues EXEC CICS START TRANSID('EZAP') FROM(EISR0000)
  LENGTH(12). It passes EISRCADD as the COMMAREA for EZACIC22.
  EZAO then terminates before EZAP finishes updating the
  COMMAREA. During task termination of EZAO, the working storage
  (DFHEISTG for EZACIC00) is freed.  Sometime later,
  CICS reuses the same area as an QPH (Quickcell Pool Header).
  EZACIC22 overlays one bit when updating the residual storage
  previously used for the COMMAREA plist.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 10 IP:         *
  *                 CICS Sockets                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS message loop for DFHSM0002         *
  *                      with code x'030D' and DFHPG0002         *
  *                      with code X'060D' or other              *
  *                      unpredictable results.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The EZAO transaction was used to stop the CICS
  sockets interface:
  
  ****************************************************
  EZAO,STOP
  
  Enter one of the following
  
  
  CICS         ===> yes                  Enter Yes|No
  LISTENER     ===>                      Enter Yes|No
  TRACE        ===>                      Enter Yes|No
  
  ****************************************************
  
  The stop was performed using the non immediate option.
  
  EZACIC00 is the driver module for transaction EZAO.
  EZAO started transaction EZAP to perform the request.
  A parameter list was passed by EZACIC00 to module
  EZACIC22 (the driver module for transaction EZAP).
  EZAP was not able to stop the CICS sockets interface
  due to a hung child server task.  The following message
  was issued by transaction EZAP:
  
  +EZY1342I 02/01/12 14:13:32 DISABLE DELAYED UNTIL ALL TASKS
   COMPLETE. TERM=     TRAN=EZAP
  
  EZACIC22 sets an indicator bit in the parameter list to
  notify transaction EZAO of the delay.
  
  The operator ended the EZAO transaction before the CICS
  sockets interface was terminated.  The parameter list
  was freed, and subsequently reallocated as a different
  control block in CICS.
  
  After a time delay, the EZAP transaction again set the
  delayed bit in the parameter list, this time causing a
  one bit overlay in the new control block.
  
  Results are unpredictable, depending on the location of the
  one bit overlay.  In the reported case, CICS reported false
  storage management errors due to a damaged QPH control
  block.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• Modules EZACIC00, EZACIC21, and EZACIC22 have
  been amended to correct the one bit overlay
  for the parameter list field P22RETIP.
  
  * Cross Reference between External and Internal Names
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UK76080

Modules/Macros

• EZACICA  EZACIC00 EZACIC21 EZACIC22
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels