A fix is available
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
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