DFHSO1000 date time applid A request for TCP/IP communication failed (code X'code') for IPCONN ipconn using applid applid. z/OS UNIX system services supplied bpx_return_value( bps_return_value) bpx_return_code( X'bpx_return_code' ), and bpx_reason_code( X'bpx_reason_code' ).
Explanation
A request to z/OS UNIX system services for TCP/IP communications failed. The request was made for IPIC communication with another CICS region using IPCONN ipconn and applid applid. The code X'code' is an SO domain exception trace point ID that identifies what the error is and where the error was detected, for example:
-
0E02 BPX1AIO asyncio failure
-
0E03 BPX1AIO asyncio request failure
-
0E09 BPX1GIV give socket failure
-
0E0C BPX1TAK take socket failure
-
0E0F BPX1GCL get client id failure
-
0E13 BPX1SOC socket faliure
-
0E16 BPX1BND bind failure
-
0E19 BPX1LSN listen failure
-
0E1C BPX1GNM get socket name failure
-
0E1F BPX1IOC ioctl failure
-
0E20 BPX1AIO asyncio return failure
-
0E23 BPX1OPT socketopt failure
System action
An exception trace entry (code X'code' in the message) is made in the trace table.
This message indicates an error in the execution of CICS to communicate using IPIC communication. CICS continues but IPIC communication using IPCONN ipconn might have failed temporarily or permanently.
Additional error messages are produced to report the effect this failing request has on IPIC communication.
User response
The exception trace entry will tell you which z/OS UNIX system service was called. Refer to the z/OS UNIX System Services Messages and Codes manual to determine the cause of the error. If the value of the z/OS UNIX system services reason code bpx_reason_code is not zero, you might be able to use the z/OS UNIX System Services command BPXMTEXT to provide more information.
The impact of this failure depends on the IPIC processing that is being executed at the time. Refer to other messages for IPIC communication using the specified IPCONN to obtain more information.
If IPIC communication using IPCONN ipconn does not subsequently resume normal operation successfully, verify the IPCONN and its related TCPIPSERVICE resource definition have attributes that are correct for your installation. Also, verify these resource definitions are correct in the CICS region that issued this message and the CICS region with which IPIC communication is being attempted. It might also be necessary to verify parameter definitions for z/OS Communications Server are correct for operation of this IPCONN. When doing so consider the z/OS system on which the CICS region that issued this message runs and the z/OS system with which IPIC communication is being attempted.
Module
XMEOUT parameters/Message inserts
- date
- time
- applid
- X'code'
- ipconn
- applid
- bps_return_value
- X'bpx_return_code'
- X'bpx_reason_code'
Destination
CSOO