IBM Support

PM25940: EXEC CICS CREATE OR CEDA INS REMOTE TERMINAL HANGS 10/11/10 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After applying PM08183 several customers have
    reported the following abend in DFHTFIQ:
    DFHTF0001 An abend (code 0C4/AKEA) has occurred
    at offset X'058C' in module DFHTFIQ.
    PIDS/5655M1500 LVLS/650 MS/DFHTF0001 RIDS/DFHTFIQ
    PTFS/HCI6500 AB/S00C4 AB/UAKEA ADRS/0000058C
    Additional symptoms:
    DFHTFIQ is attempting to increment a storage violation
    count- SET_TERMINAL_FACILITY  COUNT_STORAGE_VIOLATION(YES)
    R10 the tctte pointer contains 000A0000.
    With XM tracing off, module DFHZTSP is setting
    XM_TXN_FACILITY_TOKEN to a value of x'000A0000'
    a local fix for this problem is to turn on
    XM level 1 tracing.
    Second problem:
    ---------------
    When installing a remote terminal using EXEC CICS CREATE
    or CEDA INSTALL the terminal associated with the
    task is not released on task termination and a
    hang occurs.
      tf_tctte_ptr zero zeroes zeros
    TFRF RELEASE_FACILITY DFHLTRC LIFO
    
    Third problem:
    ---------------
    When using CEDA
    .
    Messages:
    ---------
    DFHAP0001 abend code 0C4/AKEA occurred
       at offset X'0000221E' in module DFHZISP
    DFHTF0001 An abend (code 0C4/AKEA) has occurred
       at offset X'02F4' in module DFHTFIQ
    DFHXM0002 severe error code X'100B' occurred
                         in module DFHXMIQ
    DFHAP0001 abend code 0C1/AKEA occurred
       at offset X'0344' in module DFHLTRC
    DFHRM0002 severe error code X'020B' occurred
                         in module DFHRMUO
    AP0001 TF0001 XM0002 RM0002
    .
    Trace entries:
    --------------
    AP 0790 SRP   *EXC* PROGRAM_CHECK
    AP 0781 SRP   *EXC* ABEND_ASRA
                             DFHZISP,0000221E,CICS
    AP 1702 TFIQ  *EXC* Recovery_entered
                             INQUIRE_TERMINAL_FACILITY,000A0000
    XM 100B XMIQ  *EXC* Unexpected_return_code_from_
                             TFIQ_INQUIRE_TERMINAL_request
                             INQUIRE_TRANSACTION
    AP 1712 TFRF  *EXC* Recovery_entered
                             RELEASE_FACILITY,NO,NORMAL,000A0000
    AP 1762 LTRC  *EXC* Recovery_entered
                                PERFORM_COMMIT,NO,FORWARD
    RM 020B RMUO  *EXC* Bad_response_from_client COMMIT_UOW,NO
    .
      Multiple abends for one task
    causes the CICS region to end (crash)
    IEF450I ABEND=S000 U1800 REASON=00000000
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users with the PTF of APAR PM08183  *
    *                 applied.                                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHTFIQ abends 0C4 at offset X'058C'    *
    *                      when there is a storage violation in    *
    *                      a routed transaction.                   *
    *                      A terminal hangs when running a task    *
    *                      installing a remote terminal using      *
    *                      CEDA or EXEC CICS CREATE.               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    There are two problems caused by code added in APAR PM08183
    to clear the facility token when issuing a freemain
    for a surrogate terminal in the DFHZTSP SKELCOM code.
    
    In cases when the principal facility is the surrogate
    terminal, the SKELCOM code sets the facility token
    to nulls when XM tracing it turned ON. However, when
    XM tracing is turned OFF the facility token is set
    to the value within the 4 bytes at address X'00000000'
    This typically has a value other than nulls.
    If CICS detects a storage violation in task storage
    during task termination there is an attempt to update
    the TCTTE storage violation count using the invalid
    facility token as the TCTTE address which resulted in an
    abend0C4 in DFHTFIQ.
    
    When a CEDA INSTALL or EXEC CICS CREATE request is made to
    install a remote terminal the terminal associated with the
    task issuing the request hangs on task termination.
    In this case the facility token should not have been
    cleared in SKELCOM because the principal facility was
    the terminal associated with the CEDA or EXEC CICS
    request rather than the surrogate.
    
    Additional keywords: MSGDFHTF0001 DFHTF0001 TF0001 S0C4
                         abendS0C4
    

Problem conclusion

  • UK56620
    
    DFHZTSP has been changed to clear the current transaction's
    facility token correctly when appropriate.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM25940

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-11-05

  • Closed date

    2010-12-21

  • Last modified date

    2013-05-08

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

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

    PM26424 UK63392

Modules/Macros

  •    DFHZTSP
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK63392

       UP10/12/30 P F012

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
08 May 2013