5. Communications Error Codes

If a communications error occurs between the client and the host while using these communication extensions, the error returned from the TCP/IP software is mapped to a standard APPC error code.

The most commonly experience APPC error codes are 20, 6 and 17. This APPC code is often enough to let you know what caused the issue. Refer to the following for simple resolutions:

APPC Error Code

Likely cause

20

Indicates that the application could not connect to the listener. Check that the listener is running, and that there are no firewall issues for the listener port on the server.

6

Indicates a login validation error. If you are sure the correct username and password has been used, use LANSA comms tracing on the server to determine the cause of the error.

17

Indicates an unexpected error on the server, after login validation. Check the joblog/x_err.log on the server for problem.

 

 

If this is not enough information, and the problem is reproducible, you should turn on the Errors tracing option to determine what the original error was. For further details refer to Set Logging and Tracing Options. With the Errors tracing option turned on, you will get an entry in the trace file similar to this:

02/06/97 16:12:39 testw32(0xa2:0x9f):LCOSlapi:Error:COMM_Allocate

       Native Error:10061 CPIC Error:20 in connect

"Native Error" shows the original error returned by the communications software. In this example; error code10061 (WSAECONNREFUSED) occurred on a "connect" request because the host was not running the Listener, required to listen on sockets port 4545.

Following is a list of possible error codes returned by the WSAGetLastError() (Winsock) call, along with their explanations. These error numbers are consistent across all Windows Sockets-compliant implementations.

 

Error Code

Windows Sockets Code

Berkeley equivalent

Interpretation

10004

WSAEINTR

EINTR

As in standard C

10009

WSAEBADF

EBADF

As in standard C

10013

WSEACCES

EACCES

As in standard C

10014

WSAEFAULT

EFAULT

As in standard C

10022

WSAEINVAL

EINVAL

As in standard C

10024

WSAEMFILE

EMFILE

As in standard C

10035

WSAEWOULDBLOCK

EWOULDBLOCK

As in BSD

10036

WSAEINPROGRESS

EINPROGRESS

 

10037

WSAEALREADY

EALREADY

As in BSD

10038

WSAENOTSOCK

ENOTSOCK

As in BSD

10039

WSAEDESTADDRREQ

EDESTADDRREQ

As in BSD

10040

WSAEMSGSIZE

EMSGSIZE

As in BSD

10041

WSAEPROTOTYPE

EPROTOTYPE

As in BSD

10042

WSAENOPROTOOPT

ENOPROTOOPT

As in BSD

10043

WSAEPROTONOSUPPORT

EPROTONOSUPPORT

As in BSD

10044

WSAESOCKTNOSUPPORT

ESOCKTNOSUPPORT

As in BSD

10045

WSAEOPNOTSUPP

EOPNOTSUPP

As in BSD

10046

WSAEPFNOSUPPORT

EPFNOSUPPORT

As in BSD

10047

WSAEAFNOSUPPORT

EAFNOSUPPORT

As in BSD

10048

WSAEADDRINUSE

EADDRINUSE

As in BSD

10049

WSAEADDRNOTAVAIL

EADDRNOTAVAIL

As in BSD

10050

WSAENETDOWN

ENETDOWN

As in BSD

10051

WSAENETUNREACH

ENETUNREACH

As in BSD

10052

WSAENETRESET

ENETRESET

As in BSD

10053

WSAECONNABORTED

ECONNABORTED

As in BSD

10054

WSAECONNRESET

ECONNRESET

As in BSD

10055

WSAENOBUFS

ENOBUFS

As in BSD

10056

WSAEISCONN

EISCONN

As in BSD

10057

WSAENOTCONN

ENOTCONN

As in BSD

10058

WSAESHUTDOWN

ESHUTDOWN

As in BSD

10059

WSAETOOMANYREFS

ETOOMANYREFS

As in BSD

10060

WSAETIMEDOUT

ETIMEDOUT

As in BSD

10061

WSAECONNREFUSED

ECONNREFUSED

As in BSD

10062

WSAELOOP

ELOOP

As in BSD

10063

WSAENAMETOOLONG

ENAMETOOLONG

As in BSD

10064

WSAEHOSTDOWN

EHOSTDOWN

As in BSD

10065

WSAEHOSTUNREACH

EHOSTUNREACH

As in BSD

10091

WSASYSNOTREADY

 

Network subsystem is unusable.

10092

WSAVERNOTSUPPORTED

 

Windows Sockets DLL cannot support this app.

10093

WSANOTINITIALISED

 

 

11001

WSAHOST_NOT_FOUND

HOST_NOT_FOUND

As in BSD

11002

WSATRY_AGAIN

TRY_AGAIN

As in BSD

11003

WSANO_RECOVERY

NO_RECOVERY

As in BSD

11004

WSANO_DATA

NO_DATA

As in BSD