TCP/IP Error Codes › Return, Errno, and Reason Codes

Return, Errno, and Reason Codes

The return code value returned by a call to the socket program interface can be a binary 0 (call successfully executed) or non-zero (an error occurred). In the latter case, the errno field explains why the function call failed. The situations that occur are described as follows:

• CA IDMS generates the error. Errno is set to a value in the range 12000-12999 as documented in the following table. The reason code is not used and is 0.
• The error is generated by operating system services. Errno and (where applicable) reason-code are documented in the appropriate operating system services documentation.
  • z/OS

    § UNIX System Services - Messages and Codes

    § z/OS Communications Server - IP and SNA codes

  • z/VM—See the z/VM TCP/IP Programmer's Reference
  • z/VSE

    § Connectivity Systems TCP/IP for z/VSE: Programmer's Guide

    § Barnard Systems TCP/IP Tools

    § TCP/IP for z/VSE - IBM Program Setup and Supplementary Information

• z/VM systems: For some errno codes returned by CA IDMS, the variable assigned to the RSNCODE parameter may contain the IPRCODE extracted from the corresponding IUCV parameter list. For the complete list of values, see the IPARML DSECT.
• z/VSE and z/VM systems: The value of some errno codes can differ from the equivalent standard POSIX value that is returned on z/OS. For example, the standard value for ETIMEDOUT errno code (connection timed out) is 1127, but is 60 on z/VM. The standard errno code is returned to the variable assigned to the ERRNO parameter. Applications must check the variable for common errno codes that are handled programatically. The errno code value returned by the operating system is saved in a variable assigned to the RSNCODE parameter.