This is an informational message indicating that sockets domain initialization has started.
System initialization continues.
None. The message can be suppressed with the system initialization parameter MSGLVL=0.
Console
DFHSODM
XMEOUT Parameter: applid
This is an informational message indicating that sockets domain initialization has completed successfully.
System initialization continues.
None. The message can be suppressed with the system initialization parameter MSGLVL=0.
Console
DFHSODM
XMEOUT Parameter: applid
An error has been detected in DFHSOCK. The error has been caused by a severe return code received from TCP/IP.
An exception entry X'code' is made in the trace table. No system dump is taken, unless you have specifically requested a dump in the dump table. CICS® continues unless you have specified in the dump table that CICS should terminate.
The TCPIPSERVICE tcpipservice on port portnumber at the specified IP address will be shutdown. When this is complete then message DFHSO0108 will be issued.
This error could have been returned if TCP/IP had been shutdown, for example. The exception trace entry will tell you which service routine was called and the return values that were returned. Refer to TCP/IP for VSE Messages to determine the cause of the error.
The TCPIPSERVICE tcpipservice will be closed, and after the TCP/IP region has been restarted the closed TCPIPSERVICE should be reopened. At this point normal work can resume on the TCPIPSERVICE.
Console
DFHSODM
XMEOUT Parameters: applid, date, time, X'code', tcpipservice, portnumber, ipaddress
The ENCRYPTION=level system initialization parameter was specified, where level may be STRONG or NORMAL, but the necessary support to implement it was not installed with your SSL.
Sockets Domain initialization fails, and CICS terminates.
Ensure that your TCP/IP SSL version supports the requested level.
If the feature is unavailable, you must specify ENCRYPTION=NORMAL, which is the default.
Console Routecodes 2, 9, 10 and 11
DFHSODM
XMEOUT Parameters: applid, level
The program module pgmname, which is required to implement the secure sockets layer, could not be loaded.
System initialization continues, but support for the secure sockets layer is not enabled.
If this message is preceded by message DFHSO0103, try restarting CICS with ENCRYPTION=NORMAL.
Console Routecodes 2, 9, 10 and 11
DFHSODM
XMEOUT Parameters: applid, pgmname
The ENCRYPTION=NORMAL system initialization parameter was specified, but the necessary support to implement it was not installed on your system via TCP/IP.
The lower level of encryption corresponding to ENCRYPTION=WEAK is used instead.
None.
Console Routecodes 2, 9, 10 and 11
DFHSODM
XMEOUT Parameters: applid, level
An error has been detected in module modname. The code X'code' is the exception trace point ID which uniquely identifies what the error is and where the error was detected.
An exception entry (code X'code' in the message) is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.
CICS continues unless you have specified in the dump table that CICS should terminate. If appropriate, an error return code is sent to the caller of this domain. In this case, CICS could be terminated by the caller (for example, the domain manager, DFHDMDM). A message is issued to this effect.
This indicates a possible error in CICS code or the called Language Environment Callable Service routine. The exception trace entry will tell you which service routine was called and the return values that were returned. The severity of its impact depends on the importance of the function being executed at the time of the error.
CICS may not have been terminated. If the message occurs once and module modname is not crucial to the running of your CICS system, you may decide to continue to run and bring CICS down at a convenient time to resolve the problem.
If the message recurs or if you cannot run without the full use of module modname, you should bring CICS down in a controlled shutdown.
Console and Transient Data Queue CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, X'code', modname
The TCPIPSERVICE tcpipservice has been opened on port portnumber at the IP address specified.
CICS continues.
None.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, tcpipservice, portnumber,ipaddress
The TCPIPSERVICE tcpipservice on port portnumber on the specified IP address has been closed.
CICS continues.
None.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, tcpipservice, portnumber,ipaddress
This message is issued when the open of a TCPIPSERVICE cannot be completed. The port number specified is already in use in combination with the IP address. By default, TCP/IP only allows one server to be listening on a port at any one time.
Specifically, this message is issued when the TCP/IP bind call fails with a return code of EADDRINUSE.
The TCPIPSERVICE does not open, but remains closed. An exception trace entry is written detailing the return values from the TCP/IP bind call. An application using the EXEC API to set the TCPIPSERVICE open receives an RESP(INVREQ) RESP2(9).
Check that there are no other TCPIPSERVICES open using the same port number and IP address as the failing one. If there is another TCPIPSERVICE open using the port, it must be closed before the new one can be opened.
If no TCPIPSERVICES are using the requested port, there may be another z/VSE® application acting as a TCP/IP server already listening on the port. Attempting to open a TCPIPSERVICE on an already used port will fail. Choose an unused port for the TCPIPSERVICE.
If your z/VSE system has more than one TCP/IP stack you may specify another stack's IP address on the TCPIPSERVICE definition. This will allow you to install multiple TCPIPSERVICES each using the same port number.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, tcpipservice, portnumber,ipaddress
Opening the TCPIPSERVICE has failed because the IP address specified on the definition is not known to TCP/IP.
This message is issued when the TCP/IP bind call fails with the return value of EADDRNOTAVAIL.
The IP address must be a valid address known to TCP/IP. If the system only has one IP address then the IP address field of the TCPIPSERVICE definition can be left blank, or filled with the string INADDR_ANY. This causes the bind to use the default IP address for the system. To use an alternative, a valid address must be specified.
Check that the address specified on the TCPIPSERVICE definition is known to TCPIP on the system.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, tcpipservice, ipaddress
Opening the TCPIPSERVICE has failed because the userid of the region is not authorized to use the port number specified.
This message is issued when the TCP/IP bind call fails with a return value of EPERM.
The TCPIPSERVICE is not opened. If an application has used the EXEC API to open the TCPIPSERVICE, it receives RESP(INVREQ) RESP2(3) values.
The CICS region's userid must be authorized to open the specified port.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, tcpipservice, portnumber
Opening the TCPIPSERVICE has failed because TCPIP is currently not open. Either TCPIP=NO has been specified in the SIT or TCPIP has been dynamically closed using CEMT or an SPI command.
The TCPIPSERVICE is not opened. If an application has used the EXEC API to open the TCPIPSERVICE, it receives RESP(INVREQ) RESP2(4) values.
Open TCPIP and re-open the TCPIPSERVICE.
CSOO
DFHSORD
XMEOUT Parameters: date, time,applid, tcpipservice
CICS has issued the TCP/IP function gethostbyaddr to resolve the IP address ip_address to a host name, but the call failed.
An exception trace entry is made. CICS will continue to attempt to access the name server for subsequent requests.
The gethostbyaddr function will usually perform a name server reverse lookup to resolve the IP address into a host name. This can fail if CICS is unable to contact a name server, or the name server does not know the correct host name to IP address mapping.
Check that the name server defined to TCP/IP via the SET DNS1 command is valid and responding correctly. If the name server is defined correctly to TCP/IP then contact the administrator to determine why the IP address lookup has failed.
Console
DFHSOIS
Console
XMEOUT Parameters: applid, ip_address
The TCP/IP listener task has received a connection from a client but the attach for the transaction associated with the TCPIPSERVICE definition has failed. The associated transaction may not have been installed or the TCPIPSERVICE definition could have specified the wrong transaction.
The TCPIPSERVICE that is defined on the port that the connection arrived on is closed. The socket accepted for the client is closed.
Determine why the attach for the transaction has failed. Correct the error and re-open the TCPIPSERVICE.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, transaction, tcpipservice
The group name has been registered with Work Load Manager for Domain Name Service (DNS) connection optimization. This occurs when a TCPIPSERVICE is opened where its name begins with the character 'D'. The new generic TCP/IP host name becomes available for clients to use to access the CICS system, and any others that have registered with the named group name.
CICS has issued the Work Load Manager macro IWMSRSRG to register the specified group name for DNS connection optimization. This only occurs when the name of the TCPIPSERVICE begins with a 'D'. Work Load manager registration only occurs once for a given group name. If multiple TCPIPSERVICES define the same group name, then registration will only occur once.
The group name registered is taken from a combination of part of the name of the TCPIPSERVICE and the transaction defined for the TCPIPSERVICE. Any characters of the name following a dot '.' are concatenated onto the transaction identifier to form the group name. For example, a TCPIPSERVICE has the name D1.CICS and is defined with the transaction IIOP (The IIOP transaction being an alias of the CICS supplied CIOR transaction). The group name generated is 'CICSIIOP'. If the TCPIPSERVICE name does not contain a dot, then only the transaction identifier is used. For example, a TCPIPSERVICE with a name of 'DYNWEB' and a transaction of WWW will generate a registration for the group 'WWW'.
The group name registered effectively becomes a new name in the sysplex TCP/IP domain. When multiple CICS systems in a sysplex each register with the same group name, the DNS server uses Work Load Manager to resolve the group name into one of the IP addresses of the associated systems. The IP address returned is that of the system that is most eligible according to Work Load Manager's load balancing rules. For example, two OS/390® systems in a sysplex are mvs1.plex.hursley.ibm.com and mvs2.plex.hursley.ibm.com; and on each system, CICS registers with the group name cicsiiop. The new name cicsiiop.plex.hursley.ibm.com is dynamically added to the DNS name servers tables. Client TCP/IP applications can use this name instead of the name of one of the specific OS/390 images. When a client resolves the name to an IP address using the DNS, it will get the IP address of the most eligible system. Since the DNS dynamically knows when systems register and de-register, additional CICS systems can be registered as required to expand the list of available IP addresses returned for a group name. If a system fails, its IP address will be removed from the DNS server's list of associated addresses for any groups with which it was registered.
No user action is necessary.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, groupname, genericname
The group name has been de-registered from Work Load Manager. This CICS system will no longer participate in connection optimization in the group specified. This occurs when a TCPIPSERVICE is closed where its name begins with a 'D'.
The Work Load Manager IWMSRDRS call is made to de-register the group name. This will remove the IP address of the system from the DNS servers table associated with the group name.
If more than one open TCPIPSERVICE share the same group name, then the WLM de-registration only occurs when the last one is closed.
Check the availability of the name server.
CSOO
DFHSOCK
XMEOUT Parameters: date, time,applid, groupname
Language Environment has returned a non-zero return code/reason code to a gethostname call during Listener initialization.
Listener initialization terminates. The CICS region does not open its TCP/IP interface.
Determine the reason for the gethostname failure. The return code and reason code included in the message text are described in TCP/IP for VSE Messages.
Console
DFHSOCK
XMEOUT Parameters: applid, X'retcode',X'rc'
During activation of a TCPIPSERVICE, the Sockets Domain was unable to locate a TCP/IP name server. Without a name server, CICS cannot obtain the information necessary for registration with WLM DDNS.
TCPIPSERVICE activation continues, but this service is not registered with WLM DDNS.
Determine why no name server was found. Message DFHSO0113 may have preceded this message. Once the name server has been activated, re-install the TCPIPSERVICE.
Console
DFHSOCK
XMEOUT Parameters: applid, servicename,hostname
The specified number (numtcbs) of TCBs have been attached and initialized to perform Secure Sockets Layer processing for CICS.
CICS can handle numtcbs simultaneous SSL sessions.
None.
Console Routecodes 2 and 10
DFHSOSE
XMEOUT Parameters: applid, numtcbs
CICS requires at least one TCB to be successfully initialized to handle the TCP/IP Secure Sockets Layer, but it has been unable to initialize any.
CICS cannot handle any SSL sessions, so attempts to open TCPIPSERVICEs which specify SSL(YES) or SSL(CLIENTAUTH) will fail.
The partition size of the CICS address-space is probably too small to allow CICS Secure Sockets Layer to be initialized. Restart CICS with a larger partition size.
Console Routecodes 2 and 10
DFHSOSE
XMEOUT Parameter: applid
A Secure Sockets Layer connection from a client with address ipaddr was received on TCPIPSERVICE(service), but there were no available TCBs to process the request.
The socket for the connection is closed. No message is sent to the client because the client expects the response to be encrypted by SSL, but SSL services cannot be provided.
If this message occurs frequently, consider starting another CICS for this application.
CSOO
DFHSOSE
XMEOUT Parameters: date, time,applid, ipaddr, service
An attempt to create a tcpip socket has failed as the number of open sockets in the system would exceed the current MAXSOCKETS value.
The socket is not opened and failure is reported.
If this behaviour is undesireable, change the MAXSOCKETS value in your SIT.
Console
DFHSOCK
XMEOUT Parameters: applid
A TCP/IP ACCEPT call has returned an error.
An exception trace entry is made in the trace table. No system dump is taken, unless you have specifically requested a dump in the dump table that CICS should terminate. The TCPIPSERVICE tcpipservice on port portnumber at the specified IP address is shutdown. When this shutdown complete message DFHSO0108 is issued. The return value, return code and reason code reported by TCP/IP are displayed to aid with diagnostics.
Determine the reason for the ACCEPT failure. The return code and reason code included in the message text are described in z/OS UNIX System Services Messages and Codes under the asyncio (BPX1AIO) callable service description. Check the system console for any messages issued by TCP/IP and take the recovery action indicated. The TCPIPSERVICE tcpipservice is closed, and after the TCP/IP problem has been resolved, the closed TCPIPSERVICE should be reopened.
Console
DFHSOCK
XMEOUT Parameters: date, time, applid, ipaddress, tcpipservice, portnumber
CICS has been started with a SIT which specifies ENCRYPTION=WEAK or ENCRYPTION=NORMAL. Neither of these levels are supported.
CICS will assume ENCRYPTION=STRONG has been specified.
Change the ENCRYPTION parameter in your SIT to ENCRYPTION=STRONG and regenerate.
Console
DFHSOSE
XMEOUT Parameters: applid, level