IBM Support

PK81926: DFHSO0001 AN ABEND (CODE 0C2/AKEA) HAS OCCURRED AT OFFSET X'FFFF' IN MODULE DFHSOIS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Your application issues the following CICS commands :
    
    EXEC CICS SET TCPIP CLOSED.
    EXEC CICS SET TCPIP OPENED.
    EXEC CICS INQUIRE TCPIPSERVICE(tcpipservice).
    
    This results in error message
    
    DFHSO0001 ISDCICS An abend (code 0C2/AKEA) has occurred at
    offset X'FFFF' in module DFHSOIS .
    .
    Your TCPIPSERVICE is defined with STATUS(OPEN).
    After the application issued EXEC CICS SET TCPIP OPEN,
    it caused the 'now closed' TCPIPSERVICE to get re-opened.
    
    An LTE block is getmained for the TCPIPSERVICE and a new CSOL
    listener task is attached to complete the re-opening of
    TCPIPSERVICE.
    
    Before CSOL get can going, the application issues EXEC CICS
    INQUIRE TCPIPSERVICE(tcpipservice). DFHSOIS is called to obtain
    the SERVER_IP_ADDRESS. This is held in lte_inet_addr in the
    LTE for TCPIPSERVICE.
    
    However, as CSOL has not got going yet,the  lte_inet_addr
    remains unitialized. DFHSOIS detects this and issues a
    BPX1HST call from get_server_bin_ip_address.
    
    All BPX calls are supposed to be issued while running on the
    SO TCB.
    
    The problem is that DFHSOIS has failed to switch to SO so the
    BPX call is issued on the QR TCB. This is doomed to failure and
    eventually there is a branch to low core leading to the
    ABEND0C2.
    
    Additional Symptom(s) and Keyword(s): 0C2 ABENDS0C2
    KIXREVSWM
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSO0001 AN ABEND (CODE 0C2/AKEA) HAS  *
    *                      OCCURRED AT OFFSET X'FFFF' IN MODULE    *
    *                      DFHSOIS.                                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A program issues an EXEC CICS INQUIRE TCPIPSERVICE command just
    after TCPIP has been re-opened. This command fails with an
    ABENDS0C2 while processing a DFHSOIS INQUIRE call.
    The TCPIPSERVICE is in the process of being re-opened but the
    sockets listener task - CSOL has not reached the point of
    opening the listener and priming LTE_INET_ADDR.SOCK_SIN_ADDR.
    As LTE_INET_ADDR.SOCK_SIN_ADDR is zero, DFHSOIS issues a BPX1HST
    command to obtain the IP address of the host.
    All BPX calls should be issued while running on the sockets
    ( SO ) TCB but DFHSOIS is still running on the QR TCB when this
    call is made.
    
    ADDITIONAL KEYWORDS :- 0C2 S0C2 MSGDFHSO0001 SO0001
    

Problem conclusion

  • DFHSOIS has been altered so that should
    LTE_INET_ADDR.SOCK_SIN_ADDR be zero when an INQUIRE TCPIPSERVICE
    call is made with the parameter SERVER_IP_ADDRESS, then the task
    will be switched to the SO TCB.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK81926

  • 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

    2009-03-05

  • Closed date

    2009-04-01

  • Last modified date

    2009-05-14

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

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

    UK45407

Modules/Macros

  •    DESSOIS  DFHSOIS
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK45407

       UP09/04/02 P E421

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":"1.1.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
14 May 2009