IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PK30203

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2006-08-23

  • Closed date

    2007-03-09

  • Last modified date

    2011-11-04

  • 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
    

Publications Referenced
GC34556108SC33165210SX33610100  

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
04 November 2011