Description:
While trying to create a DC COBOL 'client' program using the example in the IDMS Callable Services 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?
Solution:
Go to the IBM Infocenter web page and choose the appropriate z/OS release
http://www-03.ibm.com/systems/z/os/zos/bkserv/
If using z/OS 1.11 release; here's the link for the "Reason Codes":
http://publib.boulder.ibm.com/infocenter/zos/v1r11/index.jsp?topic=/com.ibm.zos.r11.bpxa800/errnojrs.htm
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.
References:
CA IDMS Callable Services - A.0 Appendix A. TCP/IP Error Codes
CA IDMS Release Summary - 6.3.1 System Generation TCP/IP Statement
CA IDMS System Tasks and Operator Commands - 4.59 DCMT DISPLAY TCPIP