IDMS TCPIP SOCKET-FUNCTION-GETHOSTBYADDR function fails with RSNCD 78891004
search cancel

IDMS TCPIP SOCKET-FUNCTION-GETHOSTBYADDR function fails with RSNCD 78891004

book

Article ID: 50232

calendar_today

Updated On:

Products

IDMS IDMS - Database IDMS - ADS

Issue/Introduction

While trying to create a DC COBOL 'client' program using the example in the IDMS Callable Services Reference manual COBCLI;

TCPIP SOCKET-FUNCTION-GETHOSTBYADDR function fails with Reason Code (RSNCD) 78891004.

What is this error and where can I find Unix System Services TCPIP return/reason error codes?

 

Environment

Release: 19.0

Resolution

The Unix System Services TCPIP return/reason error codes are documented in the IBM documentation  z/OS UNIX System Services Messages and Codes 

Section Reason codes (errnojrs) contains the Reason codes that are less than x'1000' whereas Reason codes greater than x'1000' can be located in the IBM documentation z/OS Communications Server: IP and SNA Codes in the chapter Resolver reason codes.

The ERRNOS can be found in the in section Return codes (errnos).

The RSNCD 78891004 received by the GETHOSTBYADDR function consists of two halfwords:
The first halfword (7889) represent the UNIX component ID; the second halfword (1004) contains the reason code in hex (X'1004' or decimal 4100).

The X'1004' or decimal 4100 indicates "Resolver service did not find the specified host name".

When troubleshooting, check the IDMS Jes Log or the Common Services TCPIP log for additional messages.

 

Additional Information

IDMS documentation:

Callable Services Reference

TCP/IP Error Codes

Return, Errno, and Reason Codes

ERRNO Numbers Set by the Socket Program Interface

TCP/IP Programming Examples

COBOL TCP/IP Client Program

System Generation TCP/IP Statement

TCP/IP API Support

Supporting DNS Functions Using the SYSTCPD File

DCMT DISPLAY TCP/IP Command

DCMT VARY TCPIP