IBM Support

PI98197: DFHIS1005 CICSREGN UNABLE TO ACQUIRE IPCONN IPC1. ASSOCIATED TCPIPSERVICE TCPIPIC NOT OPEN.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • At region startup, IPIC connections get an DFHIS1005, then the
    TCPIPService opens and connections are able to ACQUIRE.
    There is a group that includes the TCPIPService and a couple
    IPConn resources.  The group installs the TCPIPIC and the two
    IPIC resources.  The IPIC's attempt to ACQUIRE the connection,
    but fail with the DFHIS1005.  Once the TCPIPIC opens, then the
    IPIC's are able to acquire the connection.  This appears to be
    a timing issue.  Things work, but this creates a lot of
    messages in the log with all the connection attempts failing
    because the time it takes the TCPIPService to open is so long.
    In this example, it's about 5 seconds.  In a region like a TOR,
    where it connects to hundreds of regions, this could be a real
    issue.
    .
    There are actually 2 different ECBs being used between CSOL and
    DFHSODM and they are waited on and posted in different orders.
    .
    CSOL waits on soa_start_listener_ecb
    DFHSODM posts soa_selectex_ecb (does nothing)
    DFHSODM waits for TOP
    DFHSODM posts soa_start_listener_ecb
    CSOL then enters its normal wait on soa_selectex_ecb
    .
    This means that DFHISDM, DFHSODM and CSOL are all effectively
    waiting for TOP and then have a race between CSOL opening the
    TCPIPSERVICEs and CISC acquiring the IPCONNs.  Need to better
    manage the coordination of the sockets domain initialization
    and ensure that it does not impact on the acquiring of IPCONNs.
    
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVDAM
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: msgDFHIS1005 issued unexpectedly during *
    *                      CICS initialization.                    *
    ****************************************************************
    A CICS region is initializing and one or more TCPIPSERVICEs and
    IPCONNs are being installed.
    
    The SO domain is waiting for initialization to complete before
    the CSOL task opens any TCPIPSERVICEs.  The IS domain is waiting
    for initialization to complete before attaching a CISC task to
    acquire any AUTCONNECT(YES) IPCONNs.
    
    There is a race between CSOL and CISC which means that it is
    possible for CISC to attempt to acquire an IPCONN before its
    associated TCPIPSERVICE has been opened.  This causes message
    DFHIS1005 to be issued indicating there is a problem with the
    IPCONN.  Once the CSOL task opens the TCPIPSERVICE the IS domain
    is notified and the IPCONN gets acquired successfully at that
    point.
    
    It is misleading for the DFHIS1005 message to be issued in this
    instance.
    
    Additional keywords:
    IS1005  DFHSO0107  msgDFHSO0107  SO0107
    

Problem conclusion

  • CICS domain initialization for the IS (IPIC) and SO (Sockets)
    domains has been restructured so that IPCONNs are always
    acquired after all the TCPIPSERVICEs have been opened.
    
    A new wait type of SODOMAIN CSOL_REG has been added to list of
    system wait types in the knowledge center.
    

Temporary fix

Comments

  • ×**** PE19/03/15 FIX IN ERROR. SEE APAR PH09748  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI98197

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-05-21

  • Closed date

    2018-12-19

  • Last modified date

    2019-03-26

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

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

    UI60356 UI60357

Modules/Macros

  • DFHDMPHD DFHPIPL  DFHSII1  DFHSODM  DFHSOLS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI60357

       UP19/01/03 P F901

  • R200 PSY UI60356

       UP18/12/25 P F812

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

Document Information

Modified date:
26 March 2019