hh:mm:ss.th socket_error, socket__call ERRNO=errno
Explanation
An error occurred during a socket call. The Listener
processing at the time of the error and the socket call are given
by socket_error and socket_call.
errno is
the UNIX System Services return
code. These return codes are listed and described in the return codes (errnos) information in z/OS UNIX System Services Messages and Codes.
A description of each of the errors
is given below:
- Unable to accept new connection, ACCEPT
- An error occurred when the Listener attempted to complete a connection
in response to a connection request from a client.
Procedure
name: ListenProcess
- Unsuccessful binding to communication port, BIND
- The Listener was unable to bind the port that it is to use for
accepting connection requests from clients. The port is specified
by the PORT parameter of the LISTENER statement.
Procedure
name: main
- Socket CLOSE error:
- An error occurred when the Listener attempted to close a connection.
Procedure
name: ListenProcess, ReleaseProcess
- Error transferring connection to server, GIVESOCKET
- An error occurred when the Listener attempted to pass control
of the client connection to the server.
Procedure name: CreServPro
- Failed to connect to TCPIP address space, INITAPI
- An error occurred while attempting to connect to the TCPIP address
space. The TCPIP address space that is used is specified by the ADDRSPC
parameter on the TCPIP statement.
Procedure name: main
- Failed setting socket to listen mode, LISTEN
- The LISTEN call, used to enable the socket connected to the listening
port for incoming connections, resulted in an error.
Procedure
name: main
- Socket READ error:
- An error occurred when the Listener attempted to receive data
sent from a client program. Further information about the client is
provided by message EZY1032I, which is issued after this message.
Procedure
name: ReadInputProcess, ReadTRMProcess
- Error waiting for communications event, SELECT
- The SELECT call, used to wait for connection requests and data
for implicit transactions, has resulted in an error.
Procedure
name: main
- Failed to obtain a socket to listen on, SOCKET
- The Listener failed to acquire a socket for binding to the listening
port.
Procedure name: main
- Server failed to take connection, TAKESOCKET
- The Listener issued a GIVESOCKET and the server failed to issue
a corresponding TAKESOCKET.
Note: ERRNO is not applicable to this
error.
- Socket WRITE error:
- An error occurred when the Listener attempted to send data to
a client program.
Procedure name: WriteRSMProcess
System action
The system action depends on the error. If the
error occurs during startup processing or during a SELECT call, the
Listener ends. Otherwise, the connection that received the error
is closed.
Operator response
For errors encountered during startup processing,
check that the configuration file TCPIP and LISTENER parameters are
correct. Otherwise, proceed based on the value of errno.
System programmer response
Assist the user as required.
Module
Procedure name
See
the explanation above.