PK30203: PIPELINE POOL TERMINALS HUNG WITH TCTEPTBI SET WITH NO TASK RUNNING ON THEM. SESSION TERMINATION HUNG UP.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Pipeline pool terminals hung with TCTEPTBI (pool terminal busy
  indicator) yet no task is associated with it.  TCTESUS is also
  set.  This prevents that pool terminal from being used for a
  task.  It also would prevent proper session termination when the
  session to the pipeline device is terminated.  For instance
  there will be no DFHZC3462.
  .
  This problem happens whenever a pipeline device sends an LUSTAT
  to CICS that requires a response.  In the case of the
  documentation for this APAR, the message log shows lots of the
  following pair of error messages:
  .
  DFHZC2458 .. Exception response received to an exception...
  DFHZC3438 ...Device powered off.  SENSE CODE 0831 0000...
  .
  That pair of error messages shows that the pipeline device has
  sent a negative response to data sent from CICS.  But
  interspersed with loose pairs of messages is a DFHZC3438
  message without a corresponding DFHZC2458.  That is evidence
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Pipeline pool terminals hung with       *
  *                      TCTEPTBI set after device powered off.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A pipeline device is powered off and an LUSTAT carrying SENSE
  08310000 is sent to CICS to report the condition. Pipeline
  devices should only ever request EXCeption responses, but the
  LUSTAT requests a definite response which violates the protocol.
  DFHZRAC processes the incoming LUSTAT, sets the busy indicator
  TCTEPTBI in the pool terminal, and attempts to send the
  requested response using an asynchronous send. To prevent other
  activity while the asynchronous send is active the suspend bit
  TCTESUS is set on in the pool terminal TCTTE. Normally for a
  non-pipeline device TCTESUS would be reset when the send
  completes. However the code was never intended to run for
  pipeline terminals and so no special processing is performed to
  allow for the session and pool terminal configuration. When the
  SEND completes the TCTTE address is taken from the RPL which
  addresses the session TCTTE, and TCTESUS is reset in the session
  but not the pool terminal. DFHZC3438 is issued to report that
  the device was powered off and as part of this processing the
  detach bit TCTECDT is set on to request DFHZDET processing,
  which would reset TCTEPTBI. DFHZDET cannot run because TCTESUS
  is still set, so TCTEPTBI remains set blocking any subsequent
  attempt by DFHZCLS to CLSDST and cleanup. Consequently the
  pipeline device remains hung indefinitely and cannot be
  released.
  
  Additional keywords:
  SNS0831 SENSE0831 MSGDFHZC3438
  

Problem conclusion

• DFHZRAC has been changed to check if an incoming LUSTAT SENSE
  08310000 for a pipeline device is requesting a definite
  response. If it is, no attempt is made to send the response.
  Instead, the device is placed out of service and a new message
  DFHZC2119 is issued to report the protocol violation.
  
  The CICS Transaction Server for VSE/ESA V1.1, Messages and
  Codes manual, GC34-5561-08, will be updated to add message
  DFHZC2119, after message DFHZC2118 as follows:
  
  DFHZC2119  E "DATE TIME APPLID TERMID
            TRANID" LUSTAT received on pipeline session
            incorrectly requests a definite response.
            (("INSTANCE") MODULE NAME:  {DFHZRAC})
  
  EXPLANATION:  CICS has received data on a pipeline session
  that violates the pipeline protocol. An LUSTAT SENSE
  08310000 'Device Powered Off' was received from the device
  requesting a definite response, but only EXC responses are
  allowed.
  
  SYSTEM ACTION:  CICS ends the session which sent the data
  and marks it out of service.  CICS also attempts to
  abnormally terminate any running transactions initiated from
  this session.
  
  USER RESPONSE:  Determine why the pool pipeline terminal
  is violating the protocol.
  
  DESTINATION:  CSNE
  
  MODULE:  DFHZRAC
  
  XMEOUT PARAMETERS: date, time, applid,
  termid, tranid, instance,
  {1=DFHZRAC}
  
  The CICS Transaction Server for VSE/ESA V1.1 Customization
  Guide SC33-1652-10 has been changed in Appendix B,
  "Default actions of the node abnormal condition program".
  
  The following line has been added to table 142 ("Messages issued
  and flags set by DFHZNAC for specific error codes") :
  
    X'DE'  |   TCZPIPP  |   DFHZC2119    |   9, 10, 11, 23, 24
  
  The following line has been added to table 143 ("CICS messages
  associated with VTAM errors") :
  
    DFHZC2119  |   TCZPIPP   |  X'DE'   |   9, 10, 11, 23, 24
  
  The CICS Transaction Server for VSE/ESA V1.1 User's Handbook
  SX33-6101-00 has been changed section 10.1 ("VTAM terminal
  error codes and CICS message numbers") to add the following:
  
  Symbolic label   Action flags set   Error code   CICS message
  TCZPIPP          9,10,11,23,24      X'DE'        DFHZC2119
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PQ79229

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

  UK22921

Modules/Macros

•    DFHMEZBC DFHMEZBE DFHMEZBG DFHMEZBK DFHZEQU
  DFHZNAC  DFHZNCA  DFHZRAC  MFHMEZBE
  

Fix information

• Fixed component name

  CICSTS FOR VSE

• Fixed component ID

  564805400

Applicable component levels

• RB0P PSY UK22921

     UP07/03/21 I E313

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.